{
"openapi": "3.0.1",
"info": {
"title": "Indeed Comprehensive Crawler",
"description": "The most comprehensive Indeed crawler Extract every field Indeed exposes: salary, job type, benefits, company rating & reviews, hiring insights, GPS coordinates, full company profile (CEO, revenue, industry, website), the real external apply URL. Search by URL, keyword or region across 60+ countries",
"version": "0.0",
"x-build-id": "HfUuD5BwYAaM6dHxI"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/memo23~apify-indeed/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-memo23-apify-indeed",
"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/memo23~apify-indeed/runs": {
"post": {
"operationId": "runs-sync-memo23-apify-indeed",
"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/memo23~apify-indeed/run-sync": {
"post": {
"operationId": "run-sync-memo23-apify-indeed",
"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": {
"startUrls": {
"title": "Start URLs",
"type": "array",
"description": "URLs to start with.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"includeCompanyDetails": {
"title": "Include Company Details",
"type": "boolean",
"description": "Set to true if you want to scrape company details.",
"default": false
},
"resolveExternalApplyUrl": {
"title": "Resolve External Apply URL",
"type": "boolean",
"description": "When enabled, jobs that redirect to a client site or ATS (have a `thirdPartyApplyUrl`) will be followed through Indeed's redirect chain so that the final external apply URL is captured into the `externalApplyUrl` field. Adds one extra HTTP request per applicable job.",
"default": true
},
"onlyExternalJobs": {
"title": "Include only external sources",
"type": "boolean",
"description": "Set to true if you want to only external sources when scraping.",
"default": false
},
"maxJobs": {
"title": "Max jobs to scrape",
"type": "integer",
"description": "Maximum number of jobs to extract per start URL. With several start URLs (or a region expanded into cities), the run can return up to this number times the number of URLs. The run also stops early if it reaches the maximum cost per run you set.",
"default": 20
},
"flattenOutput": {
"title": "Flatten Output Structure",
"type": "boolean",
"description": "Set to true to output a flat data structure with all nested objects flattened into top-level fields. When enabled, nested objects are flattened (e.g., salary details, location, company info become individual fields). When disabled, the raw nested API response is preserved.",
"default": false
},
"expandToCities": {
"title": "Expand Country/Region URLs into Cities",
"type": "boolean",
"description": "When enabled (default), search URLs whose location is a country or large region (e.g. `l=Scotland`, `l=United Kingdom`, `l=East+of+England+Region`) are automatically fanned out into a list of major-city search URLs and the results deduped by `jobId`. Indeed caps mobile SERP pagination per query, so the union of city-level queries typically yields 2-5x more total results than the parent region query. Indeed's UI emits `radius=0` (exact-match) for region chips, which would return near-zero jobs at the city level, so a `radius=0` on the parent URL is automatically bumped to `radius=25` (Indeed's UI default) for the city queries. Set to `false` to disable fan-out and scrape the exact URL you provided. No effect when the location is already a city, postcode, or empty.",
"default": true
},
"strictMatch": {
"title": "Strict keyword match (drop unrelated jobs)",
"type": "boolean",
"description": "When enabled, drops any job whose title or description does not contain your search keyword(s). Indeed's own search pads every result page with loosely-related and sponsored jobs (e.g. a 'Real Estate Agent' or 'CDL Driver' for a `typescript` search) — those appear in the output by default because the scraper returns exactly what Indeed returns. Turn this on to keep only genuine keyword matches. Keys on the `q` of your search URL. Leave off (default) to get Indeed's full result set unchanged.",
"default": false
},
"uniqueCompanies": {
"title": "One job per company (unique companies only)",
"type": "boolean",
"description": "When enabled, the output contains at most one job per company — every row is a distinct employer. Dedupes on Indeed's encrypted company id (so 'Acme Inc' and 'Acme Inc.' count as one), falling back to the company name. Note: because many listings share an employer, reaching a target number of unique companies means scanning more jobs, so a narrow search may return fewer unique companies than `maxJobs`. Leave off (default) to return every job.",
"default": false
},
"proxy": {
"title": "Proxy configuration",
"type": "object",
"description": "Specifies proxy servers that will be used by the scraper in order to hide its origin.
For details, see Proxy configuration in README.",
"default": {
"useApifyProxy": 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
},
"PROXY_UNBLOCKER_UNITS": {
"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
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}