{ "openapi": "3.0.1", "info": { "title": "Hiring Signals — Sales Leads from Live Job Postings", "description": "Turn job postings into B2B sales leads. Name the roles your buyers hire for and get every company that opened one in the last N days: new roles, sample titles, seniority mix, remote share, a strong/moderate/weak signal score and an outreach angle. 2,200+ live company boards built in.", "version": "1.0", "x-build-id": "Mg6UGQFLEc8ZBMmeD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ntriqpro~hiring-signals-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ntriqpro-hiring-signals-leads", "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/ntriqpro~hiring-signals-leads/runs": { "post": { "operationId": "runs-sync-ntriqpro-hiring-signals-leads", "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/ntriqpro~hiring-signals-leads/run-sync": { "post": { "operationId": "run-sync-ntriqpro-hiring-signals-leads", "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": [ "disclaimerAck" ], "properties": { "jobKeywords": { "title": "Job titles your buyers hire for", "type": "array", "description": "The roles that mean somebody just approved a budget you can sell into. A company that opened three data-engineering reqs this month is buying data tooling this quarter. Multi-word keywords match as a whole — \"account executive\" will not match \"Executive Assistant\". Up to 20 keywords per run; each one is charged one summary row. Free plan: each run returns up to 25 results. Paid Apify plans receive the full result set.", "items": { "type": "string" } }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "How fresh a posting has to be to count as a signal. 14 days is the default: long enough to catch a hiring wave, short enough that the budget conversation is still open. Roles whose board publishes no posting date are counted as matching roles but never as new ones — an unprovable signal is worse than none." }, "minNewRoles": { "title": "Minimum new roles per company", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many matching roles a company must have opened inside the window before it counts as a lead. 1 gives you the widest list; raise it to 2 or 3 to keep only companies building out a whole function." }, "companies": { "title": "Companies (optional — your own account list)", "type": "array", "description": "Leave empty to scan the built-in directory of 2,200+ verified company job boards. Fill it in to watch your own target accounts instead: company slugs or careers-page URLs, e.g. https://job-boards.greenhouse.io/dropbox, https://jobs.lever.co/binance, https://jobs.ashbyhq.com/linear, https://apply.workable.com/blueground. Greenhouse, Lever, Ashby and Workable are detected automatically.", "items": { "type": "string" } }, "maxCompanies": { "title": "Max companies to read", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many company boards this run reads from the built-in directory, busiest boards first. Higher means more leads and a longer run — every company costs exactly one request no matter how many keywords you searched for." }, "locations": { "title": "Locations", "type": "array", "description": "Keep only roles whose location mentions one of these, e.g. London, New York, Germany. Leave empty for every location.", "items": { "type": "string" } }, "remoteOnly": { "title": "Remote roles only", "type": "boolean", "description": "Count only roles the board marks as remote. Useful when your product sells to distributed teams.", "default": false }, "disclaimerAck": { "title": "I understand how this Actor sources data", "type": "boolean", "description": "This Actor reads only the public, unauthenticated job-board endpoints that each applicant tracking system serves to a company's own careers page. It is unofficial and not affiliated with Greenhouse, Lever, Ashby, Workable or any employer. You are responsible for complying with each ATS's and each employer's terms of service, and you are the data controller for everything you collect.", "default": true } } }, "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 } } } } } } } } } }