# Indeed Jobs Scraper (`aurenic/indeed-scraper`) Actor

Extract job listings from Indeed across 14 country domains. Titles, companies, salaries, locations, benefits, and apply URLs. HTTP-only with residential proxy rotation.

- **URL**: https://apify.com/aurenic/indeed-scraper.md
- **Developed by:** [Aurenic](https://apify.com/aurenic) (community)
- **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. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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 Jobs Scraper

Extract job listings from Indeed across 14 country domains. Titles, companies, salaries, locations, benefits, and apply URLs. HTTP-only with residential proxy rotation.

### What does Indeed Jobs Scraper do?

Scrape Indeed job listings by keyword and location across 14 country domains:

- **United States** (indeed.com), **United Kingdom** (uk.indeed.com), **Canada**, **Australia**, **Germany**, **France**, **India**, **Brazil**, **Mexico**, **Spain**, **Italy**, **Netherlands**, **Japan**, **Singapore**

For every job: title, company name + rating, location, remote flag, salary range (parsed to min/max/type), job type, experience level, benefits, description snippet, posted date, and a direct apply URL.

**Data comes from the JSON blob that Indeed embeds in every search results page** — `window.mosaic.providerData["mosaic-provider-jobcards"]`. No HTML card parsing, no browser.

### Output fields

| Field | Description |
|---|---|
| jobKey | Indeed job key |
| title | Job title |
| company | Company name |
| companyRating | Company rating (0–5) |
| companyReviewCount | Number of company reviews |
| location | Job location |
| remote | Remote job flag |
| salaryMin / salaryMax | Parsed salary range |
| salaryType | `hourly` / `yearly` / `monthly` / `weekly` / `daily` |
| salaryText | Raw salary string |
| jobType | Full-time, Part-time, Contract, etc. |
| experienceLevel | Entry / Mid / Senior level |
| descriptionSnippet | Job description snippet (first 3,000 chars) |
| benefits | Semicolon-separated benefits list |
| attributes | Additional job attributes |
| sponsored | Sponsored listing flag |
| urgentlyHiring | Urgent hiring flag |
| easilyApply | Easy-apply flag |
| postedAt | Posting date |
| url | Direct view-job URL |

### Who is it for?

- **Recruiters** sourcing candidates and benchmarking salaries across markets
- **Job board aggregators** building multi-country job feeds
- **Market researchers** analyzing hiring trends by role, city, and industry
- **HR tech platforms** powering salary benchmarking and job-matching engines
- **Sales teams** identifying companies that are actively hiring (buying signal)
- **Career coaches** tracking openings for clients across regions

### Pricing

**$2.00 per 1,000 results.** No subscription.

| Results | Cost |
|---|---|
| 100 | $0.20 |
| 1,000 | $2.00 |
| 10,000 | $20.00 |

### How to use it

1. Enter **Search Queries** (job titles or keywords).
2. Enter **Locations** (cities, states, ZIP codes) or leave empty for nationwide.
3. Pick the **Country** domain.
4. Optionally set **Remote Only**, **Job Type**, and **Experience Level** filters.
5. Set **Max Items** (default 200) and **Max Pages per Query** (default 5).
6. Click **Start**.

### Output example

```json
{
  "recordType": "job",
  "jobKey": "a1b2c3d4e5f67890",
  "title": "Senior Software Engineer",
  "company": "Stripe",
  "companyRating": 4.2,
  "companyReviewCount": 1284,
  "location": "San Francisco, CA 94103",
  "remote": false,
  "salaryMin": 180000,
  "salaryMax": 250000,
  "salaryType": "yearly",
  "salaryText": "$180,000 - $250,000 a year",
  "jobType": "Full-time",
  "experienceLevel": "Senior level",
  "descriptionSnippet": "We are looking for a Senior Software Engineer to join the Payments Infrastructure team...",
  "benefits": "Health insurance; 401(k); Paid time off",
  "attributes": "Health insurance; Dental insurance",
  "sponsored": false,
  "urgentlyHiring": true,
  "easilyApply": false,
  "postedAt": "2026-09-19T00:00:00.000Z",
  "url": "https://www.indeed.com/viewjob?jk=a1b2c3d4e5f67890",
  "query": "software engineer",
  "searchLocation": "San Francisco, CA",
  "country": "us",
  "source": "indeed-mosaic",
  "scrapedAt": "2026-09-22T12:00:00.000Z"
}
```

### Technical details

- **HTTP-only** — uses `got-scraping` (TLS impersonation) to fetch search pages. No browser overhead.
- **Residential proxy rotation** — Indeed's Cloudflare rules block datacenter IPs based on reputation. The actor rotates residential proxy sessions on 403 and retries up to 5 times per URL.
- **JSON extraction** — Indeed embeds job cards as JSON in `window.mosaic.providerData["mosaic-provider-jobcards"]`. The actor parses that blob directly instead of scraping HTML cards.
- **14 country domains** — US, UK, CA, AU, DE, FR, IN, BR, MX, ES, IT, NL, JP, SG.
- **Parsed salary** — Indeed's raw salary string is parsed to numeric min/max plus a type (hourly, yearly, etc.).
- **Self-throttled** at 2.5–4 s between pages to keep Cloudflare's reputation scoring stable.

### Known limits

- **Residential proxy is required.** Indeed blocks datacenter IPs aggressively. Per-request success rates on Apify residential proxies are around 25–40% in the US, which is why the actor retries up to 5 times per page. Runs are slower than non-protected targets.
- **10 jobs per page** — Indeed shows 10 results per page by default. Pagination goes deeper with `&start=10`, `&start=20`, etc.
- **Description is a snippet, not full text** — full job descriptions require fetching each `/viewjob` page. Planned for a future release.
- **No CAPTCHA solving** — the actor relies on proxy rotation. If Indeed escalates to a hard challenge, the page will return no JSON and the actor will log the failure.
- **Salary data is not always present** — many employers do not disclose salary. Those records have `salaryMin: null`.

### FAQ

**Do I need an API key?** No. Indeed has no public jobs API for third parties.

**Do I need a proxy?** Yes — residential proxy is pre-configured and required. Datacenter IPs are blocked within a few requests.

**Why is the run slow?** Indeed's Cloudflare rules block ~60–75% of residential requests on the first try. Each page takes up to 5 retries with 3–10 s backoff. Budget ~30–60 s per page.

**Can I filter by salary?** Not directly in the input, but `salaryMin`/`salaryMax` are parsed so you can filter downstream.

**How do I export data?** After a run, go to Storage → Export as JSON, CSV, Excel.

### Support

Open an issue on the Actor's page for bugs or feature requests.

# Actor input Schema

## `searchQueries` (type: `array`):

Job titles or keywords (e.g. 'software engineer', 'registered nurse').

## `locations` (type: `array`):

Cities, states, or ZIP codes. Leave empty for nationwide.

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

Indeed country domain.

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

Hard cap on jobs per run.

## `maxPagesPerQuery` (type: `integer`):

Maximum pages to paginate per query. 10 jobs per page.

## `includeJobDetails` (type: `boolean`):

Reserved — full description extraction is on the roadmap.

## `remoteOnly` (type: `boolean`):

Filter to remote jobs.

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

Filter by job type.

## `experienceLevel` (type: `string`):

Filter by experience level.

## Actor input object example

```json
{
  "searchQueries": [
    "software engineer"
  ],
  "locations": [
    "Remote"
  ],
  "country": "us",
  "maxItems": 200,
  "maxPagesPerQuery": 5,
  "includeJobDetails": false,
  "remoteOnly": false,
  "jobType": "",
  "experienceLevel": ""
}
```

# Actor output Schema

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

No description

# 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 = {
    "searchQueries": [
        "software engineer"
    ],
    "locations": [
        "Remote"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("aurenic/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 = {
    "searchQueries": ["software engineer"],
    "locations": ["Remote"],
}

# Run the Actor and wait for it to finish
run = client.actor("aurenic/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 '{
  "searchQueries": [
    "software engineer"
  ],
  "locations": [
    "Remote"
  ]
}' |
apify call aurenic/indeed-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,aurenic/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/MBDPXROAXgAThw8fJ/builds/xIeN41MJQxH9M5oOI/openapi.json