# Multi Job Board Scraper — LinkedIn, Indeed, Glassdoor & More (`openclawai/job-board-scraper`) Actor Scrape job listings from LinkedIn, Indeed, Glassdoor, Google Jobs & ZipRecruiter simultaneously. Extract job title, company, salary, location, job type, description, company info & more. Powered by JobSpy (16k+ stars). No API keys needed — pay per result. - **URL**: https://apify.com/openclawai/job-board-scraper.md - **Developed by:** [Pika Choo](https://apify.com/openclawai) (community) - **Categories:** Jobs, Lead generation - **Stats:** 9 total users, 4 monthly users, 98.1% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 job scrapeds This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ## Multi Job Board Scraper Scrape job listings from **LinkedIn, Indeed, Glassdoor, Google Jobs, ZipRecruiter, Bayt, BDJobs, and Naukri** simultaneously with a single search. ### Features - **8 job boards in one run** — LinkedIn, Indeed, Glassdoor, Google Jobs, ZipRecruiter, Bayt, BDJobs, Naukri - **Rich data** — title, company, location, salary, job type, seniority, industry, description - **Advanced filters** — remote only, job type, hours posted, distance, easy apply, LinkedIn company targeting - **Flexible output** — markdown or HTML descriptions, annual salary normalization - **Proxy support** — residential proxies recommended for LinkedIn ### Input #### Required Parameters | Field | Type | Description | |-------|------|-------------| | `searchTerm` | string | Job title or keyword to search for | #### Search & Location | Field | Type | Default | Description | |-------|------|---------|-------------| | `location` | string | - | City, state, or country (e.g. "New York", "London", "Remote") | | `distance` | integer | 50 | Search radius in miles | | `sites` | array | All sites | Which job boards to scrape: linkedin, indeed, glassdoor, google, zip_recruiter, bayt, bdjobs, naukri | | `countryIndeed` | string | usa | Country for Indeed/Glassdoor (usa, uk, canada, australia, germany, france, india, etc.) | | `googleSearchTerm` | string | - | Custom search term for Google Jobs only (copy from Google Jobs UI for best results) | #### Filters | Field | Type | Default | Description | |-------|------|---------|-------------| | `maxResults` | integer | 20 | Max results per site (1-100) | | `isRemote` | boolean | false | Only return remote job listings | | `jobType` | string | - | Filter by type: fulltime, parttime, contract, internship, temporary | | `hoursOld` | integer | - | Only jobs posted within N hours (e.g. 24 = last day, 168 = last week) | | `easyApply` | boolean | false | Only jobs hosted directly on job boards (quick apply) | | `offset` | integer | - | Skip first N results (useful for pagination) | #### LinkedIn-Specific | Field | Type | Default | Description | |-------|------|---------|-------------| | `linkedinFetchDescription` | boolean | false | Retrieve full job descriptions and direct URLs (increases requests) | | `linkedinCompanyIds` | array | - | Search jobs from specific LinkedIn company IDs only | #### Output Options | Field | Type | Default | Description | |-------|------|---------|-------------| | `descriptionFormat` | string | markdown | Job description format: markdown or html | | `enforceAnnualSalary` | boolean | false | Convert all wages to yearly equivalents | ### Output Each item contains: - `title`, `company`, `location` - `job_url`, `job_url_direct` - `site` — which job board it came from - `salary_min`, `salary_max`, `salary_currency`, `salary_interval` - `job_type`, `is_remote`, `date_posted` - `job_level`, `job_function`, `company_industry`, `company_num_employees` - `description` — full job description in markdown or HTML - `emails`, `skills` — extracted from job description - `company_rating`, `company_revenue`, `company_logo` ### Pricing Charged per job scraped: **$0.003/job** ### Important Notes #### API Limitations - **LinkedIn**: Cannot combine `hoursOld` with `easyApply` in the same search - **Indeed**: Cannot combine `hoursOld` with `jobType` or `isRemote` or `easyApply` in the same search #### Site-Specific Notes - **LinkedIn** is rate-limited around ~100 results per IP. Use residential proxies for large runs. - **Indeed** is the most reliable scraper with no rate limiting. - **Google Jobs** works best with a specific `googleSearchTerm` copied from the Google Jobs browser UI. - **ZipRecruiter** is US/Canada only. - **Bayt** is optimized for Middle East job searches and currently only uses the search term parameter. - **BDJobs** is for Bangladesh job market. - **Naukri** is for India job market. ### Examples #### Basic Search ```json { "searchTerm": "software engineer", "location": "New York" } ```` #### Remote Full-time Jobs Posted in Last 24 Hours ```json { "searchTerm": "data analyst", "isRemote": true, "jobType": "fulltime", "hoursOld": 24, "sites": ["indeed", "google", "zip_recruiter"] } ``` #### LinkedIn Company-Specific Search ```json { "searchTerm": "product manager", "location": "San Francisco", "sites": ["linkedin"], "linkedinCompanyIds": ["1441", "2382910"], "linkedinFetchDescription": true } ``` # Actor input Schema ## `searchTerm` (type: `string`): Job title, keyword, or skill to search for (e.g. 'software engineer', 'data analyst', 'python developer') ## `location` (type: `string`): City, state, or country to search in (e.g. 'New York', 'London', 'Remote'). Leave empty to search globally. ## `sites` (type: `array`): Which job boards to scrape. Supported values: linkedin, indeed, glassdoor, google, zip\_recruiter, bayt, bdjobs, naukri ## `maxResults` (type: `integer`): Maximum number of job listings to scrape per job board ## `isRemote` (type: `boolean`): If enabled, only return remote job listings ## `jobType` (type: `string`): Filter by employment type ## `hoursOld` (type: `integer`): Only return jobs posted within the last N hours (e.g. 24 = last day, 168 = last week). Leave empty for all. ## `countryIndeed` (type: `string`): Country for Indeed and Glassdoor searches (e.g. usa, uk, canada, australia, germany, france) ## `googleSearchTerm` (type: `string`): Custom search term for Google Jobs only. For best results, search on Google Jobs in your browser, apply filters, then copy the exact search query. Leave empty to use the main Search Term. ## `distance` (type: `integer`): Search radius in miles from the specified location ## `offset` (type: `integer`): Skip the first N results (useful for pagination). For example, offset=25 starts from the 25th result. ## `easyApply` (type: `boolean`): Only return jobs that can be applied to directly on the job board (quick apply). Note: Cannot be combined with hoursOld on LinkedIn or Indeed. ## `linkedinFetchDescription` (type: `boolean`): Retrieve full job descriptions and direct URLs from LinkedIn (increases API requests) ## `linkedinCompanyIds` (type: `array`): Search jobs from specific LinkedIn company IDs only (e.g. \["1441", "2382910"]). Leave empty to search all companies. ## `descriptionFormat` (type: `string`): Format for job descriptions ## `enforceAnnualSalary` (type: `boolean`): Convert all wages to yearly equivalents (e.g. hourly/monthly wages converted to annual) ## `proxyConfiguration` (type: `object`): Proxy settings. Residential proxies are recommended for LinkedIn to avoid rate limiting. ## Actor input object example ```json { "searchTerm": "software engineer", "location": "New York, NY", "sites": [ "linkedin", "indeed", "glassdoor", "google", "zip_recruiter" ], "maxResults": 20, "isRemote": false, "jobType": "", "countryIndeed": "usa", "googleSearchTerm": "software engineer jobs near New York, NY since last week", "distance": 50, "easyApply": false, "linkedinFetchDescription": false, "descriptionFormat": "markdown", "enforceAnnualSalary": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 '' 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("openclawai/job-board-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 = {} # Run the Actor and wait for it to finish run = client.actor("openclawai/job-board-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 '{}' | apify call openclawai/job-board-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=openclawai/job-board-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Multi Job Board Scraper — LinkedIn, Indeed, Glassdoor & More", "description": "Scrape job listings from LinkedIn, Indeed, Glassdoor, Google Jobs & ZipRecruiter simultaneously. Extract job title, company, salary, location, job type, description, company info & more. Powered by JobSpy (16k+ stars). No API keys needed — pay per result.", "version": "1.0", "x-build-id": "QCHg1Fvd4voU5sBFW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/openclawai~job-board-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-openclawai-job-board-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/openclawai~job-board-scraper/runs": { "post": { "operationId": "runs-sync-openclawai-job-board-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/openclawai~job-board-scraper/run-sync": { "post": { "operationId": "run-sync-openclawai-job-board-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": [ "searchTerm" ], "properties": { "searchTerm": { "title": "Search Term", "type": "string", "description": "Job title, keyword, or skill to search for (e.g. 'software engineer', 'data analyst', 'python developer')" }, "location": { "title": "Location", "type": "string", "description": "City, state, or country to search in (e.g. 'New York', 'London', 'Remote'). Leave empty to search globally." }, "sites": { "title": "Job Boards", "type": "array", "description": "Which job boards to scrape. Supported values: linkedin, indeed, glassdoor, google, zip_recruiter, bayt, bdjobs, naukri", "items": { "type": "string" }, "default": [ "linkedin", "indeed", "glassdoor", "google", "zip_recruiter" ] }, "maxResults": { "title": "Max Results Per Site", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of job listings to scrape per job board", "default": 20 }, "isRemote": { "title": "Remote Only", "type": "boolean", "description": "If enabled, only return remote job listings", "default": false }, "jobType": { "title": "Job Type", "enum": [ "", "fulltime", "parttime", "contract", "internship", "temporary" ], "type": "string", "description": "Filter by employment type", "default": "" }, "hoursOld": { "title": "Posted Within (hours)", "minimum": 1, "maximum": 8760, "type": "integer", "description": "Only return jobs posted within the last N hours (e.g. 24 = last day, 168 = last week). Leave empty for all." }, "countryIndeed": { "title": "Country (Indeed & Glassdoor)", "type": "string", "description": "Country for Indeed and Glassdoor searches (e.g. usa, uk, canada, australia, germany, france)", "default": "usa" }, "googleSearchTerm": { "title": "Google Jobs Search Term", "type": "string", "description": "Custom search term for Google Jobs only. For best results, search on Google Jobs in your browser, apply filters, then copy the exact search query. Leave empty to use the main Search Term." }, "distance": { "title": "Search Distance (miles)", "minimum": 0, "maximum": 200, "type": "integer", "description": "Search radius in miles from the specified location", "default": 50 }, "offset": { "title": "Results Offset", "minimum": 0, "type": "integer", "description": "Skip the first N results (useful for pagination). For example, offset=25 starts from the 25th result." }, "easyApply": { "title": "Easy Apply Only", "type": "boolean", "description": "Only return jobs that can be applied to directly on the job board (quick apply). Note: Cannot be combined with hoursOld on LinkedIn or Indeed.", "default": false }, "linkedinFetchDescription": { "title": "LinkedIn: Fetch Full Descriptions", "type": "boolean", "description": "Retrieve full job descriptions and direct URLs from LinkedIn (increases API requests)", "default": false }, "linkedinCompanyIds": { "title": "LinkedIn: Company IDs", "type": "array", "description": "Search jobs from specific LinkedIn company IDs only (e.g. [\"1441\", \"2382910\"]). Leave empty to search all companies.", "items": { "type": "string" } }, "descriptionFormat": { "title": "Description Format", "enum": [ "markdown", "html" ], "type": "string", "description": "Format for job descriptions", "default": "markdown" }, "enforceAnnualSalary": { "title": "Convert to Annual Salary", "type": "boolean", "description": "Convert all wages to yearly equivalents (e.g. hourly/monthly wages converted to annual)", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies are recommended for LinkedIn to avoid rate limiting.", "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 } } } } } } } } } } ```