# Indeed Jobs Scraper (`xtracto/indeed-jobs-scraper`) Actor
Search Indeed by keyword + location and get structured job listings — title, company, salary range, rating, location, remote flag, posted date and (optionally) the full job description.
- **URL**: https://apify.com/xtracto/indeed-jobs-scraper.md
- **Developed by:** [Farhan Febrian Nauval](https://apify.com/xtracto) (community)
- **Categories:** Jobs
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.00 / 1,000 results
This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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
Search **Indeed** by keyword and location and get clean, structured job listings — job title, company, salary range, company rating, location, remote flag, and posting date — with an option to pull the **full job description** for every result. No account, no login, no API key.
### Why use this actor
- **Keyword + location search**, just like using Indeed itself (the "what" and "where" boxes).
- **17 country sites supported** — United States, UK, Canada, Australia, India, Germany, France, and more.
- **Real salary data** — where Indeed shows an actual employer-provided pay range, you get the exact numbers (`salaryMin` / `salaryMax`) plus whether it's a real posted salary or an estimate.
- **Full job descriptions** on demand — flip one switch to get the complete description, benefits list, and salary text for each job.
- **Company signals** — rating, review count, and remote flag on every listing.
- **Clean JSON output**, ready for spreadsheets, databases, or your own pipelines.
- **Nothing fails silently** — if a search returns nothing, you get a clear reason, not an empty file.
### How it works
1. You enter a search keyword, a location, and pick the country site.
2. The actor runs that search on Indeed and reads the job listings.
3. Optionally, it opens each job to add the full description, benefits, and salary text.
4. Results stream into your dataset, ready to download as JSON, CSV, or Excel.
You don't manage any of the fetching, retries, or blocking — just describe the search you want.
### Important: how many results you get per search
Indeed shows search results as pages, but for visitors who are **not signed in**, only the **first page** of a search is publicly available — trying to open page 2 sends you to a sign-in screen. This is Indeed's own limit, not the actor's.
**What this means for you:** each search returns the **first page of results (about 24 jobs)** for that exact query. The actor detects the sign-in wall and stops cleanly — it never crashes or loops.
**How to get more jobs:** run **narrower searches** instead of trying to page deeper. For example:
- Add a **date filter** (`fromage`) like "last 3 days" to keep pulling fresh listings over time.
- Use a **tighter location** plus a **radius** (e.g. a specific city + 25 miles).
- Use **more specific keywords** (e.g. "senior react developer" instead of "engineer").
- Split one broad search into several focused ones and combine the results.
The number of total matches Indeed reports for your search is included in every record as `searchTotalJobCount`, so you always know how big the full pool is.
### Input
```json
{
"query": "software engineer",
"location": "New York",
"country": "us",
"fromage": 7,
"radius": 25,
"fetchDetail": true,
"maxItems": 50,
"maxConcurrency": 4,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"]
}
}
````
| Field | Type | Description |
|---|---|---|
| `query` | string | Search keywords — job title, skill, or company (the Indeed "what" box). |
| `location` | string | City, state, postal code, or region (the Indeed "where" box). Leave empty to search the whole country. |
| `country` | string | Which Indeed country site to search: `us`, `uk`, `ca`, `au`, `in`, `ie`, `de`, `fr`, `es`, `it`, `nl`, `za`, `sg`, `nz`, `br`, `mx`, `ph`. Default `us`. |
| `fromage` | integer | Only return jobs posted within this many days (e.g. `1`, `3`, `7`, `14`). Optional. |
| `radius` | integer | Distance around the location to include, e.g. `25`. Optional. |
| `fetchDetail` | boolean | If `true`, opens each job to add the full description, benefits, and salary text. Slower but richer. Default `false`. |
| `maxItems` | integer | Overall cap on jobs returned. `0` = all available on the first results page. Default `50`. |
| `maxConcurrency` | integer | How many job pages to open in parallel when `fetchDetail` is on. Default `4`. |
| `proxyConfiguration` | object | Residential proxy strongly recommended. If you don't set a country here, it's matched automatically to the country you chose. |
### Output
One record per job. Below is a **real record** captured from the search `software engineer` in `New York` (US) — with `fetchDetail` off:
```json
{
"_input": "software engineer @ New York (us)",
"_source": "S1-jobcards",
"_scrapedAt": "2026-07-10T11:53:50Z",
"recordType": "JOB",
"jobkey": "c886fc9e763b5619",
"jobUrl": "https://www.indeed.com/viewjob?jk=c886fc9e763b5619",
"positionName": "Java Lead Software Engineer",
"company": "JPMorganChase",
"location": "New York, NY 10001",
"isRemote": false,
"salaryMin": 152000,
"salaryMax": 215000,
"salaryType": "YEARLY",
"salaryCurrency": "USD",
"salaryText": "$152,000 - $215,000 a year",
"salarySource": "EXTRACTION",
"companyRating": 3.9,
"companyReviewCount": 20384,
"postedAt": "30+ days ago",
"pubDate": 1777525200000,
"isNew": false,
"urgentlyHiring": false,
"indeedApplyable": false,
"companyIdEncrypted": "dfe1b23f5f99f0a7",
"companyOverviewLink": "/cmp/Jpmorganchase-2",
"searchQuery": "software engineer",
"searchLocation": "New York",
"searchCountry": "us",
"searchTotalJobCount": 2277
}
```
When `fetchDetail` is `true`, each record also gets the full job content (real values from the same job):
```json
{
"_source": "S1-jobcards+S2-viewjob",
"detailCompanyName": "JPMorganChase",
"detailJobTitle": "Java Lead Software Engineer",
"descriptionText": "JOB DESCRIPTION\n\nWe have an opportunity to impact your career and provide an adventure where you can push the limits of what's possible.\n\nAs a Lead Software Engineer at JPMorganChase within the Trust and Sec... (full text continues)",
"descriptionHtml": "JOB DESCRIPTION ...
",
"detailBenefits": [
{ "key": "HJUWZ", "label": "Tuition reimbursement" },
{ "key": "EY33Q", "label": "Health insurance" }
],
"detailSalaryText": "$152,000 - $215,000 a year",
"datePublished": null
}
```
#### Output fields
| Field | Type | Description |
|---|---|---|
| `_input` | string | The search that produced this record (`query @ location (country)`). |
| `_source` | string | Where the data came from — `S1-jobcards` (search) or `S1-jobcards+S2-viewjob` (search + full detail). |
| `_scrapedAt` | string | UTC timestamp when the record was collected. |
| `recordType` | string | Always `JOB`. |
| `jobkey` | string | Indeed's unique job ID. |
| `jobUrl` | string | Direct link to the job on Indeed. |
| `positionName` | string | Job title. |
| `company` | string | Employer name. |
| `location` | string | Job location as shown. |
| `isRemote` | boolean | Whether the job is flagged remote. |
| `salaryMin` / `salaryMax` | number | Salary range numbers, when an actual range is provided. |
| `salaryType` | string | Pay period, e.g. `YEARLY`, `HOURLY`. |
| `salaryCurrency` | string | Currency, e.g. `USD`. |
| `salaryText` | string | Salary as shown, e.g. `$152,000 - $215,000 a year`. |
| `salarySource` | string | `EXTRACTION` = employer-provided real salary; `ESTIMATION` = Indeed estimate. |
| `companyRating` | number | Company rating (out of 5), if available. |
| `companyReviewCount` | number | Number of company reviews. |
| `postedAt` | string | Human-readable posting age, e.g. `3 days ago`. |
| `pubDate` | number | Posting date (Unix milliseconds). |
| `isNew` | boolean | Whether Indeed flags the job as new. |
| `urgentlyHiring` | boolean | Whether Indeed flags urgent hiring. |
| `indeedApplyable` | boolean | Whether the job supports Indeed's one-click apply. |
| `companyIdEncrypted` | string | Indeed's internal company reference. |
| `companyOverviewLink` | string | Path to the company page on Indeed. |
| `searchTotalJobCount` | number | Total jobs Indeed reports for your search (the full pool size). |
| `descriptionText` | string | Full job description as plain text. *(only with `fetchDetail`)* |
| `descriptionHtml` | string | Full job description with original formatting. *(only with `fetchDetail`)* |
| `detailBenefits` | array | Listed benefits. *(only with `fetchDetail`)* |
| `detailSalaryText` | string | Salary text from the job page. *(only with `fetchDetail`)* |
| `datePublished` | number | Publish date from the job page, when present. *(only with `fetchDetail`)* |
Every job also carries **all of Indeed's original listing fields** verbatim (company review link, job type tags, location details, and more) alongside the friendly fields above, so nothing is lost.
Searches that return nothing (or are stopped by the sign-in wall on page 1) produce a record with an `_error` field instead of job data — so a run never fails silently.
### Notes
- **Pick the country that matches your location** — search `london` with `country: "uk"`, `toronto` with `country: "ca"`, and so on.
- **`salarySource` matters** — `EXTRACTION` is a real employer salary; `ESTIMATION` is an Indeed estimate. Filter on this if you only want confirmed pay.
- **Each search returns Indeed's first results page** (about 24 jobs). Use `fromage`, `radius`, and more specific keywords to cover more ground — see "how many results you get per search" above.
- **Residential proxy is recommended**, especially for non-US country sites.
# Actor input Schema
## `query` (type: `string`):
Job title, skill or keyword to search for (the Indeed "what" box). Example: software engineer, registered nurse, data analyst.
## `location` (type: `string`):
City, state, postal code or region (the Indeed "where" box). Leave empty to search the whole country. Example: New York, Remote, London.
## `country` (type: `string`):
Which Indeed country site to search. Pick the country that matches your location.
## `fromage` (type: `integer`):
Only return jobs posted within this many days. Leave empty for any age. Common values: 1, 3, 7, 14. Tip: a tighter value returns fresher results and helps get past the single-page limit.
## `radius` (type: `integer`):
Distance around the location to include. Leave empty for the Indeed default. Example: 25.
## `fetchDetail` (type: `boolean`):
If on, the actor opens each job to add the full job description, benefits and salary text. Slower but richer.
## `maxItems` (type: `integer`):
Overall cap on jobs returned for this run. 0 = all available on the first results page.
## `maxConcurrency` (type: `integer`):
How many job pages to open in parallel when "Fetch full job description" is on. Keep moderate to stay reliable.
## `proxyConfiguration` (type: `object`):
Residential proxy is strongly recommended. If you don't set a country here, the actor automatically matches it to the country you selected above.
## Actor input object example
```json
{
"query": "software engineer",
"location": "New York",
"country": "us",
"fetchDetail": false,
"maxItems": 50,
"maxConcurrency": 4,
"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",
"country": "us"
};
// Run the Actor and wait for it to finish
const run = await client.actor("xtracto/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",
"country": "us",
}
# Run the Actor and wait for it to finish
run = client.actor("xtracto/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",
"country": "us"
}' |
apify call xtracto/indeed-jobs-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=xtracto/indeed-jobs-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Indeed Jobs Scraper",
"description": "Search Indeed by keyword + location and get structured job listings — title, company, salary range, rating, location, remote flag, posted date and (optionally) the full job description.",
"version": "0.1",
"x-build-id": "mBf12fjeNmCB9RaaX"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/xtracto~indeed-jobs-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-xtracto-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/xtracto~indeed-jobs-scraper/runs": {
"post": {
"operationId": "runs-sync-xtracto-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/xtracto~indeed-jobs-scraper/run-sync": {
"post": {
"operationId": "run-sync-xtracto-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": {
"query": {
"title": "Search keywords",
"type": "string",
"description": "Job title, skill or keyword to search for (the Indeed \"what\" box). Example: software engineer, registered nurse, data analyst."
},
"location": {
"title": "Location",
"type": "string",
"description": "City, state, postal code or region (the Indeed \"where\" box). Leave empty to search the whole country. Example: New York, Remote, London."
},
"country": {
"title": "Country / Indeed site",
"enum": [
"us",
"uk",
"ca",
"au",
"in",
"ie",
"de",
"fr",
"es",
"it",
"nl",
"za",
"sg",
"nz",
"br",
"mx",
"ph"
],
"type": "string",
"description": "Which Indeed country site to search. Pick the country that matches your location.",
"default": "us"
},
"fromage": {
"title": "Max age of job posts (days)",
"minimum": 1,
"maximum": 60,
"type": "integer",
"description": "Only return jobs posted within this many days. Leave empty for any age. Common values: 1, 3, 7, 14. Tip: a tighter value returns fresher results and helps get past the single-page limit."
},
"radius": {
"title": "Search radius (miles/km)",
"minimum": 0,
"maximum": 100,
"type": "integer",
"description": "Distance around the location to include. Leave empty for the Indeed default. Example: 25."
},
"fetchDetail": {
"title": "Fetch full job description",
"type": "boolean",
"description": "If on, the actor opens each job to add the full job description, benefits and salary text. Slower but richer.",
"default": false
},
"maxItems": {
"title": "Max jobs (0 = all available)",
"minimum": 0,
"type": "integer",
"description": "Overall cap on jobs returned for this run. 0 = all available on the first results page.",
"default": 50
},
"maxConcurrency": {
"title": "Max concurrent detail fetches",
"minimum": 1,
"maximum": 12,
"type": "integer",
"description": "How many job pages to open in parallel when \"Fetch full job description\" is on. Keep moderate to stay reliable.",
"default": 4
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Residential proxy is strongly recommended. If you don't set a country here, the actor automatically matches it to the country you selected above.",
"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
}
}
}
}
}
}
}
}
}
}
```