# ZipRecruiter Jobs Scraper (`sian.agency/ziprecruiter-jobs-scraper`) Actor Scrape ZipRecruiter job postings into clean structured data — search by keyword + location or paste a filtered search URL. Fast overview (titles + links) or full detail: company, location, salary band, employment type, posted/expiry dates, category, industry & description. Clean JSON/CSV, no code. - **URL**: https://apify.com/sian.agency/ziprecruiter-jobs-scraper.md - **Developed by:** [SIÁN OÜ](https://apify.com/sian.agency) (community) - **Categories:** Jobs, Business, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 overview job extracteds 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 ## ZipRecruiter Jobs Scraper — Salary, Company & Search Data 💼 [![SIÁN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Store-Jobs Search API](https://img.shields.io/badge/Store-Jobs%20Search%20API-1AE392)](https://apify.com/sian.agency/active-job-postings-scraper?fpr=sian) [![Store-Zillow Agent Scraper](https://img.shields.io/badge/Store-Zillow%20Agent%20Scraper-1F4E79)](https://apify.com/sian.agency/zillow-agent-scraper?fpr=sian) [![Store-Idealista Scraper](https://img.shields.io/badge/Store-Idealista%20Scraper-E60023)](https://apify.com/sian.agency/fastest-idealista-scarper?fpr=sian) #### 🎉 Turn any ZipRecruiter search into a clean, structured jobs dataset — salaries, companies & full descriptions included ##### Built for recruiters, talent researchers, job aggregators, and HR analytics teams --- ### 📋 Overview **Need ZipRecruiter job data without copy-pasting hundreds of listings?** This actor turns any keyword + location — or a pre-filtered search URL — into a clean dataset of job postings you can export to JSON, CSV, or Excel in minutes. **Why professionals choose us:** - ✅ **Real salary data**: Min/max salary, currency, and pay period straight from each posting - ⚡ **Two speeds**: Fast *overview* (titles + links) or rich *detail* (company, location, salary, dates, category, description) - 🎯 **Filter like a pro**: Carry radius, date-posted, salary floor, and employment-type filters through every page - 💰 **Pay only for what you extract**: Per-result pricing with a free tier — no monthly subscription - 💎 **Clean, typed fields**: 20+ structured fields per job, de-duplicated across pages - ✨ **No code, no account**: Paste a search, click Start, download your dataset --- ### ✨ Features - 🔍 **Keyword + location search**: `software engineer` in `Austin, TX`, or any role nationwide - 🚀 **Paste-a-URL mode**: Drop in a filtered ZipRecruiter search URL and every filter is preserved - 💵 **Salary intelligence**: Salary min/max, unit (hourly/yearly), and currency for benchmarking - 🏢 **Company & location**: Hiring organization, city, state, and country for every job - 📅 **Freshness signals**: Posted date and expiry date to find the newest openings - 🗂️ **Classification**: Employment type, occupational category, and industry - 📝 **Full descriptions**: Complete job description text in detail mode - 🔁 **Auto de-duplication**: One clean row per job across all search pages - 📄 **Run report**: A built-in HTML summary of every run --- ### 🚀 Getting Started (3 Simple Steps) #### Step 1: Enter your search Type a **job title** (e.g. `registered nurse`) and an optional **location** (`Austin, TX` or a ZIP). Or paste one or more filtered ZipRecruiter search URLs under *Advanced*. #### Step 2: Pick a mode Choose **Overview** for a fast list of titles + links, or **Detail** for the full record (salary, company, description, dates). #### Step 3: Run & download Click **Start**. When the run finishes, export your jobs as JSON, CSV, or Excel — or pull them via the API. --- ### 📥 Input | Field | Description | |---|---| | **Search keywords** | Job title / keywords to search for | | **Location** | City + state (`Austin, TX`) or a ZIP code | | **Scrape mode** | `overview` (titles + links) or `detail` (full record) | | **Max results** | How many jobs to return (FREE: 25, PAID: unlimited) | | **Search URLs** | Paste filtered ZipRecruiter search URLs (advanced) | | **Radius / Posted within / Min salary / Employment type** | Optional filters | --- ### 📤 Output Each job is one structured row: | Field | Description | |---|---| | `title` | Job title | | `company` | Hiring company | | `location` / `city` / `region` / `country` | Where the job is | | `salary_min` / `salary_max` / `salary_unit` / `currency` | Compensation band | | `employment_type` | Full-time, part-time, contract, … | | `occupational_category` / `industry` | Role classification | | `posted_at` / `valid_through` | Posted & expiry dates | | `direct_apply` / `experience` | Apply flag & experience requirement | | `description` | Full job description (detail mode) | | `url` / `id` | Direct link & stable job id | ```json { "id": "3b0ec9847eac7786", "title": "Software Test Engineer - AI Trainer", "company": "DataAnnotation", "location": "Austin, TX", "city": "Austin", "region": "TX", "country": "US", "salary_min": 40, "salary_max": 100, "salary_unit": "HOUR", "currency": "USD", "employment_type": "FULL_TIME", "posted_at": "2026-06-20", "url": "https://www.ziprecruiter.com/c/DataAnnotation/Job/...?jid=3b0ec9847eac7786" } ```` *** ### 💡 Use Cases - **Salary benchmarking** — compare pay bands across roles, cities, and industries - **Recruiting & sourcing** — build target lists of live openings by role and geography - **Job aggregators & boards** — feed fresh postings into your own product - **Labor-market research** — track hiring trends, employment types, and demand - **Lead generation** — find companies actively hiring in your niche *** ### 💰 Pricing This actor uses **pay-per-event** pricing — you only pay for the jobs you actually extract, with a **free tier** to try it out. No monthly subscription. See the live pricing on the actor's Apify page. *** ### ❓ FAQ **Q: Do I need a ZipRecruiter account or API key?** A: No. Just enter a search and click Start. **Q: Can I use my own filtered search?** A: Yes — run the search on the site, then paste the resulting URL into *Search URLs*. Radius, date, salary, and employment-type filters are carried through. **Q: What's the difference between Overview and Detail?** A: Overview is fast and cheap (title + link per job). Detail fetches each job's full record — company, salary, dates, category, and description. **Q: Is this legal?** A: It only returns publicly available job postings. See the legal note below. *** ### 🐛 Troubleshooting **No jobs returned** - Broaden the keyword or location, or remove restrictive filters. - Confirm the location format (`City, ST` or a ZIP). **Fewer results than expected** - FREE runs are capped at 25 jobs. Upgrade for unlimited. - Some searches simply have few live postings. *** ### ⚖️ Is it legal to scrape data? Our actors are ethical and do not extract private user data. They only return job postings that employers have chosen to publish publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, your results could contain personal data (for example, a hiring-manager name or email an employer published in a posting). Personal data is protected by the **GDPR** in the European Union and by other regulations worldwide. You should not process personal data unless you have a legitimate reason to do so. If you're unsure, consult your lawyers. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). > **Note on data sources:** This is an independent tool and is **not affiliated with, endorsed by, or sponsored by ZipRecruiter**. "ZipRecruiter" and all related names and trademarks belong to their respective owners; their use here is descriptive only. The actor returns only publicly available job-posting data. *** ### ✨ More by SIÁN Agency - [Jobs Search API — Indeed, LinkedIn & Glassdoor](https://apify.com/sian.agency/active-job-postings-scraper?fpr=sian) - [Zillow Agent Scraper — Licenses & Contacts](https://apify.com/sian.agency/zillow-agent-scraper?fpr=sian) - [Smart Idealista Scraper — Property Data](https://apify.com/sian.agency/fastest-idealista-scarper?fpr=sian) - [Browse all SIÁN actors →](https://apify.com/sian.agency?fpr=sian) ⭐ **Love this actor?** Leave a [5-star review](https://apify.com/sian.agency/ziprecruiter-jobs-scraper/reviews) — it helps us build more features for you. # Actor input Schema ## `search` (type: `string`): 🔍 **JOB TITLE / KEYWORDS:** What you're hiring for or researching, e.g. `software engineer`, `registered nurse`, `truck driver`. 💡 **TIP:** Combine with a **Location** below for a targeted local search. Leave Location empty for a nationwide search. Use this OR paste full **Search URLs** below — at least one is required. ## `location` (type: `string`): 📍 **LOCATION:** City + state (`Austin, TX`) or a ZIP code (`78701`). Leave empty for a nationwide search. ## `scrapeMode` (type: `string`): ⚙️ **OVERVIEW vs DETAIL:** - **Overview** — fast & cheap. Job title + direct link for every result (≈20 per search page). Best for building a list of openings. - **Detail** — full record per job: company, location, salary band, employment type, posted/expiry dates, category, industry & full description. 💡 Start with **Overview** to scope a search, then run **Detail** on the slice you want. ## `maxResults` (type: `integer`): 🔢 **HOW MANY JOBS TO RETURN.** - **FREE users:** up to 25 jobs per run - **PAID users:** unlimited Results are de-duplicated across search pages. ## `startUrls` (type: `array`): 🚀 **PASTE FILTERED SEARCH URLs:** Run a search on ziprecruiter.com with the exact filters you want (radius, date posted, salary floor, employment type, remote), then paste the resulting `/jobs-search?...` URL(s) here. Every allowlisted filter is carried through pagination automatically. 💡 **TIP:** Use this for precise filtering the simple keyword/location fields don't cover. You can mix multiple URLs. 📋 **BULK EDIT:** Click "Bulk edit" to paste URLs (one per line). ## `radius` (type: `integer`): 📏 Search radius in miles around the **Location** (ZipRecruiter default is 25). ## `days` (type: `integer`): 📅 Only jobs posted within the last N days (e.g. `1`, `5`, `7`). ## `refine_by_salary` (type: `integer`): 💰 Minimum annual salary floor (e.g. `60000`). Only jobs at or above this are returned. ## `refine_by_employment` (type: `string`): 🧰 Filter by employment type. ## Actor input object example ```json { "search": "software engineer", "location": "Austin, TX", "scrapeMode": "overview", "maxResults": 100, "refine_by_employment": "" } ``` # Actor output Schema ## `results` (type: `string`): All extracted ZipRecruiter job postings. ## `scrapingSummary` (type: `string`): HTML run report with job counts, fetched pages, and a sample of results. # 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 = { "search": "software engineer", "location": "Austin, TX" }; // Run the Actor and wait for it to finish const run = await client.actor("sian.agency/ziprecruiter-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 = { "search": "software engineer", "location": "Austin, TX", } # Run the Actor and wait for it to finish run = client.actor("sian.agency/ziprecruiter-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 '{ "search": "software engineer", "location": "Austin, TX" }' | apify call sian.agency/ziprecruiter-jobs-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sian.agency/ziprecruiter-jobs-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "ZipRecruiter Jobs Scraper", "description": "Scrape ZipRecruiter job postings into clean structured data — search by keyword + location or paste a filtered search URL. Fast overview (titles + links) or full detail: company, location, salary band, employment type, posted/expiry dates, category, industry & description. Clean JSON/CSV, no code.", "version": "1.0", "x-build-id": "eNo7art9CX9QiAEK2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~ziprecruiter-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-ziprecruiter-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/sian.agency~ziprecruiter-jobs-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-ziprecruiter-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/sian.agency~ziprecruiter-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-ziprecruiter-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", "properties": { "search": { "title": "🔍 Search keywords", "type": "string", "description": "🔍 **JOB TITLE / KEYWORDS:** What you're hiring for or researching, e.g. `software engineer`, `registered nurse`, `truck driver`.\n\n💡 **TIP:** Combine with a **Location** below for a targeted local search. Leave Location empty for a nationwide search.\n\nUse this OR paste full **Search URLs** below — at least one is required.", "default": "software engineer" }, "location": { "title": "📍 Location", "type": "string", "description": "📍 **LOCATION:** City + state (`Austin, TX`) or a ZIP code (`78701`). Leave empty for a nationwide search.", "default": "" }, "scrapeMode": { "title": "⚙️ Scrape mode", "enum": [ "overview", "detail" ], "type": "string", "description": "⚙️ **OVERVIEW vs DETAIL:**\n\n- **Overview** — fast & cheap. Job title + direct link for every result (≈20 per search page). Best for building a list of openings.\n- **Detail** — full record per job: company, location, salary band, employment type, posted/expiry dates, category, industry & full description.\n\n💡 Start with **Overview** to scope a search, then run **Detail** on the slice you want.", "default": "overview" }, "maxResults": { "title": "🔢 Max results", "minimum": 1, "type": "integer", "description": "🔢 **HOW MANY JOBS TO RETURN.**\n\n- **FREE users:** up to 25 jobs per run\n- **PAID users:** unlimited\n\nResults are de-duplicated across search pages.", "default": 100 }, "startUrls": { "title": "🚀 Search URLs (advanced)", "uniqueItems": true, "type": "array", "description": "🚀 **PASTE FILTERED SEARCH URLs:** Run a search on ziprecruiter.com with the exact filters you want (radius, date posted, salary floor, employment type, remote), then paste the resulting `/jobs-search?...` URL(s) here. Every allowlisted filter is carried through pagination automatically.\n\n💡 **TIP:** Use this for precise filtering the simple keyword/location fields don't cover. You can mix multiple URLs.\n\n📋 **BULK EDIT:** Click \"Bulk edit\" to paste URLs (one per line).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "radius": { "title": "📏 Radius (miles)", "type": "integer", "description": "📏 Search radius in miles around the **Location** (ZipRecruiter default is 25)." }, "days": { "title": "📅 Posted within (days)", "type": "integer", "description": "📅 Only jobs posted within the last N days (e.g. `1`, `5`, `7`)." }, "refine_by_salary": { "title": "💰 Minimum salary", "type": "integer", "description": "💰 Minimum annual salary floor (e.g. `60000`). Only jobs at or above this are returned." }, "refine_by_employment": { "title": "🧰 Employment type", "enum": [ "", "employment_full_time", "employment_part_time", "employment_contract", "employment_temporary", "employment_internship" ], "type": "string", "description": "🧰 Filter by employment type.", "default": "" } } }, "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 } } } } } } } } } } ```