{ "openapi": "3.0.1", "info": { "title": "Indeed Jobs Scraper - Salary & Company Data ($0.25/1k)", "description": "Scrape Indeed job listings by keyword, location, or any search URL across 60+ country sites - no API key, no login. Get salary (parsed min/max), company profile, hiring signals, and the full description as text, Markdown & HTML. Pay only per result. Works with AI Agents, MCP, n8n, Make & Zapier.", "version": "0.0", "x-build-id": "dp1Kr4osAdv5ppzoQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/harshmaur~indeed-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-harshmaur-indeed-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/harshmaur~indeed-scraper/runs": { "post": { "operationId": "runs-sync-harshmaur-indeed-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/harshmaur~indeed-scraper/run-sync": { "post": { "operationId": "run-sync-harshmaur-indeed-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": { "position": { "title": "Job title / keywords", "type": "string", "description": "What to search for, e.g. \"software engineer\", \"registered nurse\", \"python developer\". Leave empty if you are only using Search URLs below." }, "location": { "title": "Location", "type": "string", "description": "City, state, ZIP, or \"remote\" — e.g. \"New York, NY\", \"London\", \"94103\". Leave empty to search the whole country." }, "country": { "title": "Country", "enum": [ "us", "uk", "ca", "au", "ie", "nz", "in", "sg", "za", "ph", "de", "fr", "es", "it", "nl", "be", "at", "ch", "se", "no", "dk", "fi", "pl", "pt", "gr", "cz", "ro", "hu", "ua", "br", "mx", "ar", "cl", "co", "pe", "uy", "ec", "cr", "pa", "ve", "jp", "kr", "hk", "tw", "th", "id", "my", "vn", "cn", "pk", "ae", "sa", "qa", "kw", "bh", "om", "il", "eg", "ma", "ng", "tr", "lu" ], "type": "string", "description": "Indeed country site to search. Determines the domain (e.g. US → indeed.com, UK → uk.indeed.com).", "default": "us" }, "datePosted": { "title": "Date posted", "enum": [ "", "1", "3", "7", "14" ], "type": "string", "description": "Only return jobs posted within this window.", "default": "" }, "startUrls": { "title": "Search URLs", "type": "array", "description": "Paste one or more Indeed search/result URLs to scrape directly (e.g. a filtered search you built on indeed.com). The keyword fields above do NOT apply to these — they are scraped as-is, then paginated.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max jobs", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum number of job listings to scrape across all searches and URLs. Indeed caps a single search at ~1000 results. Set 0 for no limit (stops when Indeed runs out of results).", "default": 50 }, "scrapeDescription": { "title": "Scrape full job description", "type": "boolean", "description": "Fetch the complete job description text and HTML for every listing. Adds a small number of extra requests (descriptions are fetched in batches). Disable for a faster, lighter run that still returns title, company, salary, location, rating, and posting date.", "default": true }, "mcpConnector": { "title": "Send results to an app (MCP connector)", "type": "string", "description": "Pick an authorized MCP connector (Slack, Notion, Airtable, Google Sheets, …) to receive the scraped jobs. This is the recommended, secure path — your credentials stay in Apify and are never exposed to this actor (Apify's proxy injects them). Leave empty to scrape only. Tip: schedule this actor with the 'Last 24 hours' date filter to get pinged whenever a matching job is posted." }, "mcpMode": { "title": "Delivery mode", "enum": [ "perPost", "summary" ], "type": "string", "description": "perPost: send one message/record per scraped job. summary: send a single digest of the whole run.", "default": "perPost" }, "mcpTarget": { "title": "Target page / database / channel", "type": "string", "description": "Where to write — the destination ID the tool needs: a Notion database/page ID, a Google Sheet ID, or a Slack channel. Leave blank for connectors that post to a default location. Advanced shapes go in Arguments JSON below." }, "mcpMessage": { "title": "Message template", "type": "string", "description": "Template for each message. Use {{field}} placeholders from ANY job field — common ones: {{title}}, {{company}}, {{location}}, {{url}}, {{postedAt}}, {{salary}}, {{isRemote}}, {{jobType}}, {{companyRating}}. (Full field list in the README.) Missing fields render empty.", "default": "*{{title}}* — {{company}}\n{{location}}\n{{url}}" }, "mcpTool": { "title": "Tool override (advanced)", "type": "string", "description": "Force a specific tool name on the connector (e.g. send_message, create_page, append_row). Leave empty to auto-detect the connector's write/notify tool." }, "mcpArguments": { "title": "Tool arguments override (advanced)", "type": "object", "description": "Extra/override arguments merged into each tool call as JSON — e.g. {\"channel\": \"#jobs\"} for Slack. {{field}} placeholders work inside string values too, so you can nest live data into any shape the tool needs — e.g. Notion: {\"properties\": {\"Title\": {\"title\": [{\"text\": {\"content\": \"{{title}}\"}}]}, \"Link\": {\"url\": \"{{url}}\"}}}. Use it to satisfy required fields or fully control the payload." }, "mcpMaxItems": { "title": "Max jobs to send", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Safety cap on how many jobs are piped to the connector per run (perPost mode). Protects against flooding the destination.", "default": 50 }, "mcpServerUrl": { "title": "MCP server URL (dev / diagnostic)", "type": "string", "description": "Advanced/testing only. Connect directly to a raw MCP server URL, bypassing the MCP Connector above. For real use prefer a connector — with a connector your credentials stay in Apify and are never seen by this actor. When set, this overrides the connector." }, "mcpServerToken": { "title": "MCP server token (dev / diagnostic)", "type": "string", "description": "Bearer token for the dev MCP server URL above. Note: a token entered here IS visible to the actor at runtime — for production use an MCP Connector instead, so credentials never leave Apify. Ignored unless the URL is set." } } }, "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 } } } } } } } } } }