{ "openapi": "3.0.1", "info": { "title": "Hiring Signal Monitor — new & removed jobs per company", "description": "Watch any company's career page (Greenhouse, Lever, Ashby, Workable, SmartRecruiters, Recruitee) and get open roles classified by function and seniority, plus what changed since the last run. Built for sales prospecting, recruiting intel and AI agents.", "version": "0.1", "x-build-id": "TbWMWMeYIfZK83YJa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/handa-labs~hiring-signal-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-handa-labs-hiring-signal-monitor", "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/handa-labs~hiring-signal-monitor/runs": { "post": { "operationId": "runs-sync-handa-labs-hiring-signal-monitor", "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/handa-labs~hiring-signal-monitor/run-sync": { "post": { "operationId": "run-sync-handa-labs-hiring-signal-monitor", "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": [ "companies" ], "properties": { "companies": { "title": "Companies to watch", "type": "array", "description": "One entry per company. Accepts a company homepage (https://gitlab.com), a career/ATS page URL (https://boards.greenhouse.io/gitlab, https://jobs.ashbyhq.com/openai, https://jobs.lever.co/leverdemo, https://apply.workable.com/acme, https://careers.smartrecruiters.com/Acme, https://acme.recruitee.com), or an explicit reference like `greenhouse:gitlab`. Homepages are resolved by scanning the site's career pages for a supported ATS.", "items": { "type": "string" } }, "sinceLastRun": { "title": "(legacy) sinceLastRun", "type": "boolean", "description": "Legacy switch. Prefer \"mode\". false = snapshot mode.", "default": true }, "emitUnchangedJobs": { "title": "Also emit unchanged open roles", "type": "boolean", "description": "Emit every currently open role on every run (change = `open`), not only new/removed ones. Useful when you want the full snapshot each time.", "default": false }, "includeDescriptions": { "title": "Include job descriptions (plain text)", "type": "boolean", "description": "Adds a `description` field (plain text, max 4000 chars) to job records. Increases payload size.", "default": false }, "mode": { "title": "Mode", "enum": [ "monitor", "snapshot" ], "type": "string", "description": "\"monitor\" (default): remember what was returned and emit only changes on later runs. \"snapshot\": return everything matching, every run, no memory.", "default": "monitor" }, "watchlistId": { "title": "Watchlist ID", "type": "string", "description": "Label for this watchlist (e.g. \"roofing-wa\"). Runs with the same ID share memory; use different IDs for independent watchlists.", "default": "default" }, "emitBaseline": { "title": "Return the full set on the first run", "type": "boolean", "description": "The first monitor run establishes a free baseline and returns only counts. Turn this on to also receive (and pay for) every current item on that first run.", "default": false }, "maxJobsPerCompany": { "title": "Max jobs per company", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Safety cap per company.", "default": 2000 }, "stateStoreName": { "title": "State store name", "type": "string", "description": "Name of the key-value store used to remember the previous snapshot per company. Use different names to keep independent watchlists.", "default": "hiring-signal-state" }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many companies are checked in parallel (1-10).", "default": 3 } } }, "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 } } } } } } } } } }