Skip to content
HALOWERK

Signalwerk

hiring tech mentions

Reads postings from the caller, a careers page (JSON-LD/Microdata), or a documented public board API with full text (Greenhouse content, Lever, Personio, Recruitee, Ashby) and matches titles and descriptions against a curated dictionary of about 170 technologies in 14 categories (HALOWERK dictionary v1, 2026-11-01). Ambiguous words (Go, R, Rust, Swift, Spark, Snowflake, Jest ) are only counted in unambiguous spellings and flagged. Complements /stack, which detects the technology a website.

POST https://signal.halowerk.com/v1/hiring-tech-mentions

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
postingsarrayNoPostings supplied by the caller (for example the output of job-postings-extract).
atsobjectNoRead a board through its documented public API.
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).
topintegerNoNumber of technologies returned.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "postings": {
      "type": "array",
      "minItems": 1,
      "maxItems": 1000,
      "items": {
        "type": "object",
        "required": [
          "title"
        ],
        "additionalProperties": true,
        "description": "One job posting. The output postings of job-postings-extract can be passed unchanged.",
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 200
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "maxLength": 300
          },
          "url": {
            "type": "string",
            "maxLength": 2048
          },
          "description": {
            "type": "string",
            "maxLength": 60000,
            "description": "Posting text, plain or HTML. Used internally, never returned."
          },
          "location": {
            "type": "string",
            "maxLength": 300,
            "description": "Free-text location; several separated by \";\"."
          },
          "locations": {
            "type": "array",
            "maxItems": 30,
            "items": {
              "type": [
                "object",
                "string"
              ]
            }
          },
          "country": {
            "type": "string",
            "maxLength": 60
          },
          "remote": {
            "type": [
              "string",
              "null"
            ],
            "description": "remote, hybrid or onsite if known."
          },
          "employment_type": {
            "type": "string",
            "maxLength": 100
          },
          "employment_types": {
            "type": "array",
            "maxItems": 8,
            "items": {
              "type": "string",
              "maxLength": 40
            }
          },
          "date_posted": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 40
          },
          "valid_through": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 40
          },
          "salary": {
            "type": "string",
            "maxLength": 300
          },
          "department": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 200
          }
        }
      },
      "description": "Postings supplied by the caller (for example the output of job-postings-extract)."
    },
    "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."
        }
      }
    },
    "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)."
    },
    "top": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "default": 40,
      "description": "Number of technologies returned."
    }
  }
}

Open original schema

Published input example

{
  "postings": [
    {
      "title": "Backend Developer (m/w/d)",
      "description": "Python, Django, PostgreSQL, Docker and Kubernetes on AWS."
    },
    {
      "title": "SAP Consultant",
      "description": "SAP S/4HANA, ABAP"
    }
  ]
}

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