# Indeed Jobs Scraper — Search by Keyword (`apt_marble/indeed-jobs-scraper`) Actor
Extract job listings from Indeed using simple keyword-based search queries. Scrape thousands of Indeed jobs by keyword, job title, company name, or location and collect detailed job data in structured JSON format.
- **URL**: https://apify.com/apt\_marble/indeed-jobs-scraper.md
- **Developed by:** [Hamza](https://apify.com/apt_marble) (community)
- **Categories:** Jobs, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
$4.50 / 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/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 by Keyword
Discover Indeed job listings by keyword across any country / Indeed domain. Returns full job records — title, company, salary, location, description, apply link, logo, posting date, and more. Great for ATS pipelines, market salary research, recruitment intelligence, and competitive hiring analysis.
### What this Actor does
Given a search query (keyword + country + domain + optional location and filters), discovers all matching Indeed jobs and pushes one record per job to the default dataset.
### Input
Each Actor run executes one Indeed search.
| Field | Type | Required | Default | Description |
| ----------------- | ------ | -------- | ------------- | -------------------------------------------------------------------------------------------- |
| `keyword_search` | string | yes | — | Job title / keyword to search for, e.g. `"analyst"` or `"product manager"` |
| `country` | string | no | `"US"` | ISO country code (`"US"`, `"FR"`, `"GB"`, `"DE"`, etc.) |
| `domain` | string | no | `"indeed.com"`| Indeed domain to search on (`"indeed.com"`, `"fr.indeed.com"`, `"uk.indeed.com"`, …) |
| `location` | string | no | `""` | Free-form location string, e.g. `"New York, NY"` or `"Paris"`. Empty = entire country. |
| `date_posted` | enum | no | `""` | `""`, `"Last 24 hours"`, `"Last 3 days"`, `"Last 7 days"`, `"Last 14 days"` |
| `posted_by` | string | no | `""` | Filter by poster type (`"Employer"`, `"Staffing agency"`) |
| `location_radius` | string | no | `""` | Miles around the location (`"5"`, `"10"`, `"25"`, `"50"`, …) |
Example input:
```json
{
"keyword_search": "analyst",
"country": "US",
"domain": "indeed.com",
"location": "New York, NY",
"date_posted": "Last 24 hours",
"posted_by": "",
"location_radius": ""
}
````
To run multiple searches (e.g. US analyst + FR product manager), create a separate Apify task.
### Output
Each job item in the dataset includes every field the provider returns. Common fields you can expect:
```json
{
"jobid": "607180797caa2c30",
"company_name": "Metropolitan Transportation Authority",
"date_posted_parsed": "2026-05-16T08:17:50.341Z",
"job_title": "Operations Analyst – HR: Employment (NYCT)",
"description_text": "Description JOB TITLE: ...",
"benefits": [],
"location": "300 Cadman Plaza West, Brooklyn, NY 11201",
"salary_formatted": "$45,125 a year",
"company_rating": 4,
"company_reviews_count": 309,
"country": "US",
"date_posted": "1 day ago",
"region": "NY",
"company_link": "https://www.indeed.com/cmp/Metropolitan-Transportation-Authority-7?...",
"domain": "https://indeed.com",
"apply_link": "https://www.indeed.com/applystart?jk=607180797caa2c30&...",
"srcname": "www.indeed.com",
"url": "https://www.indeed.com/viewjob?jk=607180797caa2c30",
"is_expired": false,
"discovery_input": {
"country": "US",
"domain": "indeed.com",
"keyword_search": "analyst",
"location": "New York, NY",
"date_posted": "Last 24 hours",
"posted_by": "",
"location_radius": ""
},
"job_location": "300 Cadman Plaza West in Brooklyn, NY 11201",
"job_description_formatted": "",
"logo_url": "https://d2q79iu7y748jz.cloudfront.net/s/_squarelogo/256x256/80a263f4cedc4492e628479e5d010de6",
"shift_schedule": ["8 hour shift"],
"timestamp": "2026-05-17T15:12:02.308Z",
"input": { "url": "...", "discovery_input": { "..." } }
}
```
When a search finds no jobs, the actor emits an error row instead of a job row, e.g.:
```json
{ "error": "Jobs not been found", "error_code": "dead_page", "input": { ... }, "timestamp": "..." }
```
These warning rows are pushed to the dataset as-is so you can see exactly which queries came up empty.
### Limits & responsible use
- The Actor only returns information that is publicly visible on Indeed search results / job detail pages.
- Respect Indeed's Terms of Service, robots.txt expectations, and applicable employment-data privacy regulations.
# Actor input Schema
## `keyword_search` (type: `string`):
Job title or keyword to search for on Indeed, e.g. "analyst" or "product manager".
## `country` (type: `string`):
ISO country code for the search, e.g. US, FR, GB, DE.
## `domain` (type: `string`):
Indeed domain to search on, e.g. indeed.com, fr.indeed.com, uk.indeed.com.
## `location` (type: `string`):
Free-form location string as you would type it into Indeed, e.g. "New York, NY" or "Paris". Leave empty for the entire country.
## `date_posted` (type: `string`):
Filter by how recently the job was posted. Leave as "(any date)" for no filter.
## `posted_by` (type: `string`):
Filter by who posted the job. Leave empty for any. Common values: "Employer", "Staffing agency".
## `location_radius` (type: `string`):
Distance from the location. Leave empty for the default. Common values: 5, 10, 15, 25, 50, 100.
## Actor input object example
```json
{
"keyword_search": "analyst",
"country": "US",
"domain": "indeed.com",
"location": "New York, NY",
"date_posted": "",
"posted_by": "",
"location_radius": ""
}
```
# Actor output Schema
## `dataset` (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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"keyword_search": "analyst",
"country": "US",
"domain": "indeed.com",
"location": "New York, NY"
};
// Run the Actor and wait for it to finish
const run = await client.actor("apt_marble/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 = {
"keyword_search": "analyst",
"country": "US",
"domain": "indeed.com",
"location": "New York, NY",
}
# Run the Actor and wait for it to finish
run = client.actor("apt_marble/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 '{
"keyword_search": "analyst",
"country": "US",
"domain": "indeed.com",
"location": "New York, NY"
}' |
apify call apt_marble/indeed-jobs-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=apt_marble/indeed-jobs-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Indeed Jobs Scraper — Search by Keyword",
"description": "Extract job listings from Indeed using simple keyword-based search queries. Scrape thousands of Indeed jobs by keyword, job title, company name, or location and collect detailed job data in structured JSON format.",
"version": "0.0",
"x-build-id": "F7oeirskD0RFS94NN"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/apt_marble~indeed-jobs-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-apt_marble-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/apt_marble~indeed-jobs-scraper/runs": {
"post": {
"operationId": "runs-sync-apt_marble-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/apt_marble~indeed-jobs-scraper/run-sync": {
"post": {
"operationId": "run-sync-apt_marble-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": [
"keyword_search"
],
"properties": {
"keyword_search": {
"title": "Keyword",
"type": "string",
"description": "Job title or keyword to search for on Indeed, e.g. \"analyst\" or \"product manager\"."
},
"country": {
"title": "Country code",
"type": "string",
"description": "ISO country code for the search, e.g. US, FR, GB, DE.",
"default": "US"
},
"domain": {
"title": "Indeed domain",
"type": "string",
"description": "Indeed domain to search on, e.g. indeed.com, fr.indeed.com, uk.indeed.com.",
"default": "indeed.com"
},
"location": {
"title": "Location",
"type": "string",
"description": "Free-form location string as you would type it into Indeed, e.g. \"New York, NY\" or \"Paris\". Leave empty for the entire country.",
"default": ""
},
"date_posted": {
"title": "Date posted",
"enum": [
"",
"Last 24 hours",
"Last 3 days",
"Last 7 days",
"Last 14 days"
],
"type": "string",
"description": "Filter by how recently the job was posted. Leave as \"(any date)\" for no filter.",
"default": ""
},
"posted_by": {
"title": "Posted by",
"type": "string",
"description": "Filter by who posted the job. Leave empty for any. Common values: \"Employer\", \"Staffing agency\".",
"default": ""
},
"location_radius": {
"title": "Location radius (miles)",
"type": "string",
"description": "Distance from the location. Leave empty for the default. Common values: 5, 10, 15, 25, 50, 100.",
"default": ""
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```