# Indeed Scraper (`datahamster/indeed-scraper`) Actor

Indeed scraper: search Indeed jobs by keyword and location in 17 countries with radius, job type, remote and date posted filters. Get title, company, rating, location, salary min/max/period, job types, posted date and snippet; optional full description. Monitor mode returns only new jobs.

- **URL**: https://apify.com/datahamster/indeed-scraper.md
- **Developed by:** [Viktor Dubnytskiy](https://apify.com/datahamster) (community)
- **Categories:** Jobs
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.16 / 1,000 result items

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Indeed Scraper

Search Indeed jobs by keyword and location on 17 Indeed country sites and get one flat row per job: title, company, Indeed company rating, location, salary as text plus min, max, period and currency, job types, remote or hybrid, benefits, the exact posted time, sponsored flag and a short snippet. Turn on `includeDescription` for the full job text. No account and no cookies. Monitor mode turns the same search into an alert on new jobs.

**Try it:** the prefilled example returns 15 rows in about 6 seconds and costs about $0.005. Results cost $0.20 per 1,000.

Coverage: Indeed shows only the first page of a search (about 15 jobs) to a visitor who is not signed in; page 2 is a sign-in wall. To go deeper, set `maxResultsPerQuery` above 15 and the actor reads the same search split by Indeed's own filters (job type, remote, date posted, the other sort order) and merges the jobs without duplicates. Measured on 2026-11-05: `registered nurse` (US) and `software engineer` (US) gave 100 unique jobs each from 8 and 9 pages, `data analyst` in London 60 from 7 pages. Narrow searches end earlier, when the splits stop finding new jobs.

**Why this one** (compared with the three most-used Indeed actors in the Store, checked 2026-11-05):

- **Alerts on new jobs.** Monitor mode returns only jobs that were not there in the previous run and can post them to a webhook or Telegram. None of the three has a monitor mode or an alert target in its input. Measured: a baseline run recorded 15 `registered nurse` jobs in Houston and the next run returned only the 2 new ones.
- **Many keywords in one run, no duplicates.** `keywords` takes a list (repeats are dropped regardless of case); a job found by two keywords or two splits is one row and is charged once. The three others take one keyword per run (two of them accept a list of Indeed search URLs instead).
- **Indeed's own filters on every site.** Radius, job type, remote or hybrid, date posted and sort on all 17 country sites. The most-used Indeed actor offers only the date posted filter, and the third has no search filters.
- **Similar-job shelves off by default and never charged.** Indeed fills its page with sponsored "similar jobs" shelves on other topics: 23 of 38 cards on one 2026-11-05 test page (nurses and technicians in a python search). They are removed before anything is pushed. Sponsored jobs inside the real results are kept in scrape mode, flagged `sponsored: true`, with your filters applied to them too (Indeed ignores filters for ads); `includeSponsored: false` drops them, and monitor mode never returns them.
- **Exact posted time** (`postedAt`, ISO) next to Indeed's "3 days ago" text.
- **Price:** $0.20 per 1,000 jobs with no start fee. The most-used Indeed actor costs about $0.10 per 1,000 jobs plus a $0.001 start fee; this one adds monitor mode, filters and multi-keyword runs.

### What you get

Real rows from a 2026-11-05 run of the prefilled input (`keywords: ["python developer"]`, `location: "Austin, TX"`, 15 jobs):

| title / company | location | salary | type | remote | posted |
|---|---|---|---|---|---|
| Software Engineer / Visa Technology and Operations LLC (3.9) | Austin, TX 78759 | $86,500 - $158,100 a year | Full-time | | 2026-11-05 |
| Staff Software Engineer - BE Python / paypal (3.8) | Austin, TX | $160,500 - $262,350 a year | | hybrid | 2026-11-04 |
| Sr. Python AWS full stack Developer / Robotics Technologies | Austin, TX | $76 an hour | | | 2026-11-04 |
| Product Engineer / Expertshub.ai | Austin, TX | $200,000 - $260,000 a year | Full-time | | 2026-11-04 |
| Senior System Software Engineer - Networking / NVIDIA (4.2) | Austin, TX 78717 | $152,000 - $287,500 a year | Full-time | | 2026-11-03 |

One full row:

```json
{
  "id": "b9ffd20a5091c9a4",
  "url": "https://www.indeed.com/viewjob?jk=b9ffd20a5091c9a4",
  "scrapedAt": "2026-11-05T16:16:06.471930Z",
  "jobKey": "b9ffd20a5091c9a4",
  "title": "Software Engineer",
  "company": "Visa Technology and Operations LLC",
  "companyRating": 3.9,
  "companyReviewCount": 1207,
  "location": "Austin, TX 78759",
  "city": "Austin",
  "state": "TX",
  "postalCode": "78759",
  "countryCode": "US",
  "salaryText": "$86,500 - $158,100 a year",
  "salaryMin": 86500,
  "salaryMax": 158100,
  "salaryPeriod": "year",
  "salaryCurrency": "USD",
  "jobTypes": ["Full-time"],
  "remote": null,
  "isRemote": false,
  "benefits": ["Wellness program", "Health savings account", "Dental insurance", "401(k)", "Flexible spending account", "Vision insurance", "Life insurance", "Health insurance", "Paid time off"],
  "postedAt": "2026-11-05T02:45:54.308000Z",
  "postedText": "Just posted",
  "sponsored": false,
  "urgentlyHiring": false,
  "easyApply": true,
  "snippet": "- You will be tasked to quickly grasp and evaluate new ideas and technologies from both internal and external sources and match them appropriately with emerging…",
  "description": null,
  "detailsFetched": null,
  "query": "python developer",
  "searchLocation": "Austin, TX",
  "country": "us",
  "rank": 3
}
```

`id` is Indeed's job key, so a job found by two keywords or two splits is one row and monitor mode tracks it across runs. `salaryMin`/`salaryMax` are null when Indeed shows no salary or only one side ("From $100,000 a year" fills `salaryMin` only). `companyRating` is filled when the card shows a rating. `postedAt` is the time behind Indeed's "Just posted / 3 days ago"; a reposted ad gets a new time. With `includeDescription: true` every row also gets `description` (plain text) and `detailsFetched: true`; a row whose text Indeed did not return has `detailsFetched: false`.

### Use cases

- **Daily job alert.** One saved task per search (`"keywords": ["registered nurse"]`, `"location": "Houston, TX"`) in monitor mode, scheduled every morning. Each run returns only the jobs that were not there before.
- **Salary research.** Pull jobs for a role in several cities and compare the min, max and period Indeed extracted from each ad.
- **Hiring signal and lead lists.** See which companies are hiring for your niche, with their Indeed rating and review count on each row.

### Try it

Hit **Start**: the prefilled input searches `python developer` in Austin, TX, 15 jobs. Change the country to `uk`, `de`, `ca` or `au` and the location to a city there, add `jobType: "fulltime"`, `remote: "remote"` or `postedWithinDays: "3"`, raise `maxResultsPerQuery` to 60 for more jobs per keyword, and set `includeDescription: true` for the full text (200 jobs with full text took about 150 seconds in a test run).

**Monitor mode.** Save the input as a task and set:

```json
{
  "mode": "monitor",
  "monitorStateId": "rn-houston-daily",
  "keywords": ["registered nurse"],
  "location": "Houston, TX",
  "sort": "date",
  "maxResultsPerQuery": 15,
  "maxItems": 50,
  "webhookUrl": "https://your-endpoint.example.com/hook"
}
```

Put the task on a schedule (Apify, Schedules, cron `0 7 * * *` for daily).

- **How "new" is decided:** a job is new when its key is not in the task's history and its `postedAt` is no older than the last complete read of that search minus 48 hours. An older job the actor simply had not seen before is recorded and never returned or charged. Sponsored jobs are never returned in monitor mode.
- **The first run of a search is the baseline.** It records what it reads and returns nothing: you pay one monitor-check and no rows, and the run summary says `emptyReason: "baseline"`. A keyword added later, or a change of location, country, filters, sort or `maxResultsPerQuery`, starts a new baseline for that search.
- With `sort: "date"` (the default) page 1 holds the newest jobs, so a daily schedule with the default 15 per keyword catches what was posted since the last run on all but the busiest searches. For a busy search raise `maxResultsPerQuery` or schedule more often.

### Input

| Field | Meaning | Default |
|---|---|---|
| `keywords` | Keywords, one per line; each is a separate search | required |
| `location` | City, state, region or postal code; empty = whole country | empty |
| `country` | Indeed site: `us`, `uk`, `ca`, `au`, `de`, `fr`, `nl`, `it`, `es`, `ie`, `at`, `ch`, `pl`, `sg`, `mx`, `in`, `jp` | `us` |
| `radius` | `0` (exact), `5`, `10`, `15`, `25`, `35`, `50`, `100` (miles on US/UK, km elsewhere) | Indeed default |
| `jobType` | `fulltime`, `parttime`, `contract`, `temporary`, `permanent`, `internship`, `fixedterm` | any |
| `remote` | `remote` or `hybrid` | any |
| `postedWithinDays` | `1`, `3`, `7`, `14` | any |
| `sort` | `date` (newest first) or `relevance` | `date` |
| `maxResultsPerQuery` | Jobs per keyword; above 15 the search is split by Indeed's filters | `15` |
| `includeSponsored` | Keep sponsored jobs inside the results (flagged) | `true` |
| `includeDescription` | Add the full job text | `false` |
| `maxItems` | Stop the whole run after this many rows (monitor mode: new jobs), shared equally between keywords | `100` |
| `mode` | `scrape`, or `monitor` for new jobs only | `scrape` |
| `monitorStateId`, `webhookUrl`, `telegramBotToken`, `telegramChatId` | Monitor-mode state key and alert targets | empty |

### Pricing

| Event | Price |
|---|---|
| result | $0.0002 per job ($0.20 per 1,000) |
| monitor-check | $0.005 per monitor run |
| change | $0.0002 per new job in monitor mode |

Apify Store discounts: SILVER -10%, GOLD and higher -20% on every event.

You pay only for rows that are pushed. Off-topic sponsored shelves, Indeed's "related jobs" for a keyword with no match, and duplicates are never charged. A monitor run that is blocked before it reads anything charges no monitor-check. Apify platform usage (mostly residential proxy traffic, about 0.21 MB billed per Indeed page) is billed by Apify on top: about $0.13 to $0.33 per 1,000 jobs in the 2026-11-05 test runs, $0.002 for the example run.

**Found it useful?** A short review on the Store page helps other people find this actor. If a search misbehaves, open an issue on the actor page.

### Related actors

- [LinkedIn Jobs Scraper](https://apify.com/datahamster/linkedin-jobs-scraper) for the same roles on LinkedIn.
- [Glassdoor Jobs Scraper: Salary Estimates, Ratings, Monitor](https://apify.com/datahamster/glassdoor-jobs) for employer ratings next to the postings.
- [XING Jobs Scraper](https://apify.com/datahamster/xing-jobs-scraper) for jobs in Germany, Austria and Switzerland.
- [Career Site Jobs Monitor: Greenhouse, Lever, Ashby, Workday](https://apify.com/datahamster/ats-jobs) to watch a specific employer's own career site.

### Limits

- One page per search variant: Indeed does not show page 2 to visitors who are not signed in. `maxResultsPerQuery` above 15 reads up to 25 split variants per keyword and stops after 4 variants in a row without a new job, so very broad searches return a few hundred jobs per keyword at most. Use several keywords or locations for more.
- Indeed sometimes answers with a "Security Check" page; the actor retries on a fresh residential connection up to 4 times per page. A keyword refused every time is listed in `INDEED_STATS.walledQueries` and the run continues with the other keywords.
- Salary figures are what Indeed extracted from the ad; many ads have none.
- Job types and benefits are filled only when Indeed shows them on the card. `remote` is filled from Indeed's remote label.

### FAQ

**Do I need an Indeed account or cookies?** No. The actor reads the same public search page that Indeed shows to a visitor who is not signed in, through a residential connection in the site's country.

**Why did my keyword return nothing?** Indeed had no match for it with your filters (it then shows only "related jobs", which are not returned). The `RUN_SUMMARY` record in the run's key-value store has `emptyReason`, and `INDEED_STATS` lists `emptyQueries`, `walledQueries` and the reason each keyword stopped. In monitor mode the first run of a search is a baseline and returns nothing by design.

**Can I get the recruiter's name or contact details?** No. Rows hold job and company data only. E-mail addresses and phone numbers are removed from the title, snippet and description.

### Changelog

- 0.1: initial release with keyword and location search on 17 Indeed country sites, radius, job type, remote and date posted filters, sort, deeper reads through filter splits, sponsored handling, optional full description, and monitor mode for new jobs with a baseline first run.

# Actor input Schema

## `maxItems` (type: `integer`):

Stop the whole run after this many jobs (you are charged only for pushed jobs). Shared equally between keywords. Example: 15.

## `mode` (type: `string`):

scrape = full results; monitor = only new/changed items since the previous run of this task

## `monitorStateId` (type: `string`):

Optional state id when not running as a saved task (monitor mode)

## `webhookUrl` (type: `string`):

POST a change summary here in monitor mode

## `telegramBotToken` (type: `string`):

Optional: bot token for monitor-mode change summaries

## `telegramChatId` (type: `string`):

Optional: chat id that receives monitor-mode summaries

## `keywords` (type: `array`):

Job keywords, one per line, e.g. "python developer", "registered nurse", "data analyst". Each keyword is a separate Indeed search with the filters below.

## `location` (type: `string`):

City, state, region or postal code as you would type it on Indeed, e.g. "Austin, TX", "London", "Berlin", "Remote". Leave empty to search the whole country.

## `country` (type: `string`):

Which Indeed site to search. The actor connects through that country, so jobs, salaries and dates match what local visitors see. Example: uk.

## `radius` (type: `string`):

Distance around the location, in miles on the US and UK sites and kilometres elsewhere. Needs a location. Example: 25.

## `jobType` (type: `string`):

Keep only this job type (Indeed's own filter). Example: fulltime.

## `remote` (type: `string`):

Keep only remote or hybrid jobs (Indeed's own filter). Example: remote.

## `postedWithinDays` (type: `string`):

Keep only jobs posted in this window (Indeed's own filter). Example: 3.

## `sort` (type: `string`):

Indeed's order of results. Newest first suits alerts and daily pulls. Example: date.

## `maxResultsPerQuery` (type: `integer`):

Indeed shows one page (about 15 jobs) of each search to visitors who are not signed in. Above 15 the actor also reads the same search split by Indeed's own filters (job type, remote, date posted, other sort order) and merges the jobs without duplicates. Each extra split is one more page. Example: 60.

## `includeSponsored` (type: `boolean`):

true = keep Indeed's sponsored jobs that appear inside the results (flagged `sponsored: true`; your filters are applied to them too). Sponsored "similar jobs" shelves on other topics are never returned, and monitor mode never returns sponsored jobs. Example: true.

## `includeDescription` (type: `boolean`):

true = add the full job description as plain text (contacts removed). One extra request per 20 jobs. Example: false.

## Actor input object example

```json
{
  "maxItems": 15,
  "mode": "scrape",
  "keywords": [
    "python developer"
  ],
  "location": "Austin, TX",
  "country": "us",
  "radius": "",
  "jobType": "",
  "remote": "",
  "postedWithinDays": "",
  "sort": "date",
  "maxResultsPerQuery": 15,
  "includeSponsored": true,
  "includeDescription": false
}
```

# Actor output Schema

## `results` (type: `string`):

All pushed rows (dataset, JSON)

## `resultsTable` (type: `string`):

Dataset in the Console viewer

## `runSummary` (type: `string`):

RUN_SUMMARY record

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "maxItems": 15,
    "keywords": [
        "python developer"
    ],
    "location": "Austin, TX",
    "maxResultsPerQuery": 15
};

// Run the Actor and wait for it to finish
const run = await client.actor("datahamster/indeed-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "maxItems": 15,
    "keywords": ["python developer"],
    "location": "Austin, TX",
    "maxResultsPerQuery": 15,
}

# Run the Actor and wait for it to finish
run = client.actor("datahamster/indeed-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "maxItems": 15,
  "keywords": [
    "python developer"
  ],
  "location": "Austin, TX",
  "maxResultsPerQuery": 15
}' |
apify call datahamster/indeed-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,datahamster/indeed-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/XytGaZnZqbsC5215i/builds/lznvpIrUoABRhkOsG/openapi.json
