# Indeed Job Radar Actor (`vjkhush/indeed-job-radar-actor`) Actor Indeed crawler actor for normalized job listings. Private deployment. - **URL**: https://apify.com/vjkhush/indeed-job-radar-actor.md - **Developed by:** [Richard v](https://apify.com/vjkhush) (community) - **Categories:** AI, Jobs, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $5.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/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 Job Radar Scrape Indeed job listings across **60+ country markets** with full descriptions, qualifications, benefits, salary data, and employment type. No login or API key required. Fast two-phase architecture: lightweight HTTP requests scan listing pages, headless browser visits only detail pages. Listing-only mode finishes in seconds. ### Why use this actor? - **60+ countries** — US, UK, Germany, Canada, Australia, India, France, and 55 more Indeed domains - **Full job details** — descriptions, qualifications, benefits, and employment type from each job page - **Server-side filters** — job type, experience level, and posting date applied at the URL level before crawling, reducing blocks and wasted requests - **Client-side filters** — salary range, company name, company rating, remote/hybrid, and posting freshness - **Two speeds** — detail scraping ON for full data, or OFF for a fast title+URL scan - **Graceful timeout** — partial results always saved, even if the run hits the Apify timeout ### Output fields Each result includes: | Field | Example | |---|---| | `job_id` | `a1b2c3d4e5f6g7h8` | | `title` | `Software Engineer` | | `company` | `Google 4.3` | | `location` | `New York, NY` | | `salary` | `$120,000 - $160,000 a year` | | `employment_type` | `Full-time` | | `posted_at` | `2 days ago` | | `description` | Full job description (1,000 - 10,000+ chars) | | `qualifications` | Qualifications section from the job page | | `benefits` | Benefits section from the job page | | `url` | Direct Indeed job URL | | `source` | `indeed` | | `scraped_at` | ISO timestamp | Turn off **Scrape job details** to skip the detail page visit. You get titles, companies, salaries, and URLs much faster but without full descriptions. ### How to use #### Quick search with full details ```json { "keywords": ["Software Engineer"], "locations": ["New York"], "country": "US", "maximumItems": 5, "scrapeDetails": true } ```` #### Multi-keyword job monitoring ```json { "keywords": [ "cyber security", "information security", "soc analyst", "security engineer" ], "locations": ["Germany"], "country": "DE", "publicationAge": "LAST_3_DAYS", "jobType": "fulltime", "maximumItems": 200, "maxListingPages": 20 } ``` #### Fast listing scan (no detail pages) ```json { "keywords": ["Data Analyst"], "locations": ["London"], "country": "GB", "maximumItems": 100, "scrapeDetails": false, "publicationAge": "LAST_7_DAYS", "experienceLevel": "entry_level" } ``` ### Filters #### Server-side (applied via URL parameters) | Filter | Options | |---|---| | **Job type** | Full-time, Part-time, Contract, Temporary, Internship | | **Experience level** | Entry, Mid, Senior | | **Posting freshness** | Today, 24h, 3 days, 7 days, 14 days, 30 days | #### Client-side (applied after parsing) | Filter | Description | |---|---| | **Salary range** | Min/max salary parsed from listing text | | **Company name** | Substring match | | **Company rating** | Minimum star rating | | **Remote-first** | Keeps only remote/hybrid listings | | **Include no-salary jobs** | Toggle to exclude listings without salary | ### Supported markets 60+ Indeed country domains including: US, GB, CA, AU, IN, DE, FR, NL, IE, SG, AE, AR, AT, BH, BE, BR, CH, CL, CN, CO, CR, CZ, DK, EC, EG, ES, FI, GR, HK, HU, ID, IL, IT, JP, KR, KW, LU, MA, MX, MY, NG, NO, NZ, OM, PA, PE, PH, PK, PL, PT, QA, RO, SA, SE, TH, TR, TW, UA, UY, VE, VN, ZA The proxy country automatically matches your selected market for best results. ### Performance | Mode | Speed | Data | |---|---|---| | **Detail scraping ON** (default) | ~2-3 min for 50 jobs | Full descriptions, qualifications, benefits | | **Detail scraping OFF** | ~10-20 sec for 100 jobs | Titles, companies, salaries, URLs only | Use **Job type** and **Experience level** filters to reduce crawl volume at the server level. The actor gracefully stops before the Apify timeout, so partial results are always saved even on large runs. ### Integrations - **n8n / Make / Zapier** — schedule runs and push results to Google Sheets, Airtable, or databases - **Telegram / Slack / Discord** — send alerts for new job postings matching your criteria - **Google Sheets / Airtable** — export structured data for tracking and analysis - **Custom APIs** — use webhooks to trigger downstream workflows on each run ### How it works The actor uses a two-phase crawl: 1. **Listing phase (CheerioCrawler)** — fast HTTP-only requests parse search result pages. No browser overhead, minimal detection risk. 2. **Detail phase (PlaywrightCrawler)** — headless browser visits each job page to extract the full description, qualifications, benefits, and employment type from JavaScript-rendered content. This hybrid approach keeps listing scans fast while still extracting complete job data when needed. # Actor input Schema ## `country` (type: `string`): Choose the Indeed site to search. 60+ countries supported. ## `keywords` (type: `array`): Add one or more role/skill keywords. ## `keyword` (type: `string`): Optional fallback keyword. Comma-separated values are also supported. ## `locations` (type: `array`): City, region, or country names. ## `location` (type: `string`): Optional fallback location. Comma-separated values are supported. ## `scrapeDetails` (type: `boolean`): Visit each job page to get the full description, qualifications, benefits, and employment type. Slower but much more data. ## `jobType` (type: `string`): Filter by employment type (server-side Indeed filter). ## `experienceLevel` (type: `string`): Filter by experience level (server-side Indeed filter). ## `publicationAge` (type: `string`): Filter by posting recency. Applied both as a URL parameter (server-side) and as a client-side check. ## `maximumItems` (type: `integer`): Maximum number of jobs to output. ## `radius` (type: `integer`): Search radius around location. ## `companyName` (type: `string`): Optional company name filter. ## `remoteWork` (type: `boolean`): Keep only jobs that look remote/hybrid. ## `includeNoSalaryJobs` (type: `boolean`): Enable to keep listings without salary text. ## `minimumSalary` (type: `integer`): Minimum salary filter (best effort from listing text). ## `maximumSalary` (type: `integer`): Maximum salary filter. ## `minimumRating` (type: `number`): Minimum company rating found in listing text. ## `maxListingPages` (type: `integer`): Maximum listing pages to crawl per keyword+location combo. Each page has ~15 results. ## `maxConcurrency` (type: `integer`): Crawler concurrency. ## `maxRequestRetries` (type: `integer`): Retries per request before failing. ## `minListingDelayMs` (type: `integer`): Minimum pause before parsing list pages. ## `maxListingDelayMs` (type: `integer`): Maximum pause before parsing list pages. ## `proxyConfiguration` (type: `object`): Proxy setup. Residential proxies recommended for stability. ## Actor input object example ```json { "country": "US", "keywords": [ "Software Engineer" ], "keyword": "", "locations": [], "location": "", "scrapeDetails": true, "jobType": "", "experienceLevel": "", "publicationAge": "ALL", "maximumItems": 50, "radius": 30, "companyName": "", "remoteWork": false, "includeNoSalaryJobs": true, "minimumSalary": 0, "maximumSalary": 0, "minimumRating": 0, "maxListingPages": 5, "maxConcurrency": 1, "maxRequestRetries": 3, "minListingDelayMs": 700, "maxListingDelayMs": 2200 } ``` # Actor output Schema ## `jobListings` (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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("vjkhush/indeed-job-radar-actor").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 = {} # Run the Actor and wait for it to finish run = client.actor("vjkhush/indeed-job-radar-actor").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 '{}' | apify call vjkhush/indeed-job-radar-actor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=vjkhush/indeed-job-radar-actor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Indeed Job Radar Actor", "description": "Indeed crawler actor for normalized job listings. Private deployment.", "version": "0.1", "x-build-id": "SpkDXIifrbzmE5dCW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vjkhush~indeed-job-radar-actor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vjkhush-indeed-job-radar-actor", "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/vjkhush~indeed-job-radar-actor/runs": { "post": { "operationId": "runs-sync-vjkhush-indeed-job-radar-actor", "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/vjkhush~indeed-job-radar-actor/run-sync": { "post": { "operationId": "run-sync-vjkhush-indeed-job-radar-actor", "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": [ "maximumItems" ], "properties": { "country": { "title": "Market", "enum": [ "US", "GB", "CA", "AU", "IN", "DE", "FR", "NL", "IE", "SG", "AE", "AR", "AT", "BH", "BE", "BR", "CH", "CL", "CN", "CO", "CR", "CZ", "DK", "EC", "EG", "ES", "FI", "GR", "HK", "HU", "ID", "IL", "IT", "JP", "KR", "KW", "LU", "MA", "MX", "MY", "NG", "NO", "NZ", "OM", "PA", "PE", "PH", "PK", "PL", "PT", "QA", "RO", "SA", "SE", "TH", "TR", "TW", "UA", "UY", "VE", "VN", "ZA" ], "type": "string", "description": "Choose the Indeed site to search. 60+ countries supported.", "default": "US" }, "keywords": { "title": "Keywords (multi)", "type": "array", "description": "Add one or more role/skill keywords.", "default": [ "Software Engineer" ], "items": { "type": "string" } }, "keyword": { "title": "Single keyword (optional)", "type": "string", "description": "Optional fallback keyword. Comma-separated values are also supported.", "default": "" }, "locations": { "title": "Locations (multi)", "type": "array", "description": "City, region, or country names.", "default": [], "items": { "type": "string" } }, "location": { "title": "Single location (optional)", "type": "string", "description": "Optional fallback location. Comma-separated values are supported.", "default": "" }, "scrapeDetails": { "title": "Scrape job details", "type": "boolean", "description": "Visit each job page to get the full description, qualifications, benefits, and employment type. Slower but much more data.", "default": true }, "jobType": { "title": "Job type", "enum": [ "", "fulltime", "parttime", "contract", "temporary", "internship" ], "type": "string", "description": "Filter by employment type (server-side Indeed filter).", "default": "" }, "experienceLevel": { "title": "Experience level", "enum": [ "", "entry_level", "mid_level", "senior_level" ], "type": "string", "description": "Filter by experience level (server-side Indeed filter).", "default": "" }, "publicationAge": { "title": "Posting freshness", "enum": [ "ALL", "TODAY", "LAST_24_HOURS", "LAST_3_DAYS", "LAST_7_DAYS", "LAST_14_DAYS", "LAST_30_DAYS" ], "type": "string", "description": "Filter by posting recency. Applied both as a URL parameter (server-side) and as a client-side check.", "default": "ALL" }, "maximumItems": { "title": "Target results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of jobs to output.", "default": 50 }, "radius": { "title": "Radius (km)", "minimum": 0, "maximum": 300, "type": "integer", "description": "Search radius around location.", "default": 30 }, "companyName": { "title": "Company contains", "type": "string", "description": "Optional company name filter.", "default": "" }, "remoteWork": { "title": "Remote-first only", "type": "boolean", "description": "Keep only jobs that look remote/hybrid.", "default": false }, "includeNoSalaryJobs": { "title": "Include jobs without salary", "type": "boolean", "description": "Enable to keep listings without salary text.", "default": true }, "minimumSalary": { "title": "Salary floor", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Minimum salary filter (best effort from listing text).", "default": 0 }, "maximumSalary": { "title": "Salary ceiling", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Maximum salary filter.", "default": 0 }, "minimumRating": { "title": "Minimum company rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Minimum company rating found in listing text.", "default": 0 }, "maxListingPages": { "title": "Listing page cap", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum listing pages to crawl per keyword+location combo. Each page has ~15 results.", "default": 5 }, "maxConcurrency": { "title": "Parallel pages", "minimum": 1, "maximum": 20, "type": "integer", "description": "Crawler concurrency.", "default": 1 }, "maxRequestRetries": { "title": "Retry budget", "minimum": 1, "maximum": 10, "type": "integer", "description": "Retries per request before failing.", "default": 3 }, "minListingDelayMs": { "title": "Min page pause (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Minimum pause before parsing list pages.", "default": 700 }, "maxListingDelayMs": { "title": "Max page pause (ms)", "minimum": 0, "maximum": 20000, "type": "integer", "description": "Maximum pause before parsing list pages.", "default": 2200 }, "proxyConfiguration": { "title": "Proxy mode", "type": "object", "description": "Proxy setup. Residential proxies recommended for stability." } } }, "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 } } } } } } } } } } ```