{ "openapi": "3.0.1", "info": { "title": "ATS Hiring Intent - Buying Signals (Greenhouse + 4 ATSes)", "description": "Aggregates jobs across Greenhouse, Lever, Ashby, SmartRecruiters, and Workday with auto ATS detection from a domain. Gemini classifier emits per-company buying signals (expanding-sales, evaluating-CRM, platform-build-out). Monitor mode tracks 100s of companies weekly via KV deltas.", "version": "1.0", "x-build-id": "dqimAiH4jmAkJdhnx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/constructive_calm~ats-hiring-intent-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-constructive_calm-ats-hiring-intent-scraper", "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/constructive_calm~ats-hiring-intent-scraper/runs": { "post": { "operationId": "runs-sync-constructive_calm-ats-hiring-intent-scraper", "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/constructive_calm~ats-hiring-intent-scraper/run-sync": { "post": { "operationId": "run-sync-constructive_calm-ats-hiring-intent-scraper", "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": "Scraping mode", "enum": [ "discover", "jobs", "signals", "monitor" ], "type": "string", "description": "What to do. 'discover' = given a list of company domains, detect which ATS each one uses and emit a discovery record (cheapest mode, used for prospect-list onboarding). 'jobs' = fetch normalized job postings only (no AI). 'signals' = jobs + Gemini-powered intent tags + per-company composite buying signals (premium). 'monitor' = same as 'signals' but auto-enables incremental mode and only emits changes vs. previous run (subscription use case).", "default": "jobs" }, "companyDomains": { "title": "Company domains", "type": "array", "description": "List of company domains to track (e.g. 'stripe.com', 'notion.so'). The actor auto-detects which ATS each company uses (Greenhouse / Lever / Ashby / SmartRecruiters / Workday) and pulls all open roles. Best mode for prospect-list / sales-intel use cases.", "default": [], "items": { "type": "string" } }, "atsTargets": { "title": "Direct ATS targets (advanced)", "type": "array", "description": "Skip auto-detection by passing direct ATS targets in the form 'platform:slug'. Examples: 'greenhouse:stripe', 'lever:netflix', 'ashby:linear', 'smartrecruiters:visa', 'workday:nvidia.wd5.myworkdayjobs.com/External'. For Workday, include the full domain + tenant + site path. Faster than companyDomains because no resolution step.", "default": [], "items": { "type": "string" } }, "keywordFilter": { "title": "Keyword filter (job title or description)", "type": "string", "description": "Free-text filter applied client-side after fetching. Matches against title + description. Example: 'platform engineer' or 'salesforce admin'. Leave blank for all roles.", "default": "" }, "functionFilter": { "title": "Function filter", "type": "array", "description": "Limit results to specific business functions. Multiple = OR-combined.", "items": { "type": "string", "enum": [ "engineering", "sales", "marketing", "operations", "product", "design", "data", "finance", "hr", "legal", "support", "other" ], "enumTitles": [ "Engineering", "Sales", "Marketing", "Operations", "Product", "Design", "Data / Analytics", "Finance", "HR / Recruiting", "Legal", "Customer Support", "Other" ] }, "default": [] }, "seniorityFilter": { "title": "Seniority filter", "type": "array", "description": "Limit results to specific seniority bands (normalized across ATSes). Multiple = OR-combined.", "items": { "type": "string", "enum": [ "intern", "junior", "mid", "senior", "lead", "principal", "director", "vp", "cxo" ], "enumTitles": [ "Intern", "Junior / IC1", "Mid / IC2", "Senior / IC3", "Lead / IC4", "Principal / IC5+", "Director", "VP", "C-suite" ] }, "default": [] }, "locationFilter": { "title": "Location filter", "type": "array", "description": "Free-text location substrings (e.g. 'United States', 'Remote', 'EMEA', 'San Francisco'). Multiple = OR-combined. Matches case-insensitive against the job's location string.", "default": [], "items": { "type": "string" } }, "remoteOnly": { "title": "Remote roles only", "type": "boolean", "description": "If true, drop any role whose normalized location/workplaceType doesn't indicate remote.", "default": false }, "postedWithinDays": { "title": "Posted within N days", "minimum": 0, "maximum": 365, "type": "integer", "description": "Drop roles older than this many days. 0 = no date filter. Defaults to 90 days.", "default": 90 }, "enableIntent": { "title": "Enable Gemini intent enrichment (signals mode)", "type": "boolean", "description": "Required for 'signals' and 'monitor' modes. When enabled, each job is run through Gemini 2.5 Flash to extract intent tags (e.g. 'expanding-sales', 'evaluating-CRM', 'series-B-build') and infer vendor/tech-stack signals (e.g. 'Salesforce', 'Snowflake', 'Kubernetes'). Adds $0.008 per enriched job. Auto-enabled in 'signals' and 'monitor' modes.", "default": false }, "emitCompanySignals": { "title": "Emit per-company composite signals", "type": "boolean", "description": "After all jobs for a company are pulled, emit one composite buying-signal record per company (e.g. 'platform-engineering-build-out' with confidence + vendor hypothesis). Adds $0.05 per company. Requires enableIntent. Auto-enabled in 'signals' and 'monitor' modes.", "default": false }, "intentBatchSize": { "title": "Intent batch size", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many jobs to send to Gemini per request. Larger = cheaper per job but slower. Default 20 is the sweet spot.", "default": 20 }, "incrementalMode": { "title": "Incremental mode (deltas only)", "type": "boolean", "description": "If enabled, the actor saves a fingerprint of each emitted job and, on the next run with the same input, only emits roles that are new, changed, or removed. Auto-enabled in 'monitor' mode. Use for scheduled daily/weekly runs.", "default": false }, "maxJobsPerCompany": { "title": "Max jobs per company", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Cap on jobs emitted per company. Big tech can have 5,000+ open roles — set this to control budget. 0 = no cap.", "default": 200 }, "maxItems": { "title": "Max items (global cap)", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Hard cap on total dataset rows. Pagination + per-company collection stops once reached.", "default": 1000 }, "concurrency": { "title": "Concurrent ATS fetches", "minimum": 1, "maximum": 25, "type": "integer", "description": "Parallel HTTP requests across companies. ATS APIs are fast and bot-friendly; default 8 is conservative.", "default": 8 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "ATS endpoints have no anti-bot. Leave empty unless you have a network policy. Workday tenants occasionally rate-limit aggressive scraping — switch to RESIDENTIAL if you see many 403s/429s.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }