# SmartRecruiters Jobs Scraper & API (`memo23/smartrecruiters-scraper`) Actor Scrape every open job from any company on SmartRecruiters. Give a company ID and get each role with full description, location, department, employment type and apply URL β€” via the public Posting API. Filter by title, location, remote. Handles huge boards. No proxy. JSON or CSV. - **URL**: https://apify.com/memo23/smartrecruiters-scraper.md - **Developed by:** [Muhamed Didovic](https://apify.com/memo23) (community) - **Categories:** Jobs, AI, Agents - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.90 / 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 ## SmartRecruiters Jobs Scraper 🧭 Scrape **every open job from any company hosted on [SmartRecruiters](https://www.smartrecruiters.com/)** (smartrecruiters.com) β€” title, full description, location, department, and apply URL β€” straight from SmartRecruiters's public Posting API. List + per-job detail gives the complete posting, including very large boards. No login, no anti-bot, no browser. ![How SmartRecruiters Jobs Scraper works](https://raw.githubusercontent.com/muhamed-didovic/muhamed-didovic.github.io/main/assets/how-it-works-smartrecruiters.png) --- ### Why use this scraper - **Handles huge boards. SmartRecruiters powers enterprise careers sites with thousands of roles β€” pagination and per-job detail are handled for you, capped to your maxItems.** - **Full job detail, not just titles.** Each row carries the entire job: `descriptionHtml` + plain text, location(s), employment type, workplace type, and the apply URL. - **Fast and cheap.** No proxies required (the API has no anti-bot), so runs are quick and your cost stays low. - **Normalized schema.** Output uses a consistent ATS schema shared with our other ATS scrapers (Ashby, Lever, SmartRecruiters, Personio, BambooHR) β€” write one parser, reuse it across every ATS. - **Built-in filters.** Narrow by title, location, department, employment type, remote, or posted date β€” applied before a row is emitted, so you only pay for matches. --- ### Overview [SmartRecruiters](https://www.smartrecruiters.com/) is a widely-used recruiting platform. Large enterprises host their careers on SmartRecruiters at `https://careers.smartrecruiters.com/{CompanyId}`. This actor reads each company's jobs through SmartRecruiters's public Posting API and emits one clean, normalized row per open job. --- ### Supported inputs | Input type | Example | Notes | |---|---|---| | **Company ID** | `BoschGroup`, `Equinox`, `Visa` | CASE-SENSITIVE (BoschGroup, not bosch) | | **Careers URL** | `https://careers.smartrecruiters.com/BoschGroup` | The company ID is extracted | Provide them in **Start URLs** and/or **Organization slugs**. Mix as many companies as you like in one run. > **Where's the Company ID?** It's the segment after `smartrecruiters.com/` in the careers URL, and it is **case-sensitive**. --- ### Use cases - **Job boards & aggregators** β€” ingest fresh, structured roles from many companies. - **Recruiting & sourcing tools** β€” track who's hiring for what. - **Market & talent intelligence** β€” hiring velocity, remote-vs-onsite mix. - **Lead generation** β€” companies actively hiring are buying signals for many B2B products. - **Personal job search** β€” pull every role across your target companies into one sheet. --- ### How it works 1. **Resolve** each input to a SmartRecruiters company ID. 2. **Paginate** `api.smartrecruiters.com/v1/companies/{id}/postings` (100/page). 3. **Fetch each job's detail** (`/postings/{id}`) for the full description β€” capped to `maxItems`, and skipped entirely when `includeDescription` is off. 4. **Normalize** to a common ATS schema and **push** one row per job. Companies are processed in parallel with a sliding-window concurrency cap. No proxy is needed; you can supply one for IP rotation at very large scale. --- ### Input configuration | Field | Type | Default | Description | |---|---|---|---| | `startUrls` | array | – | SmartRecruiters company IDs or careers URLs (strings or {url} objects). | | `organizations` | array | – | Bare SmartRecruiters company IDs (case-sensitive), e.g. ["BoschGroup","Equinox"]. | | `maxItems` | integer | `5000` | Max job rows emitted across the whole run. | | `maxConcurrency` | integer | `10` | How many companies to fetch in parallel. | | `titleKeyword` | string | – | Keep only jobs whose title contains this. | | `location` | string | – | Keep only jobs whose location contains this. | | `department` | string | – | Keep only jobs whose department contains this. | | `employmentType` | string | – | Keep only this employment type. | | `remoteOnly` | boolean | `false` | Keep only remote jobs. | | `postedAfter` | string | – | Keep only jobs published on/after this date (YYYY-MM-DD). | | `includeDescription` | boolean | `true` | Include `descriptionHtml` + `descriptionText`. **Off skips the per-job detail call entirely β€” much faster/cheaper for huge boards.** | | `includeRawJson` | boolean | `false` | Attach the original SmartRecruiters payload under `raw`. | | `proxy` | object | – | Optional. Not required (no anti-bot); use only for IP rotation at scale. | #### Example input ```json { "organizations": ["BoschGroup", "Equinox"], "maxItems": 500, "location": "remote" } ```` *** ### Output One row per open job. Example (trimmed): ```json { "ats": "smartrecruiters", "org": "BoschGroup", "company": "Bosch Group", "jobId": "744000132064189", "globalId": "smartrecruiters:BoschGroup:744000132064189", "title": "Purchasing Quality Engineer (Motor)", "department": null, "team": "Purchasing", "employmentType": "Full-time", "workplaceType": "OnSite", "isRemote": false, "location": "Shanghai, Shanghai, China", "locations": ["Shanghai, Shanghai, China"], "address": { "city": "Shanghai", "country": "China", "lat": 31.2, "long": 121.5 }, "descriptionHtml": "

Company Description

…", "descriptionText": "Company Description…", "publishedAt": "2026-06-14T06:00:53.734Z", "jobUrl": "https://jobs.smartrecruiters.com/BoschGroup/744000132064189", "applyUrl": "https://jobs.smartrecruiters.com/BoschGroup/744000132064189", "scrapedAt": "2026-06-14T18:20:00.000Z" } ``` #### Key output fields | Field | Description | |---|---| | `ats` | Always `"smartrecruiters"` β€” the source platform. | | `org` | Company board identifier. | | `company` | Company display name. | | `globalId` | Stable, unique key `ats:org:jobId` β€” use it to dedupe across runs. | | `title` | Job title. | | `department` / `team` | Org grouping as set by the company. | | `employmentType` | Full-time / Part-time / Intern / Contract / Temporary (as the ATS reports it). | | `workplaceType` / `isRemote` | Remote / Hybrid / OnSite + a boolean remote flag. | | `location` / `locations` | Primary location + every listed location. | | `descriptionHtml` / `descriptionText` | Full job description as HTML and plain text. | | `publishedAt` | When the role was published (ISO). | | `jobUrl` / `applyUrl` | Public posting URL + application URL. | *** ### FAQ **Do I need a proxy?** No. SmartRecruiters's Posting API is public with no anti-bot. The proxy field is available only for optional IP rotation at very large scale. **Why two requests per job?** The SmartRecruiters list endpoint returns summaries only; the full description lives on each posting's detail endpoint. We fetch detail only up to `maxItems`, and not at all when `includeDescription` is off β€” keeping big-board runs fast and cheap. **Can it discover every company on SmartRecruiters?** No β€” SmartRecruiters has no public directory of all boards (true for every ATS scraper). You supply the companies you care about. **How many jobs per company?** Whatever they have open β€” use `maxItems` to cap total output and control cost. **How fresh is the data?** Live β€” every run hits SmartRecruiters in real time. *** ### Support Found a bug or need a field added? Open an issue on the actor's **Issues** tab in the Apify Console. *** ### Additional services Need a different ATS or job board? We also build scrapers for Ashby, Greenhouse, Workday, Indeed, LinkedIn, Glassdoor, and many more. Check our Apify Store profile. *** ### Explore more scrapers - **Ashby / Greenhouse / Lever Jobs Scrapers** β€” open roles from those ATS platforms. - **Workday Jobs Scraper** β€” jobs from any Workday career site. - **Indeed / LinkedIn / Glassdoor** β€” the major job boards, fast and structured. *** ### ⚠️ Disclaimer This actor collects only **publicly available** job-posting data exposed by SmartRecruiters's own public Posting API. It does not access private, authenticated, or personal data, and does not bypass any access control. You are responsible for using the scraped data in compliance with SmartRecruiters's terms, the source companies' terms, and all applicable laws (including GDPR/CCPA). Use the data ethically and lawfully. *** ### SEO Keywords SmartRecruiters scraper, SmartRecruiters jobs scraper, smartrecruiters.com scraper, SmartRecruiters Posting API, SmartRecruiters ATS scraper, scrape SmartRecruiters jobs, careers.smartrecruiters.com scraper, ATS job scraper, enterprise jobs scraper, job postings API, company careers scraper, hiring data, recruiting data. # Actor input Schema ## `startUrls` (type: `array`): SmartRecruiters careers URLs (e.g. https://careers.smartrecruiters.com/BoschGroup) or company IDs. CASE-SENSITIVE (BoschGroup, not bosch). ## `organizations` (type: `array`): SmartRecruiters company IDs (CASE-SENSITIVE), e.g. \["BoschGroup", "Equinox"]. Find it in the careers URL after smartrecruiters.com/. Merged with any Start URLs above. ## `maxItems` (type: `integer`): Hard cap on job rows emitted across the whole run (across all companies). Use it to control billing β€” large boards like OpenAI have 700+ open roles. ## `maxConcurrency` (type: `integer`): How many company boards to fetch in parallel. ## `titleKeyword` (type: `string`): Keep only jobs whose title contains this text (case-insensitive), e.g. "engineer". ## `location` (type: `string`): Keep only jobs whose location (primary or secondary) contains this text, e.g. "remote", "London", "New York". ## `department` (type: `string`): Keep only jobs whose department contains this text, e.g. "Engineering". ## `employmentType` (type: `string`): Keep only jobs with this exact employment type. ## `remoteOnly` (type: `boolean`): Keep only jobs flagged remote. ## `postedAfter` (type: `string`): Keep only jobs published on or after this date (YYYY-MM-DD). Ideal for scheduled monitoring runs that only want fresh roles. ## `includeDescription` (type: `boolean`): Include `descriptionHtml` and `descriptionText` on each row. Turn off for leaner, cheaper rows when you only need title/location/compensation/links. ## `includeRawJson` (type: `boolean`): Attach the original, unmodified SmartRecruiters job object to each row under a `raw` field. Useful for advanced fields not in the normalized schema. Off by default to keep rows lean. ## `enrichEmails` (type: `boolean`): If enabled, tries to find a contact email for the company by discovering its website (Clearbit) and reading its contact/about pages. Adds contactEmail + contactWebsite columns plus a detailed emailEnrichment object. Best-effort. ## `proxy` (type: `object`): Optional. SmartRecruiters' public API has no anti-bot, so a proxy is NOT required. Only enable it if you want IP rotation when scraping very large numbers of companies. ## Actor input object example ```json { "startUrls": [ "BoschGroup" ], "organizations": [ "BoschGroup", "Equinox" ], "maxItems": 5000, "maxConcurrency": 10, "remoteOnly": false, "includeDescription": true, "includeRawJson": false, "enrichEmails": false } ``` # 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 = { "startUrls": [ "BoschGroup" ], "organizations": [ "BoschGroup", "Equinox" ] }; // Run the Actor and wait for it to finish const run = await client.actor("memo23/smartrecruiters-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 = { "startUrls": ["BoschGroup"], "organizations": [ "BoschGroup", "Equinox", ], } # Run the Actor and wait for it to finish run = client.actor("memo23/smartrecruiters-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 '{ "startUrls": [ "BoschGroup" ], "organizations": [ "BoschGroup", "Equinox" ] }' | apify call memo23/smartrecruiters-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=memo23/smartrecruiters-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SmartRecruiters Jobs Scraper & API", "description": "Scrape every open job from any company on SmartRecruiters. Give a company ID and get each role with full description, location, department, employment type and apply URL β€” via the public Posting API. Filter by title, location, remote. Handles huge boards. No proxy. JSON or CSV.", "version": "0.0", "x-build-id": "7c5KSsAM6OkviGjkI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~smartrecruiters-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-smartrecruiters-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/memo23~smartrecruiters-scraper/runs": { "post": { "operationId": "runs-sync-memo23-smartrecruiters-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/memo23~smartrecruiters-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-smartrecruiters-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", "properties": { "startUrls": { "title": "SmartRecruiters company IDs / careers URLs", "type": "array", "description": "SmartRecruiters careers URLs (e.g. https://careers.smartrecruiters.com/BoschGroup) or company IDs. CASE-SENSITIVE (BoschGroup, not bosch).", "items": { "type": "string" } }, "organizations": { "title": "Organization slugs", "type": "array", "description": "SmartRecruiters company IDs (CASE-SENSITIVE), e.g. [\"BoschGroup\", \"Equinox\"]. Find it in the careers URL after smartrecruiters.com/. Merged with any Start URLs above.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum jobs to scrape", "minimum": 1, "type": "integer", "description": "Hard cap on job rows emitted across the whole run (across all companies). Use it to control billing β€” large boards like OpenAI have 700+ open roles.", "default": 5000 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "type": "integer", "description": "How many company boards to fetch in parallel.", "default": 10 }, "titleKeyword": { "title": "Title contains", "type": "string", "description": "Keep only jobs whose title contains this text (case-insensitive), e.g. \"engineer\"." }, "location": { "title": "Location contains", "type": "string", "description": "Keep only jobs whose location (primary or secondary) contains this text, e.g. \"remote\", \"London\", \"New York\"." }, "department": { "title": "Department contains", "type": "string", "description": "Keep only jobs whose department contains this text, e.g. \"Engineering\"." }, "employmentType": { "title": "Employment type", "enum": [ "Full-time", "Part-time", "Intern", "Contract", "Temporary" ], "type": "string", "description": "Keep only jobs with this exact employment type." }, "remoteOnly": { "title": "Remote only", "type": "boolean", "description": "Keep only jobs flagged remote.", "default": false }, "postedAfter": { "title": "Posted on/after", "type": "string", "description": "Keep only jobs published on or after this date (YYYY-MM-DD). Ideal for scheduled monitoring runs that only want fresh roles." }, "includeDescription": { "title": "Include full job description", "type": "boolean", "description": "Include `descriptionHtml` and `descriptionText` on each row. Turn off for leaner, cheaper rows when you only need title/location/compensation/links.", "default": true }, "includeRawJson": { "title": "Include raw SmartRecruiters payload", "type": "boolean", "description": "Attach the original, unmodified SmartRecruiters job object to each row under a `raw` field. Useful for advanced fields not in the normalized schema. Off by default to keep rows lean.", "default": false }, "enrichEmails": { "title": "Enrich with company contact emails (experimental)", "type": "boolean", "description": "If enabled, tries to find a contact email for the company by discovering its website (Clearbit) and reading its contact/about pages. Adds contactEmail + contactWebsite columns plus a detailed emailEnrichment object. Best-effort.", "default": false }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Optional. SmartRecruiters' public API has no anti-bot, so a proxy is NOT required. Only enable it if you want IP rotation when scraping very large numbers of companies." } } }, "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 } } } } } } } } } } ```