# Indeed Jobs Scraper (`axlymxp/indeed-jobs-scraper`) Actor Scrape Indeed job listings at scale — job title, company, ratings, location, salary range, full description and apply links — across 25 country sites. Structured JSON ready for Sheets, your ATS or CRM. Ideal for recruiters, job boards and labor-market research. Pay only for the results you get. - **URL**: https://apify.com/axlymxp/indeed-jobs-scraper.md - **Developed by:** [axly](https://apify.com/axlymxp) (community) - **Categories:** Jobs - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 dataset items This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Indeed Jobs Scraper Extract structured job data from **Indeed** — the world's largest job site — by keyword, location and country. Get job titles, companies, salary ranges, company ratings, full descriptions and apply links as clean JSON, ready for your ATS, CRM, spreadsheet or data pipeline. No Indeed login, no browser automation to maintain — just fast, structured results across **25 Indeed country sites**. ### Who uses this - **Recruiters & staffing agencies** — build talent-market maps, monitor which roles competitors are hiring for, and feed openings into your ATS. - **Job boards & aggregators** — supplement your inventory with fresh Indeed postings, deduplicated and normalized. - **Labor-market & HR analysts** — track hiring demand, salary benchmarks and remote-work trends by role, city and country. - **PropTech / SaaS / AI developers** — a stable JSON schema to power job-search products, salary tools and AI agents. ### Output fields | Field | Type | Description | | ----- | ---- | ----------- | | `jobkey` | string | Indeed's unique job identifier | | `title` | string | Job title | | `company` | string | Employer name | | `company_rating` | number | Employer star rating (0–5) | | `company_review_count` | number | Number of employer reviews | | `location` | string | Formatted job location | | `city` / `state` / `postal_code` / `country` | string | Parsed location parts | | `remote` | boolean | Whether the job is remote | | `salary_min` / `salary_max` | number | Salary range when published | | `salary_currency` | string | Salary currency | | `salary_unit` | string | Pay period (year, hour, …) | | `salary_text` | string | Salary as shown on Indeed | | `employment_type` | string | Full-time, contract, etc. (detail mode) | | `job_types` | array | Job-type tags | | `snippet_text` | string | Short summary from the search card | | `description_text` | string | Full job description (detail mode) | | `posted_relative` | string | e.g. "3 days ago" | | `date_posted` | string | ISO date the job was posted (detail mode) | | `sponsored` | boolean | Whether the listing is a paid ad | | `indeed_applyable` | boolean | Whether Easy Apply is available | | `url` | string | Link to the job on Indeed | | `scraped_at` | string | ISO-8601 timestamp of extraction | ### High-value use cases 1. **Competitive hiring intelligence** — track a competitor's open roles by searching their company name and location weekly. 2. **Salary benchmarking** — collect `salary_min`/`salary_max` for a role across cities to build compensation bands. 3. **Lead lists for staffing** — pull fresh openings in a niche (e.g. "registered nurse", "Dallas, TX") and route them to recruiters. 4. **Remote-work trend tracking** — filter `remote=true` roles over time. 5. **AI job-search assistants** — feed normalized JSON to an LLM to answer "find me senior Python jobs in Berlin posted this week". ### Input parameters | Parameter | Type | Default | Description | | --------- | ---- | ------- | ----------- | | `query` | string | — | **Required.** Job title or keywords. | | `location` | string | — | City, state, ZIP or "Remote". | | `country` | enum | `us` | Which Indeed country site to search (25 supported). | | `maxItems` | integer | 50 | Stop after this many jobs. | | `fetchDetails` | boolean | false | Enrich each job with full description, precise salary and address. | | `jobType` | enum | any | Full-time, part-time, contract, temporary, internship. | | `maxAgeDays` | integer | — | Only jobs posted within N days. | | `radius` | integer | — | Search radius around the location. | | `sort` | enum | relevance | `relevance` or `date` (newest first). | | `includeSponsored` | boolean | true | Include promoted job ads. | | `proxyConfiguration` | object | Residential | Proxy settings — **use Residential**. | ### Example input ```json { "query": "software engineer", "location": "New York, NY", "country": "us", "maxItems": 50, "fetchDetails": true, "sort": "date", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` ### Example output ```json { "jobkey": "a1b2c3d4e5f6", "title": "Senior Software Engineer", "company": "Acme Corp", "company_rating": 4.1, "company_review_count": 320, "location": "New York, NY 10003", "city": "New York", "state": "NY", "country": "us", "remote": false, "salary_min": 140000, "salary_max": 180000, "salary_currency": "USD", "salary_unit": "YEAR", "salary_text": "$140,000 - $180,000 a year", "employment_type": "FULL_TIME", "snippet_text": "We are looking for a senior engineer to...", "posted_relative": "2 days ago", "indeed_applyable": true, "url": "https://www.indeed.com/viewjob?jk=a1b2c3d4e5f6", "scraped_at": "2026-07-17T12:00:00+00:00" } ``` ### Scheduling & integrations - **Schedule** runs (hourly/daily/weekly) from the Apify Console to keep a fresh jobs feed. - **Webhooks** notify your app when a run finishes. - Export to **Google Sheets, Make, Zapier, Amazon S3** or pull via the Apify API. ### MCP / AI assistants Prefer live access from an AI assistant (Claude, Cursor, ChatGPT)? Use the companion **Indeed MCP Server** actor, which exposes job search, detail lookup and location autocomplete as Model Context Protocol tools. ### FAQ **How many jobs can I get per search?** Indeed gates anonymous access beyond roughly the first result page per query (~15–45 jobs including sponsored). To collect more, vary `query`, `location`, `jobType`, `maxAgeDays` and `country` across runs — this also yields broader, less-duplicated coverage. **Why should I use Residential proxies?** Indeed is protected by Cloudflare and blocks datacenter IPs. Residential proxies make requests look like real users and dramatically improve reliability. **Is the data fresh?** Yes — every run fetches live pages directly from Indeed at run time. **Do I need an Indeed account or API key?** No. The actor reads publicly visible job pages. **Is scraping Indeed legal?** The actor collects only publicly available job postings. You are responsible for complying with Indeed's terms and applicable laws in your jurisdiction. **Something broke — how fast is support?** Report issues on the actor's Issues tab; fixes are typically shipped quickly. # Actor input Schema ## `query` (type: `string`): Job title, skills or company to search for, e.g. "software engineer" or "registered nurse". ## `location` (type: `string`): City, state, ZIP or region, e.g. "New York, NY" or "Remote". Leave empty to search nationwide. ## `country` (type: `string`): Which Indeed country site to search. Determines currency, language and job coverage. ## `maxItems` (type: `integer`): Stop after collecting this many jobs. Note: anonymous scraping is capped by Indeed to roughly the first result page per query — broaden coverage by varying keywords, location and filters. ## `fetchDetails` (type: `boolean`): Fetch each job's detail page for the full description, precise salary range, full address and direct-apply flag. Slower and uses more requests. ## `jobType` (type: `string`): Filter by employment type. ## `maxAgeDays` (type: `integer`): Only include jobs posted within this many days (e.g. 1, 3, 7, 14). ## `radius` (type: `integer`): Search radius around the location, in miles (US/UK) or km. ## `sort` (type: `string`): Sort results by relevance or by date (newest first). ## `includeSponsored` (type: `boolean`): Include sponsored/promoted job ads in the results. ## `proxyConfiguration` (type: `object`): Proxy settings. Apify RESIDENTIAL proxies are strongly recommended — Indeed blocks datacenter IPs via Cloudflare. ## Actor input object example ```json { "query": "software engineer", "location": "New York, NY", "country": "us", "maxItems": 50, "fetchDetails": false, "jobType": "", "sort": "relevance", "includeSponsored": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "query": "software engineer", "location": "New York, NY", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("axlymxp/indeed-jobs-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "query": "software engineer", "location": "New York, NY", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("axlymxp/indeed-jobs-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "query": "software engineer", "location": "New York, NY", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call axlymxp/indeed-jobs-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=axlymxp/indeed-jobs-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Indeed Jobs Scraper", "description": "Scrape Indeed job listings at scale — job title, company, ratings, location, salary range, full description and apply links — across 25 country sites. Structured JSON ready for Sheets, your ATS or CRM. Ideal for recruiters, job boards and labor-market research. Pay only for the results you get.", "version": "1.0", "x-build-id": "eWQOTaF3GxNvzT6kd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axlymxp~indeed-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axlymxp-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/axlymxp~indeed-jobs-scraper/runs": { "post": { "operationId": "runs-sync-axlymxp-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/axlymxp~indeed-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-axlymxp-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", "required": [ "query" ], "properties": { "query": { "title": "Search keywords", "type": "string", "description": "Job title, skills or company to search for, e.g. \"software engineer\" or \"registered nurse\"." }, "location": { "title": "Location", "type": "string", "description": "City, state, ZIP or region, e.g. \"New York, NY\" or \"Remote\". Leave empty to search nationwide." }, "country": { "title": "Country site", "enum": [ "us", "uk", "ca", "au", "ie", "in", "de", "fr", "es", "it", "nl", "be", "ch", "at", "pl", "se", "br", "mx", "ar", "sg", "ph", "za", "nz", "jp", "ae" ], "type": "string", "description": "Which Indeed country site to search. Determines currency, language and job coverage.", "default": "us" }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after collecting this many jobs. Note: anonymous scraping is capped by Indeed to roughly the first result page per query — broaden coverage by varying keywords, location and filters.", "default": 50 }, "fetchDetails": { "title": "Fetch full job details", "type": "boolean", "description": "Fetch each job's detail page for the full description, precise salary range, full address and direct-apply flag. Slower and uses more requests.", "default": false }, "jobType": { "title": "Job type", "enum": [ "", "fulltime", "parttime", "contract", "temporary", "internship" ], "type": "string", "description": "Filter by employment type.", "default": "" }, "maxAgeDays": { "title": "Max posting age (days)", "minimum": 1, "type": "integer", "description": "Only include jobs posted within this many days (e.g. 1, 3, 7, 14)." }, "radius": { "title": "Search radius", "minimum": 0, "type": "integer", "description": "Search radius around the location, in miles (US/UK) or km." }, "sort": { "title": "Sort order", "enum": [ "relevance", "date" ], "type": "string", "description": "Sort results by relevance or by date (newest first).", "default": "relevance" }, "includeSponsored": { "title": "Include sponsored listings", "type": "boolean", "description": "Include sponsored/promoted job ads in the results.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Apify RESIDENTIAL proxies are strongly recommended — Indeed blocks datacenter IPs via Cloudflare.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```