{ "openapi": "3.0.1", "info": { "title": "Company Hiring Signals API - New Jobs, Closed Jobs, History", "description": "Company hiring signals from our own daily archive of public job boards (Greenhouse, Lever and Ashby) for 813 tech and startup companies. Per company and day: open jobs, new postings, closed postings (missing two days in a row) with days open, departments and remote share. Ask which companies are hir", "version": "0.1", "x-build-id": "BiC2rizSQNTiaegtn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/martin10291~company-hiring-signals-history/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-martin10291-company-hiring-signals-history", "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/martin10291~company-hiring-signals-history/runs": { "post": { "operationId": "runs-sync-martin10291-company-hiring-signals-history", "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/martin10291~company-hiring-signals-history/run-sync": { "post": { "operationId": "run-sync-martin10291-company-hiring-signals-history", "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", "properties": { "mode": { "title": "Mode", "enum": [ "top_hiring", "companies", "new_jobs", "closed_jobs", "open_jobs" ], "type": "string", "description": "top_hiring = companies ranked by hiring activity; companies = current numbers plus daily history for chosen companies; new_jobs = postings first seen after the archive baseline; closed_jobs = postings that disappeared (with days open); open_jobs = currently open postings.", "default": "top_hiring" }, "sortBy": { "title": "Sort by", "enum": [ "newJobs", "openJobs", "openJobsDelta", "closedJobs" ], "type": "string", "description": "Ranking for top_hiring mode: new postings, open postings, change in open postings, or closed postings over the lookback window.", "default": "newJobs" }, "minOpenJobs": { "title": "Minimum open jobs", "minimum": 0, "type": "integer", "description": "Skip companies with fewer open jobs than this (top_hiring mode). Hides tiny boards.", "default": 5 }, "lookbackDays": { "title": "Lookback days", "minimum": 1, "maximum": 365, "type": "integer", "description": "Compare today with this many days ago (top_hiring mode). The archive starts on 2026-11-03, so the maximum useful value is the number of days since then.", "default": 30 }, "companies": { "title": "Companies", "type": "array", "description": "Company board slugs (for example stripe) or company names. Required in companies mode; optional filter in the job modes.", "default": [], "items": { "type": "string" } }, "keywords": { "title": "Title keywords", "type": "array", "description": "Job modes only: keep postings whose title contains any of these words (case-insensitive). Empty = all titles.", "default": [], "items": { "type": "string" } }, "location": { "title": "Locations", "type": "array", "description": "Job modes only: keep postings whose location contains any of these texts, for example Berlin or United States. Empty = all locations.", "default": [], "items": { "type": "string" } }, "department": { "title": "Departments", "type": "array", "description": "Job modes only: keep postings in these departments, for example Sales or Engineering. Empty = all departments.", "default": [], "items": { "type": "string" } }, "remoteOnly": { "title": "Remote only", "type": "boolean", "description": "Job modes only: keep only postings marked as remote.", "default": false }, "ats": { "title": "Job board systems", "type": "array", "description": "Limit to companies using these systems. Empty = all three.", "items": { "type": "string", "enum": [ "greenhouse", "lever", "ashby" ] }, "default": [] }, "since": { "title": "Since date", "type": "string", "description": "Job modes only: postings first seen (or closed) since this date, format YYYY-MM-DD. Empty = since the start of the archive.", "default": "" }, "limit": { "title": "Max results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of rows to return (1 to 1000). You pay per result.", "default": 50 }, "onlyNew": { "title": "Only new or changed since last run", "type": "boolean", "description": "For alerts: in the job modes output only postings not reported before; in top_hiring and companies modes output only rows whose open, new or closed job counts changed since the last run with the same Monitor ID. The first run reports everything. Each result is paid for once.", "default": false }, "monitorId": { "title": "Monitor ID", "type": "string", "description": "Separate memory for each watch list (used with only-new mode). Use a different ID per list of companies or keywords.", "default": "default" } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }