{ "openapi": "3.0.1", "info": { "title": "Hiring Signal Scraper", "description": "Scrapes ATS job boards (Greenhouse, Ashby, Workable), enriches with Apollo, scores hiring urgency, and outputs decision maker contacts.", "version": "1.0", "x-build-id": "2Hfwrk5iHev9SepVE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tise.og~hiring-signal-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tise.og-hiring-signal-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/tise.og~hiring-signal-scraper/runs": { "post": { "operationId": "runs-sync-tise.og-hiring-signal-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/tise.og~hiring-signal-scraper/run-sync": { "post": { "operationId": "run-sync-tise.og-hiring-signal-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", "properties": { "apollo_api_key": { "title": "Apollo API Key", "type": "string", "description": "Paste your Apollo.io API key here. This gives you decision maker names, emails, company size, and revenue. Without it you still get hiring signals but no contacts. Get a key at app.apollo.io." }, "role": { "title": "Role to Search For", "type": "string", "description": "What role are you looking for? Type the job title. Leave blank to show ALL companies hiring for any role.", "default": "" }, "job_keywords": { "title": "Job Title Keywords", "type": "array", "description": "Keywords the scraper uses to find and match specific job titles. Add your own keywords here — one per line. These are used to filter companies and score hiring signals. Example: 'machine learning', 'data pipeline', 'clinical trial'.", "default": [ "software engineer", "backend engineer", "frontend engineer", "full stack", "platform engineer", "engineering manager", "devops", "sre", "infrastructure engineer", "machine learning", "ai engineer", "data engineer", "data scientist", "security engineer", "cloud engineer" ], "items": { "type": "string" } }, "contact_titles": { "title": "People to Find at Each Company", "type": "array", "description": "Job titles of the people you want contact info for. The scraper searches Apollo for people with these titles and returns their name, email, and LinkedIn. One per line.", "default": [ "CEO", "CTO", "Founder", "Co-Founder", "COO", "VP of Engineering", "Head of Engineering", "Director of Engineering", "VP of Talent", "Head of Recruiting", "Head of Operations", "Head of People" ], "items": { "type": "string" } }, "industry": { "title": "Industry Filter", "type": "string", "description": "Filter by industry. Comma-separated for multiple. Leave blank for all. Examples: 'AI, Fintech' or 'Healthcare, Biotech' or 'SaaS'.", "default": "" }, "company_size": { "title": "Company Size", "type": "array", "description": "Select one or more company size ranges. Leave empty for all sizes. Enter as JSON array like [\"1-50\", \"201-500\"]. Requires Apollo API key.", "items": { "type": "string" }, "default": [] }, "min_roles": { "title": "Minimum Open Roles", "minimum": 1, "type": "integer", "description": "Skip companies with fewer open roles than this number.", "default": 5 }, "max_results": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "How many companies do you want? Set to 0 for no limit. Results are sorted by hiring signal score (strongest first).", "default": 0 }, "min_score": { "title": "Minimum Signal Score", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only show companies with a hiring signal score at or above this number. 0 = show all, 50 = medium urgency and above, 75 = high urgency only.", "default": 0 }, "mode": { "title": "Where to Find Companies", "enum": [ "a", "b", "both" ], "type": "string", "description": "Mode A = use the company list below. Mode B = auto-discover companies from job boards. Both = do both.", "default": "a" }, "companies": { "title": "Company List", "type": "array", "description": "Your list of companies to scrape. Each company needs a name. Add domain and slug for faster results. Set ats_hint to 'greenhouse', 'ashby', or 'workable' if you know which job board they use.", "items": { "type": "object", "properties": { "name": { "title": "Company Name", "description": "Company name", "type": "string" }, "domain": { "title": "Domain", "description": "Company website domain (e.g. stripe.com)", "type": "string" }, "slug": { "title": "ATS Slug", "description": "Company slug on their job board URL", "type": "string" }, "ats_hint": { "title": "ATS Hint", "description": "Which job board they use: greenhouse, ashby, or workable", "type": "string", "enum": [ "greenhouse", "ashby", "workable", "" ] } }, "required": [ "name" ] }, "default": [ { "name": "Databricks", "domain": "databricks.com", "slug": "databricks", "ats_hint": "greenhouse" }, { "name": "Anthropic", "domain": "anthropic.com", "slug": "anthropic", "ats_hint": "greenhouse" }, { "name": "Stripe", "domain": "stripe.com", "slug": "stripe", "ats_hint": "greenhouse" }, { "name": "Coinbase", "domain": "coinbase.com", "slug": "coinbase", "ats_hint": "greenhouse" }, { "name": "Discord", "domain": "discord.com", "slug": "discord", "ats_hint": "greenhouse" }, { "name": "Scale AI", "domain": "scale.com", "slug": "scaleai", "ats_hint": "greenhouse" }, { "name": "Cloudflare", "domain": "cloudflare.com", "slug": "cloudflare", "ats_hint": "greenhouse" }, { "name": "Ramp", "domain": "ramp.com", "slug": "ramp", "ats_hint": "ashby" }, { "name": "Cursor", "domain": "cursor.com", "slug": "cursor", "ats_hint": "ashby" }, { "name": "Perplexity", "domain": "perplexity.ai", "slug": "perplexity", "ats_hint": "ashby" }, { "name": "Notion", "domain": "notion.so", "slug": "notion", "ats_hint": "ashby" } ] }, "skip_enrichment": { "title": "Skip Apollo Enrichment", "type": "boolean", "description": "Turn this on to skip Apollo lookups. Saves API credits but you won't get decision maker contacts, company size, or revenue.", "default": false }, "enrichment_threshold": { "title": "Enrichment Score Threshold", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only use Apollo credits on companies scoring above this number. Saves money by skipping low-signal companies. Default 40.", "default": 40 }, "discovery_remoteok": { "title": "Discovery: RemoteOK", "type": "boolean", "description": "Auto-discover companies from RemoteOK job board (Mode B only).", "default": true }, "discovery_jobicy": { "title": "Discovery: Jobicy", "type": "boolean", "description": "Auto-discover companies from Jobicy job board (Mode B only).", "default": true }, "discovery_yc_batches": { "title": "Discovery: YC Batches", "type": "array", "description": "Which Y Combinator batches to scan for companies (Mode B only).", "default": [ "S24", "W24", "S23" ], "items": { "type": "string" } } } }, "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 } } } } } } } } } }