Skip to content
HALOWERK

Signalwerk

newsletter signup detect

Reads the start page and a linked newsletter page (robots.txt respected, at most 5 fetches) or supplied HTML. A form counts as newsletter sign-up when it has an email field, no password field and either newsletter wording in or around the form or a provider form action/class. Providers are matched by documented host lists (form action, script, iframe, link) and form class names (e.g. mc4wp, sib-form, cr_form, klaviyo-form). Double opt-in is reported only when the page says so (e.g..

POST https://signal.halowerk.com/v1/newsletter-signup-detect

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
urlstringNoCompany domain or page URL (https:// added when missing). Public pages only; robots.txt is respected; at most 5 fetches per domain.
htmlstringNoAlready loaded HTML of the page. Nothing is fetched in this mode. The whole request is limited to 2 MB.
base_urlstringNoURL the HTML was loaded from (required with html).
extra_pagesarrayNoOffline mode only: further pages of the same site as { url, html }.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "url": {
      "type": "string",
      "minLength": 3,
      "maxLength": 2048,
      "description": "Company domain or page URL (https:// added when missing). Public pages only; robots.txt is respected; at most 5 fetches per domain."
    },
    "html": {
      "type": "string",
      "minLength": 20,
      "maxLength": 1900000,
      "description": "Already loaded HTML of the page. Nothing is fetched in this mode. The whole request is limited to 2 MB."
    },
    "base_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "URL the HTML was loaded from (required with html)."
    },
    "extra_pages": {
      "type": "array",
      "maxItems": 4,
      "description": "Offline mode only: further pages of the same site as { url, html }.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "url",
          "html"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "maxLength": 2048
          },
          "html": {
            "type": "string",
            "minLength": 20,
            "maxLength": 1900000
          }
        }
      }
    }
  }
}

Open original schema

Published input example

{
  "html": "<form action=\"https://x.list-manage.com/subscribe/post\"><h3>Newsletter</h3><input type=\"email\" name=\"EMAIL\"></form>",
  "base_url": "https://halowerk.com/"
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’