Skip to content
HALOWERK

Signalwerk

hiring diff

Matches postings of the two snapshots by id, then by normalised URL (host and path), then by normalised title (gender suffixes such as (m/w/d) removed) and location, finally by title similarity ≥ 0.9 (Levenshtein) at the same location. Postings matched by id or URL whose title or location changed are reported as changed. Returns added, removed, unchanged and changed lists, counts, net change and turnover rate. Pure computation on the supplied lists; nothing is fetched or stored, so no.

POST https://signal.halowerk.com/v1/hiring-diff

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
beforearrayYesEarlier snapshot.
afterarrayYesLater snapshot.
before_datestringNo
after_datestringNo
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "before",
    "after"
  ],
  "properties": {
    "before": {
      "type": "array",
      "maxItems": 2000,
      "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": "Earlier snapshot."
    },
    "after": {
      "type": "array",
      "maxItems": 2000,
      "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": "Later snapshot."
    },
    "before_date": {
      "type": "string",
      "format": "date"
    },
    "after_date": {
      "type": "string",
      "format": "date"
    }
  }
}

Open original schema

Published input example

{
  "before": [
    {
      "id": "1",
      "title": "Schlosser (m/w/d)"
    },
    {
      "id": "2",
      "title": "Fahrer (m/w/d)"
    }
  ],
  "after": [
    {
      "id": "1",
      "title": "Schlosser (m/w/d)"
    },
    {
      "id": "3",
      "title": "Disponent (m/w/d)"
    }
  ]
}

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 →