# SmartRecruiters Jobs Scraper (FreshActors) (`freshactors/smartrecruiters-jobs-scraper`) Actor Reliable, always-fresh job postings from any SmartRecruiters company board. Public Posting API, no login, full descriptions. Monitored daily. By FreshActors. - **URL**: https://apify.com/freshactors/smartrecruiters-jobs-scraper.md - **Developed by:** [Martin Čech](https://apify.com/freshactors) (community) - **Categories:** Jobs, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $20.00 / 1,000 company jobs fetcheds 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 — Every Company Board as Clean JSON (No API Key) Scrape **SmartRecruiters ATS job postings** from any company's public board into clean, structured JSON — title, full description, location, department, function, employment type, remote/hybrid flag, and apply URL. No account, no login, no API key. Point it at a list of SmartRecruiters companies and get a normalized jobs feed back. ![SmartRecruiters Jobs Scraper — normalized job postings with full descriptions](https://raw.githubusercontent.com/Freshactors/freshactors-assets/main/smartrecruiters-screenshot.png) > ✅ **Last verified working: 2026-06-02.** Monitored by an automated daily canary. When SmartRecruiters changes its Posting API, we patch fast and log it in the changelog below — so your hiring-data pipeline doesn't silently break. --- ### Why this SmartRecruiters scraper SmartRecruiters powers thousands of enterprise career sites (Visa, Bosch, and more), and every one exposes a **public Posting API** — no key, no login, no browser. The catch is the usual one: it's a two-tier API (a list endpoint for metadata, a detail endpoint for the full description), and the moment the response shape shifts, a naive scraper silently returns nothing. This actor is built to **stay working**: - **One normalized schema** — the same stable job record as our [Greenhouse & Lever](https://apify.com/freshactors/greenhouse-lever-jobs-scraper) and [Workable](https://apify.com/freshactors/workable-jobs-scraper) scrapers, so SmartRecruiters companies slot into the exact same pipeline with no special-casing. - **Full descriptions, handled for you** — we paginate the list and enrich each posting with the detail endpoint's `jobAd` sections (company description + job description + qualifications + additional info), cleaned to plain text. - **A fast, list-only mode** — set `includeDescription: false` and you get full metadata + the posting URL in a single request per page, no per-posting detail calls. - **Per-company isolation + retries** — a dead, renamed, or private board is skipped and logged; it never crashes the run. Transient errors retry with backoff. - **Stable, versioned output** (`_schemaVersion`) + a **daily canary** — that "last verified working" date is real. ### What data you get Each row is one normalized job posting. Fields SmartRecruiters doesn't provide come back as `null`, never missing, so your downstream schema stays predictable. | Field | Type | Description | |---|---|---| | `_type` | string | Always `job`. | | `_schemaVersion` | string | Output schema version. | | `_source` | string | Always `smartrecruiters`. | | `company` | string | Company identifier. | | `jobId` | string | SmartRecruiters posting ID. | | `title` | string | Job title. | | `department` | string \| null | Department. | | `team` | string \| null | Function (e.g. "Information Technology"). | | `location` | string \| null | Full location string. | | `allLocations` | string[] \| null | Listed location(s). | | `workplaceType` | string \| null | `remote` / `hybrid` where flagged. | | `commitment` | string \| null | Employment type (Full-time, …). | | `country` | string \| null | 2-letter country code. | | `url` | string | Public posting URL. | | `applyUrl` | string \| null | Direct apply URL. | | `postedAt` | string \| null | Release date (ISO). | | `descriptionText` | string \| null | Full description text (when `includeDescription` is on). | | `_scrapedAt` | string | ISO timestamp this record was fetched. | ### Use cases - **Sales intelligence / hiring-signal tracking.** Which enterprises are hiring for which roles — a leading indicator of growth and budget. Feed `department`, `team`, `location`, `postedAt` into a lead-scoring/intent model. - **Recruiting & talent sourcing.** Aggregate live openings across target employers into one table; filter `workplaceType: remote` or `commitment` with no SmartRecruiters-specific adapter. - **Job boards & aggregators.** Need to *scrape SmartRecruiters jobs* into a uniform feed? Point it at your company list and ingest normalized records on a schedule. - **Labor-market & VC research.** `postedAt` gives a clean time series of when roles open across companies. ### Input | Field | Type | Required | Notes | |---|---|---|---| | `companies` | string[] | ✅ | SmartRecruiters identifiers (`visa`) or board URLs (`https://jobs.smartrecruiters.com/Visa`). One per row. | | `includeDescription` | boolean | — | Fetch the full description per posting (one extra request each). Default `true`. Turn off for a fast, list-only run (metadata + URL). | | `maxJobsPerCompany` | integer | — | Cap per company (1–5000). Default `1000`. | ```json { "companies": ["visa", "https://jobs.smartrecruiters.com/Bosch"], "includeDescription": true, "maxJobsPerCompany": 1000 } ```` ### Output sample ```json { "_type": "job", "_schemaVersion": "1.0", "_source": "smartrecruiters", "company": "visa", "jobId": "744000122509268", "title": "Sr. SW Engineer", "department": "Technology and Operations", "team": "Information Technology", "location": "Austin, TX, United States", "allLocations": ["Austin, TX, United States"], "workplaceType": "hybrid", "commitment": "Full-time", "country": "US", "url": "https://jobs.smartrecruiters.com/visa/744000122509268", "applyUrl": "https://jobs.smartrecruiters.com/visa/744000122509268?oga=true", "postedAt": "2026-04-23T16:54:54.835Z", "updatedAt": null, "descriptionText": "Company Description... Job Description... Qualifications...", "_scrapedAt": "2026-06-02T17:00:00.000Z" } ``` ### Use with AI agents (MCP) This scraper is callable as a tool by AI agents via the **[Apify MCP server](https://mcp.apify.com)** — so assistants like **Claude, Cursor, and VS Code** can run it and use the structured results mid-conversation, with no glue code. Simplest path: in a recent **Claude Desktop**, add the hosted server `https://mcp.apify.com` under **Settings → Connectors** and authorize with OAuth. For any config-file client: ```json { "mcpServers": { "apify": { "command": "npx", "args": ["-y", "@apify/actors-mcp-server"], "env": { "APIFY_TOKEN": "YOUR_APIFY_TOKEN" } } } } ``` Then ask in plain language, e.g. *"List the open jobs at Visa from its SmartRecruiters board with titles, locations, and apply links."* — the agent calls **`freshactors/smartrecruiters-jobs-scraper`** with the right input and reads back the JSON. Full setup: [Apify MCP docs](https://docs.apify.com/platform/integrations/mcp). ### Pricing Pay-per-event — **no subscription**. You pay only for the boards you fetch and the postings you receive: | Event | Price (USD) | When it fires | |---|---|---| | **Company jobs fetched** | **$0.02** | Once per company board successfully fetched (with ≥1 open job). | | **Job posting fetched** | **$0.0005** | Once per job posting returned. | **Worked example — "how much do 100 results cost?"** Scrape **5 companies** for **100 postings** total: - Boards: 5 × $0.02 = **$0.10** - Postings: 100 × $0.0005 = **$0.05** - **Total: $0.15** for 100 normalized jobs across 5 companies. (Apify platform usage is billed separately per their standard rates.) ### FAQ **Is scraping SmartRecruiters jobs legal?** This actor reads **public, non-personal** job-posting data from companies' own public SmartRecruiters boards — the same data their careers pages serve to any visitor. No login, no personal data. Use responsibly and in line with applicable terms and laws. **Do I need an API key?** No. There's no SmartRecruiters API key, account, or login — it reads the public Posting API. **How do I find a company's SmartRecruiters identifier?** It's the company segment in the careers URL — `jobs.smartrecruiters.com/**Visa**`. You can paste either the identifier or the full URL. **Does it include full job descriptions?** Yes — `includeDescription` defaults to `true`, fetching each posting's detail (company description, job description, qualifications, additional info) as clean text. Turn it off for a faster, list-only run with metadata + the posting URL. **Can I scrape many companies at once?** Yes — pass as many identifiers/URLs in `companies` as you need. Each board is fetched in isolation; a dead or private board is skipped, not fatal. Cap volume with `maxJobsPerCompany` (1–5000). **How often is the data updated?** It's live — every run fetches the companies' current public boards. The actor itself is monitored by a daily canary so parsing stays correct as the Posting API evolves. ### Other FreshActors tools | FreshActors actor | What it scrapes | |---|---| | [Greenhouse & Lever Jobs Scraper](https://apify.com/freshactors/greenhouse-lever-jobs-scraper) | Greenhouse + Lever — normalized job postings | | [Workable Jobs Scraper](https://apify.com/freshactors/workable-jobs-scraper) | Workable — normalized job postings, full descriptions | | [App Store Scraper](https://apify.com/freshactors/app-store-scraper) | Apple App Store — app details, search, reviews | | [Google Play Scraper](https://apify.com/freshactors/google-play-scraper) | Google Play — app details + reviews | | [Shopify App Store Scraper](https://apify.com/freshactors/shopify-app-store-scraper) | Shopify App Store — app details, reviews, discovery | | [Redfin Scraper](https://apify.com/freshactors/redfin-scraper) | Redfin — US real-estate listings | ### Reliability A scheduled **daily canary** scrapes a known SmartRecruiters board, validates the normalized schema, and alerts the moment a parse changes. When SmartRecruiters shifts its Posting API, we patch the same day and record it in the changelog below. Every record carries `_schemaVersion` and `_scrapedAt`. **Changelog** - **2026-06-02** — v1.0 launch. Per-company Posting API (paginated list + detail-endpoint description enrichment), normalized schema, list-only fast mode, per-company isolation, daily canary monitoring. **Legal note:** Reads public, non-personal job-posting data from companies' own public SmartRecruiters boards (the same data their careers pages serve). No login, no personal data. Use responsibly and in line with applicable terms and laws. *Found a problem? Open an issue on the actor — issues are answered fast.* # Actor input Schema ## `companies` (type: `array`): SmartRecruiters company identifiers (e.g. visa) or board URLs (e.g. https://jobs.smartrecruiters.com/Visa). One per row. The identifier is the company segment in the jobs.smartrecruiters.com URL. ## `includeDescription` (type: `boolean`): Fetch the full job description for each posting (one extra request per posting). Turn off for a faster, list-only run (metadata + URL, no description text). ## `maxJobsPerCompany` (type: `integer`): Cap on postings returned per company (1–5000). ## Actor input object example ```json { "companies": [ "visa" ], "includeDescription": true, "maxJobsPerCompany": 1000 } ``` # Actor output Schema ## `results` (type: `string`): Normalized job postings. # 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 = { "companies": [ "visa" ] }; // Run the Actor and wait for it to finish const run = await client.actor("freshactors/smartrecruiters-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 = { "companies": ["visa"] } # Run the Actor and wait for it to finish run = client.actor("freshactors/smartrecruiters-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 '{ "companies": [ "visa" ] }' | apify call freshactors/smartrecruiters-jobs-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=freshactors/smartrecruiters-jobs-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SmartRecruiters Jobs Scraper (FreshActors)", "description": "Reliable, always-fresh job postings from any SmartRecruiters company board. Public Posting API, no login, full descriptions. Monitored daily. By FreshActors.", "version": "1.0", "x-build-id": "QPG6mjmzNIymXFMbl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/freshactors~smartrecruiters-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-freshactors-smartrecruiters-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/freshactors~smartrecruiters-jobs-scraper/runs": { "post": { "operationId": "runs-sync-freshactors-smartrecruiters-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/freshactors~smartrecruiters-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-freshactors-smartrecruiters-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": [ "companies" ], "properties": { "companies": { "title": "Companies", "type": "array", "description": "SmartRecruiters company identifiers (e.g. visa) or board URLs (e.g. https://jobs.smartrecruiters.com/Visa). One per row. The identifier is the company segment in the jobs.smartrecruiters.com URL.", "items": { "type": "string" } }, "includeDescription": { "title": "Include full descriptions", "type": "boolean", "description": "Fetch the full job description for each posting (one extra request per posting). Turn off for a faster, list-only run (metadata + URL, no description text).", "default": true }, "maxJobsPerCompany": { "title": "Max jobs per company", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Cap on postings returned per company (1–5000).", "default": 1000 } } }, "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 } } } } } } } } } } ```