Skip to content
HALOWERK

Signalwerk

job postings extract

Sources in this order: schema.org JobPosting in JSON-LD (also nested in ItemList/@graph) or Microdata on the given page; the documented public board API when the page or URL points to a Greenhouse, Lever, Personio, Recruitee or Ashby board (or when ats {vendor, board} is given directly); otherwise titles and URLs of links that look like single job pages. With a homepage URL the careers page is located first. robots.txt is respected and at most 5 page fetches are made. Descriptions, contacts.

POST https://signal.halowerk.com/v1/job-postings-extract

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
urlstringNoCompany domain or page URL (https:// is added when missing). Public pages only; robots.txt is respected; at most 5 page fetches per call.
htmlstringNoAlready loaded HTML of the page. Nothing is fetched in this mode.
base_urlstringNoURL the HTML was loaded from (required with html).
atsobjectNoRead a board through its documented public API.
max_postingsintegerNoUpper limit of returned postings.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "url": {
      "type": "string",
      "minLength": 3,
      "maxLength": 2048,
      "description": "Company domain or page URL (https:// is added when missing). Public pages only; robots.txt is respected; at most 5 page fetches per call."
    },
    "html": {
      "type": "string",
      "minLength": 20,
      "maxLength": 3000000,
      "description": "Already loaded HTML of the page. Nothing is fetched in this mode."
    },
    "base_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "URL the HTML was loaded from (required with html)."
    },
    "ats": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "vendor",
        "board"
      ],
      "description": "Read a board through its documented public API.",
      "properties": {
        "vendor": {
          "type": "string",
          "enum": [
            "greenhouse",
            "lever",
            "lever_eu",
            "personio",
            "recruitee",
            "ashby"
          ],
          "description": "greenhouse, lever, lever_eu, personio, recruitee or ashby."
        },
        "board": {
          "type": "string",
          "minLength": 1,
          "maxLength": 100,
          "pattern": "^[A-Za-z0-9][A-Za-z0-9._ %-]{0,99}$",
          "description": "Board token, site name, account or subdomain as used in the board URL."
        }
      }
    },
    "max_postings": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000,
      "default": 200,
      "description": "Upper limit of returned postings."
    }
  }
}

Open original schema

Published input example

{
  "ats": {
    "vendor": "greenhouse",
    "board": "gitlab"
  },
  "max_postings": 50
}

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 โ†’