# SmartRecruiters Job Scraper — Visa, Tesla & McDonald's API (`bovi/smartrecruiters-job-scraper`) Actor Scrape job postings from any SmartRecruiters-powered company board via the public API. Get title, location, seniority, remote\_type, department, employment\_type, descriptions, and parse\_confidence. Multi-company batch, keyword filters, zero auth, zero proxy. - **URL**: https://apify.com/bovi/smartrecruiters-job-scraper.md - **Developed by:** [Vitalii Bondarev](https://apify.com/bovi) (community) - **Categories:** Jobs, Lead generation, AI - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.45 / 1,000 jobs This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 Job Scraper — Careers API For enterprise talent teams and job aggregators scraping Fortune 500 companies that use SmartRecruiters — Visa, Tesla, McDonald's, CEVA Logistics, and thousands more. **Pay per result — $1.50 / 1,000 jobs.** Official API. No proxy. No login. No browser. Batch mode for 100+ companies. Scrape job postings from any SmartRecruiters-powered company careers page. Returns structured job data — title, location, seniority, remote type, department, employment type, descriptions, and parse_confidence — via the official zero-auth SmartRecruiters public API. ### What you get | Field | Description | |---|---| | `title` | Job title | | `company` | Company slug used to fetch | | `location` | Full location string (city, region, country) | | `remote_type` | `remote` / `hybrid` / `onsite` / `null` (from API flags) | | `seniority` | Inferred: executive / vp / director / manager / principal / staff / lead / senior / entry / intern / mid | | `salary` | `null` — SmartRecruiters public API does not expose salary | | `department` | Department or function label | | `employment_type` | Full-time / Part-time / Contract / etc. | | `posted_at` | ISO-8601 release date | | `url` | Canonical job posting URL | | `apply_url` | Direct apply URL | | `job_id` | SmartRecruiters internal job ID | | `global_id` | Stable dedup key: `smartrecruiters::` | | `description_text` | Plain-text description (when `includeDescriptions=true`) | | `description_html` | HTML description — jobDescription + qualifications + additionalInformation sections | | `parse_confidence` | Float 0–1: data quality signal. 1.0 = all expected fields present | | `warnings` | List of machine-readable quality codes (empty when confidence=1.0) | | `scraped_at` | ISO-8601 scrape timestamp | ### Why this scraper - **Official API, zero proxy** — SmartRecruiters public API is open and stable; no browser automation, no residential proxy cost, no bans. - **Seniority enrichment** — 11-level title-regex classification with SmartRecruiters native `experienceLevel` as fallback. - **Authoritative remote_type** — reads the structured `location.remote` and `location.hybrid` boolean flags, not just text keywords. - **parse_confidence** — every record carries a data-quality score so you can filter or alert on drift without manual inspection. - **Batch + filter** — scrape 10, 100, or 1000 companies in one run with keyword and remote filters applied server-side. ### Input ```json { "companies": ["Visa", "TESLA", "McDonaldS"], "titleKeyword": "engineer", "locationKeyword": "Austin", "remoteOnly": false, "maxJobsPerCompany": 50, "includeDescriptions": false } ```` **Finding the slug**: the slug is the company identifier in the SmartRecruiters URL. For `jobs.smartrecruiters.com/Visa` the slug is `Visa`. Slugs are **case-sensitive** — use the exact casing from the URL. **`includeDescriptions`**: disabled by default because descriptions require one extra API call per job. Enable only when you need full text for AI/NLP pipelines. ### Pricing Pay-per-result: **$1.50 / 1,000 jobs** ($0.0015 per record). You pay only for jobs returned — nothing for companies that come back empty. **Worked example:** 3 companies × 50 jobs = 150 results = **$0.23**. 20 companies × 100 jobs = 2,000 results = **$3.00**. ### Output sample ```json { "title": "Senior Software Engineer", "company": "Visa", "location": "Austin, Texas, United States of America", "remote_type": null, "seniority": "senior", "department": "Engineering", "employment_type": "Full-time", "posted_at": "2026-05-01T00:00:00+00:00", "url": "https://jobs.smartrecruiters.com/Visa/12345678-senior-software-engineer", "job_id": "12345678", "global_id": "smartrecruiters:Visa:12345678", "parse_confidence": 1.0, "warnings": [] } ``` ### FAQ **Do I need an API key or proxy?** No. SmartRecruiters' public careers API is open — no auth, no proxy cost, no bans. **What output formats are available?** JSON, JSONL, CSV, and Excel via the Apify dataset export, plus the Apify REST API. **Can I schedule daily runs?** Yes — use Apify Scheduler. Use `global_id` (`smartrecruiters::`) as a stable key for deduplication across runs. **What if `includeDescriptions` is enabled and a job returns no description?** The actor still pushes the job — description fields are `null` and `parse_confidence` is slightly reduced. The run never crashes on missing optional data. ### Vs competitor comparison | Feature | This scraper | Typical SmartRecruiters scrapers | |---|---|---| | `parse_confidence` score | Yes | No | | Seniority enrichment (11 levels + native `experienceLevel` fallback) | Yes | Rarely | | Remote type from native API flags (not text parsing) | Yes | No | | Multi-company batch | Yes | Some | | Employment type field | Yes | Some | | Price | $1.50/1k | varies | `parse_confidence` (0.0–1.0) and `warnings` in every record — data quality signal so your pipeline detects schema drift before output breaks. **Note on `includeDescriptions`**: disabled by default because SmartRecruiters descriptions require one extra API call per job (unlike most ATS platforms where descriptions are inline). Enable only when you need full text for AI/NLP pipelines. ### Use with AI agents (MCP) This actor is MCP-compatible. Use it as a data source in n8n, Make, or any LLM agent pipeline. ``` https://mcp.apify.com/?tools=bovi/smartrecruiters-job-scraper ``` The flat schema with `global_id` (`smartrecruiters::`) is drop-in-ready for vector databases, job-matching LLMs, and automated sourcing workflows. Need Greenhouse, Lever, Ashby, Recruitee and Personio in the same pipeline? Use the flagship [Multi-ATS Job Scraper](https://apify.com/bovi/greenhouse-lever-ashby-job-scraper) — 6 ATS, one unified schema. ### Integrations Built for enterprise talent teams and job aggregators scraping Fortune 500 hiring pipelines at scale — the JSON/dataset output drops into the tools you already run, no glue code: - **n8n / Make / Zapier** — trigger a run or pipe every new dataset item into 500+ apps (Google Sheets, Airtable, Slack, HubSpot, your database) with no code: [n8n](https://docs.apify.com/platform/integrations/n8n), [Make](https://docs.apify.com/platform/integrations/make), [Zapier](https://docs.apify.com/platform/integrations/zapier). - **Webhooks** — fire your own endpoint the moment a run finishes, to push results straight into your pipeline ([docs](https://docs.apify.com/platform/integrations/webhooks)). - **MCP server** — expose this actor as a tool to Claude, Cursor, or any [MCP client](https://mcp.apify.com) so an AI agent can pull this data mid-conversation ([guide](https://blog.apify.com/how-to-use-mcp/)). - **API & SDKs** — fetch the dataset as JSON, CSV, or Excel through the Apify REST API or the Python / JS SDKs. See all [Apify integrations](https://apify.com/integrations). ### Not affiliated with SmartRecruiters This actor uses the publicly accessible SmartRecruiters careers API. It is not endorsed by or affiliated with SmartRecruiters Inc. # Actor input Schema ## `companies` (type: `array`): SmartRecruiters company slugs to scrape. The slug is the company identifier in the SmartRecruiters URL: jobs.smartrecruiters.com/. Examples: "Visa", "McDonaldS", "TESLA". SmartRecruiters slugs are case-sensitive — use the exact casing from the URL. ## `titleKeyword` (type: `string`): Keep only jobs whose title contains this text (case-insensitive). Example: "engineer". Leave blank to return all jobs. ## `locationKeyword` (type: `string`): Keep only jobs whose location contains this text (case-insensitive). Example: "Austin". Leave blank for all locations. ## `remoteOnly` (type: `boolean`): When enabled, only jobs detected as fully remote are returned (based on the location.remote flag from SmartRecruiters API). ## `maxJobsPerCompany` (type: `integer`): Cap on jobs pushed per company slug after filtering. Default 50 keeps trial runs cheap. Set to 0 for unlimited. ## `includeDescriptions` (type: `boolean`): Return full job description as plain text and HTML. SmartRecruiters requires one extra API call per job to fetch descriptions (detail endpoint). Disabled by default to keep runs fast and cheap. Enable only when you need full text for AI pipelines or keyword analysis. ## Actor input object example ```json { "companies": [ "Visa", "TESLA", "McDonaldS" ], "remoteOnly": false, "maxJobsPerCompany": 50, "includeDescriptions": false } ``` # Actor output Schema ## `results` (type: `string`): Dataset containing Smartrecruiters Job Scraper records (title, company, location, remote\_type, seniority, department, employment\_type, posted\_at, url, parse\_confidence, global\_id). # 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", "TESLA", "McDonaldS" ] }; // Run the Actor and wait for it to finish const run = await client.actor("bovi/smartrecruiters-job-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", "TESLA", "McDonaldS", ] } # Run the Actor and wait for it to finish run = client.actor("bovi/smartrecruiters-job-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", "TESLA", "McDonaldS" ] }' | apify call bovi/smartrecruiters-job-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=bovi/smartrecruiters-job-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SmartRecruiters Job Scraper — Visa, Tesla & McDonald's API", "description": "Scrape job postings from any SmartRecruiters-powered company board via the public API. Get title, location, seniority, remote_type, department, employment_type, descriptions, and parse_confidence. Multi-company batch, keyword filters, zero auth, zero proxy.", "version": "0.1", "x-build-id": "5LzCMY3mLaF1qO46o" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bovi~smartrecruiters-job-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bovi-smartrecruiters-job-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/bovi~smartrecruiters-job-scraper/runs": { "post": { "operationId": "runs-sync-bovi-smartrecruiters-job-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/bovi~smartrecruiters-job-scraper/run-sync": { "post": { "operationId": "run-sync-bovi-smartrecruiters-job-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": { "companies": { "title": "Company slugs", "type": "array", "description": "SmartRecruiters company slugs to scrape. The slug is the company identifier in the SmartRecruiters URL: jobs.smartrecruiters.com/. Examples: \"Visa\", \"McDonaldS\", \"TESLA\". SmartRecruiters slugs are case-sensitive — use the exact casing from the URL.", "items": { "type": "string" } }, "titleKeyword": { "title": "Title keyword filter", "type": "string", "description": "Keep only jobs whose title contains this text (case-insensitive). Example: \"engineer\". Leave blank to return all jobs." }, "locationKeyword": { "title": "Location keyword filter", "type": "string", "description": "Keep only jobs whose location contains this text (case-insensitive). Example: \"Austin\". Leave blank for all locations." }, "remoteOnly": { "title": "Remote only", "type": "boolean", "description": "When enabled, only jobs detected as fully remote are returned (based on the location.remote flag from SmartRecruiters API).", "default": false }, "maxJobsPerCompany": { "title": "Max jobs per company", "minimum": 0, "type": "integer", "description": "Cap on jobs pushed per company slug after filtering. Default 50 keeps trial runs cheap. Set to 0 for unlimited.", "default": 50 }, "includeDescriptions": { "title": "Include job descriptions", "type": "boolean", "description": "Return full job description as plain text and HTML. SmartRecruiters requires one extra API call per job to fetch descriptions (detail endpoint). Disabled by default to keep runs fast and cheap. Enable only when you need full text for AI pipelines or keyword analysis.", "default": false } } }, "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 } } } } } } } } } } ```