{ "openapi": "3.0.1", "info": { "title": "Hiring Signal Lead Finder", "description": "Find companies actively hiring SDRs, AEs and engineers. Combine Greenhouse, Lever, career pages and public LinkedIn job signals into scored company leads with evidence and snapshot-based growth.", "version": "1.0", "x-build-id": "E9ygVX8PbeUXf4wq0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/herazur~hiring-signal-lead-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-herazur-hiring-signal-lead-finder", "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/herazur~hiring-signal-lead-finder/runs": { "post": { "operationId": "runs-sync-herazur-hiring-signal-lead-finder", "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/herazur~hiring-signal-lead-finder/run-sync": { "post": { "operationId": "run-sync-herazur-hiring-signal-lead-finder", "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": { "query": { "title": "Hiring query", "type": "string", "description": "Convenience parser for role keywords (SDR, AE, engineer), N+ and US. For other locations or more precise filters, use fields below. This is not an unrestricted AI query engine.", "default": "Companies hiring 3+ SDRs in the US" }, "companies": { "title": "Company targets (optional)", "type": "array", "description": "Optional array of {name, domain, greenhouse, lever, leverRegion, careerUrl}. Supply at least one board slug or career URL per company. Omit to scan the documented starter companies. Example: [{\"name\":\"Cloudflare\",\"domain\":\"cloudflare.com\",\"greenhouse\":\"cloudflare\"}]." }, "role": { "title": "Role override", "enum": [ "SDR", "AE", "ENGINEERING", "RECRUITING", "CUSTOMER_SUCCESS", "ANY" ], "type": "string", "description": "Overrides the role inferred from the query. SDR also includes BDR." }, "location": { "title": "Location override", "type": "string", "description": "United States uses country/state/city matching; other values use text matching. Empty string means worldwide. Remote without a country is excluded from country-filtered results." }, "minJobs": { "title": "Minimum matching open jobs", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Overrides N+ in the query. Counts distinct observed title/location combinations, not headcount." }, "maxCompanies": { "title": "Maximum companies scanned", "minimum": 1, "maximum": 200, "type": "integer", "description": "Includes targets and companies discovered in public LinkedIn search.", "default": 30 }, "includeLinkedIn": { "title": "Include public LinkedIn job search", "type": "boolean", "description": "Best-effort guest search. May be blocked or sampled. No login or paid third-party Actor required. Sampled company coverage is ineligible for growth comparison.", "default": true }, "maxLinkedInPages": { "title": "Maximum LinkedIn pages", "minimum": 0, "maximum": 20, "type": "integer", "description": "Up to roughly 25 public job cards per page. Not exhaustive.", "default": 3 }, "maxCareerPages": { "title": "Maximum pages per career site", "minimum": 1, "maximum": 30, "type": "integer", "description": "Parses JobPosting JSON-LD and follows same-site job links. Detects linked Greenhouse/Lever boards. JavaScript-only sites may return no jobs.", "default": 8 }, "snapshotStoreName": { "title": "Persistent snapshot store (optional)", "type": "string", "description": "A private key-value store name in YOUR Apify account. Reuse the same name and filters on sequential runs to measure changes. Requires full Actor permissions for named storage. Do not run overlapping scans into the same store." }, "baseline": { "title": "Previous SNAPSHOT (optional)", "type": "object", "description": "Paste the complete SNAPSHOT JSON from a previous run. Alternative to named storage; works with limited permissions. Different scan settings invalidate comparison." }, "includeEvidence": { "title": "Include job evidence", "type": "boolean", "description": "Include job titles, locations and original listing URLs in each company lead.", "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 } } } } } } } } } }