{ "openapi": "3.0.1", "info": { "title": "Indeed Jobs Scraper", "description": "Scrape Indeed jobs in 60+ countries by keyword, location or URL, beyond the 1,000-job limit: title, full description, salary, location, job type, remote, company profile and rating. Export to JSON, CSV or Excel.", "version": "0.0", "x-build-id": "6eYqolohgrackBZdT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nice_dev~indeed-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nice_dev-indeed-jobs-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/nice_dev~indeed-jobs-scraper/runs": { "post": { "operationId": "runs-sync-nice_dev-indeed-jobs-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/nice_dev~indeed-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-nice_dev-indeed-jobs-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": { "startUrls": { "title": "Start URLs", "maxItems": 1000, "type": "array", "description": "Indeed URLs from any country site: search results (`https://www.indeed.com/jobs?q=nurse&l=Texas`, keyword, location, radius, date, sort and job-type filters are kept), company job pages (`https://www.indeed.com/cmp/Hubspot/jobs`; its own keyword and place are kept: `https://www.indeed.com/cmp/Hubspot/jobs?q=engineer&l=Boston`) or single jobs (`https://www.indeed.com/viewjob?jk=4f9a1c2b3d4e5f60`). When this list is not empty, the search fields below (keywords, locations, countries, companies) are ignored; filters, caps and monitoring still apply. For a single job link, the date, job-type, work-arrangement, experience, pay and language filters are checked on the job itself (a job that does not show the criterion is dropped, and counted as filtered out); the radius and the location of a search cannot be read on a job and are not applied. Max 1 000 URLs.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "query": { "title": "Search keyword", "maxLength": 200, "type": "string", "description": "Job title, skill or company, as typed on Indeed (e.g. `software engineer`). Indeed search syntax works: `title:(nurse)`, `\"exact phrase\"`, `-excluded`, `or`. Empty = every job of the location." }, "searchQueries": { "title": "More search keywords", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Several keywords in one run: one search per keyword (times each location and each country). Added to **Search keyword**; jobs found by several searches are saved once.", "default": [], "items": { "type": "string" } }, "location": { "title": "Location", "maxLength": 200, "type": "string", "description": "City, state, region or postal code, as typed on Indeed (e.g. `New York, NY`, `Paris`, `Remote`). Empty = the whole country." }, "locations": { "title": "More locations", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Several locations in one run: every keyword is searched in every location (3 keywords × 4 locations = 12 searches per country, max 500 searches). Added to **Location**.", "default": [], "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "US", "GB", "CA", "AU", "IN", "IE", "NZ", "SG", "ZA", "AE", "FR", "DE", "ES", "IT", "NL", "BE", "CH", "AT", "PL", "SE", "BR", "MX", "JP", "KR", "AR", "BH", "CL", "CN", "CO", "CR", "CZ", "DK", "EC", "EG", "FI", "GR", "HK", "HU", "ID", "IL", "KW", "LU", "MA", "MY", "NG", "NO", "OM", "PA", "PE", "PH", "PK", "PT", "QA", "RO", "SA", "TH", "TR", "TW", "UA", "UY", "VE", "VN" ], "type": "string", "description": "Indeed country site to search (each country has its own jobs). With no keyword, no location, no URL, no job key and no company: the default (United States) alone runs a small example (20 jobs), any other country reads every job of that country (up to **Max jobs**). The labels (tags, sectors, pay text) come in the language of the country's site, as on Indeed.", "default": "US" }, "countries": { "title": "More countries", "uniqueItems": true, "type": "array", "description": "Search several Indeed country sites in one run: every keyword × location is searched in each of them. With **Country** left on United States, only the countries of this list are searched (to include the US, put `US` here); another **Country** is added to the list. Leave **Location** empty to cover each whole country. With no keyword or location, a filled list alone reads every job of those countries (the default country is then not added: for the whole US, put `US` here).", "items": { "type": "string", "enum": [ "US", "GB", "CA", "AU", "IN", "IE", "NZ", "SG", "ZA", "AE", "FR", "DE", "ES", "IT", "NL", "BE", "CH", "AT", "PL", "SE", "BR", "MX", "JP", "KR", "AR", "BH", "CL", "CN", "CO", "CR", "CZ", "DK", "EC", "EG", "FI", "GR", "HK", "HU", "ID", "IL", "KW", "LU", "MA", "MY", "NG", "NO", "OM", "PA", "PE", "PH", "PK", "PT", "QA", "RO", "SA", "TH", "TR", "TW", "UA", "UY", "VE", "VN" ], "enumTitles": [ "United States", "United Kingdom", "Canada", "Australia", "India", "Ireland", "New Zealand", "Singapore", "South Africa", "United Arab Emirates", "France", "Germany", "Spain", "Italy", "Netherlands", "Belgium", "Switzerland", "Austria", "Poland", "Sweden", "Brazil", "Mexico", "Japan", "South Korea", "Argentina", "Bahrain", "Chile", "China", "Colombia", "Costa Rica", "Czech Republic", "Denmark", "Ecuador", "Egypt", "Finland", "Greece", "Hong Kong", "Hungary", "Indonesia", "Israel", "Kuwait", "Luxembourg", "Morocco", "Malaysia", "Nigeria", "Norway", "Oman", "Panama", "Peru", "Philippines", "Pakistan", "Portugal", "Qatar", "Romania", "Saudi Arabia", "Thailand", "Turkey", "Taiwan", "Ukraine", "Uruguay", "Venezuela", "Vietnam" ] }, "default": [] }, "companies": { "title": "Companies", "maxItems": 500, "uniqueItems": true, "type": "array", "description": "All the open jobs of these employers: company names (`Starbucks`), website domains (`starbucks.com`), Indeed company pages (`https://www.indeed.com/cmp/Starbucks`) or employer keys. A name or domain is matched to the exact Indeed employer (a domain must match the employer's website), not to look-alike names. Combined with the keywords and locations above when they are filled.", "default": [], "items": { "type": "string" } }, "jobKeys": { "title": "Job keys", "maxItems": 10000, "uniqueItems": true, "type": "array", "description": "Indeed job keys (the jk= value of a job link) to read directly, up to 10 000. They are read on top of the keyword and location searches: empty those fields to read only these jobs. Expired jobs are returned too, flagged as expired. The date, job-type, work-arrangement, experience, pay and language filters are checked on each job (a job that does not show the criterion is dropped, and counted as filtered out); the radius and the location cannot be read on a job and are not applied. A job link is read on the site of the link, a bare key on the **Country** site — on the first of **Countries** when Country is left on United States and that list is filled (give the country of the job to get its pay).", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max jobs", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Maximum number of jobs to save for the whole run (after deduplication and filters). 0 = no limit.", "default": 100 }, "maxItemsPerQuery": { "title": "Max jobs per search", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Cap for EACH search (keyword × location × country, company, or search URL), so that the first search cannot use up the whole **Max jobs** budget. 0 = no per-search cap.", "default": 0 }, "splitLargeSearches": { "title": "Get past the 1,000-job limit", "type": "boolean", "description": "Indeed shows at most 1,000 jobs per search. When a search has more, the Actor splits it into publication-date slices and collects each one (measured: 99.9 % of searches of 2,500 to 13,700 jobs instead of the first 1,000). The log and the `COVERAGE` record give announced vs collected jobs per search. Off = first 1,000 only.", "default": true }, "descriptionFormat": { "title": "Description format", "enum": [ "text_html", "all", "text", "html", "markdown", "none" ], "type": "string", "description": "Which forms of the full job description to save. Smaller = lighter dataset.", "default": "text_html" }, "extractContacts": { "title": "E-mails and phones from the job text (extra charge)", "type": "boolean", "description": "Add the e-mail addresses and phone numbers the employer wrote in the job description (`emails`, `phones`). Charged only for jobs where at least one is found (on 700 jobs read in the US, France and Germany: 19 % had an e-mail, 8 % a phone number). See Pricing.", "default": false }, "companySummary": { "title": "One summary row per company (extra charge)", "type": "boolean", "description": "Also save one row per employer found (`recordType` = `company`): profile, total open jobs on Indeed, new jobs in the last 24 hours / 7 days / 30 days, and the change since the previous run with the same **Memory key**. Ready for a CRM or n8n. Charged per company row. See Pricing.", "default": false }, "datePosted": { "title": "Date posted", "enum": [ "any", "24h", "3d", "7d", "14d", "30d" ], "type": "string", "description": "Only jobs added to Indeed in this period.", "default": "any" }, "jobTypes": { "title": "Job types", "uniqueItems": true, "type": "array", "description": "Keep jobs of ANY of these types. Empty = all. Outside the USA, the fixed-term contract Indeed shows as \"Contract\" (CDD, befristet…) is Fixed-term contract; Contract is the contractor, mostly USA, Canada and Australia.", "items": { "type": "string", "enum": [ "fulltime", "parttime", "contract", "temporary", "internship", "permanent", "fixedterm" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Temporary", "Internship", "Permanent", "Fixed-term contract" ] }, "default": [] }, "remoteType": { "title": "Remote", "enum": [ "any", "remote", "hybrid", "onsite" ], "type": "string", "description": "Work arrangement as tagged by Indeed.", "default": "any" }, "experienceLevels": { "title": "Experience levels", "uniqueItems": true, "type": "array", "description": "Keep jobs of ANY of these levels, as tagged by Indeed. Empty = all.", "items": { "type": "string", "enum": [ "entry", "mid", "senior" ], "enumTitles": [ "Entry level", "Mid-level", "Senior level" ] }, "default": [] }, "industries": { "title": "Industries", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Keep jobs of employers in ANY of these sectors, as named by Indeed in the country's language (e.g. `Healthcare`, `Information Technology`, `Banking`) — matched on the employer's sector — or by Indeed sector key (e.g. `22VKN`), which Indeed itself filters on. Use either names or keys in one run, not both. Empty = all.", "default": [], "items": { "type": "string" } }, "minSalary": { "title": "Minimum yearly salary", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Jobs whose yearly pay range reaches this amount, in the country's currency (Indeed's own filter: includes salaries estimated by Indeed). 0 = no filter.", "default": 0 }, "maxSalary": { "title": "Maximum yearly salary", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Jobs whose yearly pay range starts below this amount, in the country's currency (Indeed's own filter, like Minimum yearly salary). 0 = no limit.", "default": 0 }, "radius": { "title": "Radius", "minimum": 0, "maximum": 500, "type": "integer", "description": "Distance around **Location**. 0 = exact place only. Empty = Indeed's default (25 miles)." }, "radiusUnit": { "title": "Radius unit", "enum": [ "miles", "km" ], "type": "string", "description": "Unit of **Radius**.", "default": "miles" }, "jobLanguage": { "title": "Job language", "pattern": "^([a-zA-Z]{2})?$", "maxLength": 2, "type": "string", "description": "Only jobs written in this language: two-letter code such as `en`, `fr`, `de`. Empty = all." }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "Order of the results (matters with **Max jobs**). With **Only new jobs** or **Posted after**, the results are always read newest first.", "default": "relevance" }, "postedAfter": { "title": "Posted after", "type": "string", "description": "Only jobs added to Indeed on or after this date (`dateOnIndeed`): `2026-09-01` (a date alone starts at 00:00 UTC), or a period before now such as `7 days`, `2 weeks`, `1 month` (API: `24 hours` and full ISO date-times work too). Also sent to Indeed to read fewer pages." }, "postedBefore": { "title": "Posted before", "type": "string", "description": "Only jobs added to Indeed on or before this date (the whole day is included, in UTC), or older than a period such as `30 days`." }, "excludeKeywords": { "title": "Exclude keywords", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Drop the jobs whose title, or the cleaned-up title Indeed shows (`displayTitle`), contains one of these words (case and accents ignored).", "default": [], "items": { "type": "string" } }, "excludeCompanies": { "title": "Exclude companies", "maxItems": 200, "uniqueItems": true, "type": "array", "description": "Drop the jobs of these employers (the company name as shown, its Indeed company page name `companyProfileName`, or its parent group `parentCompanyName`, contains one of these words, case and accents ignored), e.g. staffing agencies.", "default": [], "items": { "type": "string" } }, "onlyWithSalary": { "title": "Only jobs with a salary", "type": "boolean", "description": "Drop the jobs that show no pay.", "default": false }, "applyMethod": { "title": "How to apply", "enum": [ "any", "easyApply", "external" ], "type": "string", "description": "Indeed Apply = jobs candidates apply to on Indeed (the isEasyApply column); Employer site = jobs that send candidates to the employer's or ATS page (the applyUrl column).", "default": "any" }, "minCompanyRating": { "title": "Minimum company rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Drop the jobs of employers rated below this on Indeed (out of 5). Jobs of unrated employers are dropped too when set. 0 = no filter.", "default": 0 }, "onlyNew": { "title": "Only new jobs", "type": "boolean", "description": "Skip the jobs that a previous run (same **Memory key**) already delivered: they are not saved and not charged. First run = everything is new.", "default": false }, "stateKey": { "title": "Memory key", "pattern": "^[a-zA-Z0-9_-]{1,64}$", "maxLength": 64, "type": "string", "description": "Name of the memory used by **Only new jobs** and by the company change counts. Give each schedule / task its own key (e.g. `nurses-texas`) so that they do not share their memory. Letters, digits, `-` and `_`.", "default": "default" }, "resetState": { "title": "Reset the memory", "type": "boolean", "description": "Forget everything remembered under this **Memory key** before the run: this run returns (and charges) every job again. Untick it afterwards.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy or your own proxies. Keep the default: it is included in the price. The residential Apify proxy is not available in this Actor.", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of requests processed in parallel. Lowered by itself to what the memory of the run holds (5 at the default 512 MB, 17 at 1 GB): give the Actor more memory to read more at a time.", "default": 3 }, "maxRequestsPerMinute": { "title": "Max requests per minute", "minimum": 10, "maximum": 600, "type": "integer", "description": "Most requests to Indeed in any 60 seconds (each request returns up to 100 jobs). A budget, not an even pace: up to this many can leave at once when the minute starts (spread them with the minimum delay below). Lower it if the log shows HTTP 429 / 403.", "default": 60 }, "minRequestIntervalMs": { "title": "Min delay between requests", "minimum": 0, "maximum": 60000, "type": "integer", "description": "Smallest gap between two requests, in milliseconds. Unlike the per-minute rate, this spreads the requests evenly instead of letting them go out in a burst. 0 = no gap.", "default": 0 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "maximum": 20, "type": "integer", "description": "Retries per request before it is marked as failed. Behind a proxy, a request the site turns away is also retried on a new proxy session up to 10 times without using up these retries.", "default": 5 }, "debugLog": { "title": "Debug log", "type": "boolean", "description": "Include debug messages in the run log.", "default": 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 }, "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 } } } } } } } } } }