Skip to content
HALOWERK

Signalwerk

job age flags

Uses datePosted/validThrough from JobPosting markup, first_published (Greenhouse), createdAt (Lever, Personio), published_at/close_at (Recruitee), publishedAt (Ashby) or caller dates. Age is counted in days against as_of (default today, UTC). Flags: long_open (age ≥ long_open_days, default 60), very_long_open (≥ 2 × threshold), expired (validThrough before as_of), expires_soon (within 7 days), no_date, date_in_future. Returns per posting age and flags, buckets 0–7, 8–30, 31–60, 61–90,.

POST https://signal.halowerk.com/v1/job-age-flags

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).
as_ofstringNoReference date (YYYY-MM-DD); default today UTC.
long_open_daysintegerNoAge in days from which a posting counts as long open.
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)."
    },
    "as_of": {
      "type": "string",
      "format": "date",
      "description": "Reference date (YYYY-MM-DD); default today UTC."
    },
    "long_open_days": {
      "type": "integer",
      "minimum": 7,
      "maximum": 730,
      "default": 60,
      "description": "Age in days from which a posting counts as long open."
    }
  }
}

Open original schema

Published input example

{
  "as_of": "2026-11-01",
  "postings": [
    {
      "title": "Schlosser (m/w/d)",
      "date_posted": "2026-06-15"
    },
    {
      "title": "Buchhalter (m/w/d)",
      "date_posted": "2026-10-20"
    }
  ]
}

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 →