{ "openapi": "3.0.1", "info": { "title": "Hiring-Signal & Job-Postings Intel - ATS, Surge, Tech Stack", "description": "Live job-postings intel from public ATS endpoints (Greenhouse, Lever, Ashby, Workday & more). Normalized postings plus a hiring-signal engine: net-new roles, role-count deltas, dept expansion, surge flags, and JD tech-stack detection. For B2B sales, recruiting, and alt-data. Public data only.", "version": "0.1", "x-build-id": "YD110OhoC7Om1wADM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/seibs.co~hiring-signal-intel/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-seibs.co-hiring-signal-intel", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/seibs.co~hiring-signal-intel/runs": { "post": { "operationId": "runs-sync-seibs.co-hiring-signal-intel", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/seibs.co~hiring-signal-intel/run-sync": { "post": { "operationId": "run-sync-seibs.co-hiring-signal-intel", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "company_jobs", "hiring_signals", "new_roles" ], "type": "string", "description": "company_jobs = every current open role for the given companies. hiring_signals = postings PLUS a per-company hiring-signal rollup (net-new roles, role-count delta, department expansion, surge flag) vs a trailing baseline. new_roles = only postings that are net-new since the last run (delta feed) plus the rollup.", "default": "hiring_signals" }, "companies": { "title": "Companies (ATS slug, auto-resolved)", "maxItems": 50, "type": "array", "description": "Bare company slugs to auto-resolve across ATS providers (tries Greenhouse, Lever, Ashby, SmartRecruiters, Recruitee, Workable in order). The slug is the company id in its careers URL, e.g. 'stripe' from boards.greenhouse.io/stripe or jobs.lever.co/stripe. Hard cap of 50.", "default": [], "items": { "type": "string" } }, "ats_boards": { "title": "Explicit ATS boards (skip auto-resolve)", "maxItems": 50, "type": "array", "description": "Explicit boards when you already know the ATS. Each item: {\"ats\": \"greenhouse|lever|ashby|smartrecruiters|recruitee|workable\", \"slug\": \"\"}. For Workday add {\"ats\": \"workday\", \"host\": \"company.wd1.myworkdayjobs.com\", \"tenant\": \"company\", \"site\": \"External\", \"slug\": \"company\"}. Hard cap of 50.", "default": [] }, "careers_urls": { "title": "Careers-page URLs (auto-sniff the ATS)", "maxItems": 50, "type": "array", "description": "Company careers/jobs page URLs. The actor fetches the page and detects an embedded Greenhouse/Lever/Ashby/SmartRecruiters/Recruitee/Workable board, then pulls its postings. Lowest-effort path when you only have a website. Hard cap of 50.", "default": [], "items": { "type": "string" } }, "keywords": { "title": "Keyword filter", "maxItems": 30, "type": "array", "description": "Keep only postings whose title, department, or description contains one of these terms (case-insensitive). E.g. ['salesforce admin', 'procore', 'revenue operations']. Leave empty for all roles. Hard cap of 30.", "default": [], "items": { "type": "string" } }, "departments": { "title": "Department filter", "type": "array", "description": "Keep only postings in these (normalized) departments: Engineering, Sales, Marketing, Product, Design, Customer Success, Finance, People, Operations, Legal. Leave empty for all.", "default": [], "items": { "type": "string" } }, "locations": { "title": "Location filter", "type": "array", "description": "Keep only postings whose location contains one of these substrings (e.g. ['New York', 'Remote', 'London']). Leave empty for all.", "default": [], "items": { "type": "string" } }, "remote_only": { "title": "Remote roles only", "type": "boolean", "description": "Keep only postings flagged as remote.", "default": false }, "include_tech_stack": { "title": "Detect tech stack in job descriptions", "type": "boolean", "description": "Parse each job description for named software (Salesforce, HubSpot, ServiceTitan, Procore, Snowflake, AWS, etc.) - the named-software buying signal. Adds a tech_stack_signal PPE charge per posting with >= 1 tool detected.", "default": true }, "include_full_description": { "title": "Include full job description text", "type": "boolean", "description": "Embed the full job-description text in each record (records grow larger). When off, a 600-char snippet is included. No extra charge either way.", "default": false }, "surge_abs_threshold": { "title": "Hiring-surge: net-new roles threshold", "minimum": 1, "maximum": 100, "type": "integer", "description": "A company is flagged as surging when it has at least this many net-new roles since the last run. Default 3.", "default": 3 }, "surge_pct_threshold": { "title": "Hiring-surge: growth-rate threshold", "minimum": 0.01, "maximum": 10, "type": "number", "description": "A company is also flagged when its open-role count grows by at least this fraction vs the baseline (0.20 = 20%). Default 0.20.", "default": 0.2 }, "max_results_per_company": { "title": "Max postings per company", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on postings returned per company/board. Default 200.", "default": 200 }, "contact_email": { "title": "Contact email (optional, for User-Agent)", "type": "string", "description": "Optional contact email added to the User-Agent so the ATS providers can reach you. Good-citizen practice; not required.", "default": "" }, "monitor_webhook_url": { "title": "Monitor webhook URL (Slack / email, optional)", "type": "string", "description": "When this actor runs under an Apify Schedule (monitor mode), post the change digest to this Slack-compatible webhook URL.", "default": "" }, "use_apify_proxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Route ATS requests through Apify Proxy. DATACENTER is sufficient - public ATS JSON endpoints are not anti-bot protected.", "default": true }, "apify_proxy_groups": { "title": "Proxy groups", "type": "array", "description": "Apify Proxy groups. DATACENTER is fine for public ATS endpoints.", "default": [ "DATACENTER" ], "items": { "type": "string" } }, "concurrency": { "title": "Max concurrent requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "Parallel board fetches. Default 6.", "default": 6 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }