# ZipRecruiter Jobs Scraper — US Jobs & Salaries (`crawloop/ziprecruiter-jobs-scraper`) Actor

Scrape ZipRecruiter jobs by keyword, city, or start URLs — a ZipRecruiter API alternative. Export title, company, salary, location, employment type, and full descriptions as JSON for recruiting and market research.

- **URL**: https://apify.com/crawloop/ziprecruiter-jobs-scraper.md
- **Developed by:** [Andrej Kiva](https://apify.com/crawloop) (community)
- **Categories:** Jobs, Lead generation, AI
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.99 / 1,000 job listings

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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 — US Jobs & Salaries

> **Disclaimer:** Unofficial tool for publicly accessible ZipRecruiter job listings. **ZipRecruiter** and related names are trademarks of their respective owners. Not affiliated with, sponsored by, or endorsed by ZipRecruiter, Inc. For informational, research, aggregation, and recruiting-intelligence use only. Respect applicable terms of use and law.

Scrape **ZipRecruiter job listings** with this **ZipRecruiter Jobs Scraper** — a practical **ZipRecruiter scraper**, **ZipRecruiter API alternative**, and **US jobs scraper** for structured JSON. Search by **keyword**, **city**, **filters**, or paste **jobs-search start URLs**. Export **title**, **company**, **location**, **salary (USD)**, **employment type**, **benefits**, **posted dates**, **SOC category**, and **full descriptions**. Call it from **Python**, **Node.js**, **cURL**, or **Apify MCP** / AI assistants — **no login**.

Ideal for **US job board aggregation**, **salary benchmarking**, **recruiting intelligence**, **employer lead generation**, and **labor-market research** across Austin, New York, Chicago, remote roles, and more.

| Actor | Focus |
| :--- | :--- |
| ZipRecruiter Jobs Scraper ◄── you are here | ZipRecruiter.com US job listings |
| [Glassdoor Scraper](https://apify.com/crawloop/glassdoor-scraper) | Employer reviews, salaries, interviews, and jobs |
| [Naukri Jobs Scraper](https://apify.com/crawloop/naukri-jobs-scraper) | India’s largest job board (Naukri.com) |
| [Foundit Jobs Scraper](https://apify.com/crawloop/foundit-jobs-scraper) | Foundit.in / Monster India listings |
| [Stepstone Jobs Scraper](https://apify.com/crawloop/stepstone-jobs-scraper) | DACH commercial job board |
| [Arbeitsagentur Jobs Scraper](https://apify.com/crawloop/arbeitsagentur-jobs-scraper) | Germany BA Jobsuche |

### When to use this Actor

- You need a **ZipRecruiter scraper** / **ZipRecruiter jobs scraper** that returns structured JSON
- You want **keyword + city + ZipRecruiter filters** without maintaining a Cloudflare crawler
- You need **parsed USD salary, benefits, employment type, and full descriptions**
- You want to scrape ZipRecruiter with **Python**, **Node.js**, or **MCP** and export a dataset
- You run a **daily monitor** and only want **new job IDs** billed

### When not to use this Actor

- **Non-US job portals** — this Actor covers ziprecruiter.com (US). Country white-labels are a different stack
- **Guaranteed emails or phones** — public listings rarely include direct contacts
- **Login-walled apply-form automation** — public search and JobPosting data only
- **Historical archives** — currently listed jobs only
- **Employer reviews** — use [Glassdoor Scraper](https://apify.com/crawloop/glassdoor-scraper) for ratings and interviews

### Key Features

- **Keyword + city search** — `position`, `location`, optional extra `searchKeywords` and `locations` (pooled and deduplicated)
- **Start URL parsing** — paste ZipRecruiter `jobs-search` URLs; query filters map automatically
- **ZipRecruiter filters** — employment type, freshness, radius, salary floor/ceiling, remote, Quick Apply
- **Structured salary** — USD min/max plus period (`hour` / `year` / `month`) from JobPosting JSON-LD
- **Full descriptions** — schema.org JobPosting on each detail page (benefits, SOC category, dates, logo)
- **Camoufox + US residential** — ZipRecruiter Cloudflare blocks datacenter and non-US IPs
- **Monitor mode** — named Key-Value store of seen job IDs; later scheduled runs emit only new jobs
- **Deduplicated job IDs** across pages, keywords, and multi-city runs (ZipRecruiter renders each card twice)
- **MCP / AI ready** — call from assistants via Apify MCP

### Use Cases

| Use case | What you get |
| :--- | :--- |
| **Job aggregation** | Fresh ZipRecruiter openings into a board / search index |
| **Salary benchmarking** | Disclosed USD bands by role × city (hourly and annual) |
| **Recruiting intelligence** | Competitor vacancy monitoring with full JD text |
| **Employer lead gen** | Companies actively hiring in a US segment |
| **Labor-market dashboards** | Employment type, remote mix, SOC codes, posted dates |
| **Daily “what’s new”** | `monitorMode` on a schedule — pay only for new job IDs |

### Quick Start

**Keyword + city:**

```json
{
  "position": "software engineer",
  "location": "Austin, TX",
  "maxItems": 50,
  "postedWithinDays": "10",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}
```

**Listing start URL (filters in the query string are applied):**

```json
{
  "startUrls": [
    { "url": "https://www.ziprecruiter.com/jobs-search?search=registered+nurse&location=Chicago%2C+IL&days=7" }
  ],
  "maxItems": 100
}
```

**Remote + salary floor + monitor:**

```json
{
  "position": "data analyst",
  "location": "Remote",
  "remoteOnly": true,
  "salaryMin": 100000,
  "maxItems": 150,
  "monitorMode": true,
  "monitorStoreName": "ziprecruiter-data-analyst-remote"
}
```

### Input Parameters

| Parameter | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| `position` | String | — | Keywords / job title |
| `searchKeywords` | Array | — | Extra keyword queries (merged, deduped) |
| `location` | String | — | City, ST / ZIP / Remote |
| `locations` | Array | — | Extra cities (one ZipRecruiter search each) |
| `startUrls` | Array | — | ZipRecruiter `jobs-search` URLs |
| `jobType` | String | any | `full_time` / `part_time` / `contract` / `temporary` / `internship` |
| `postedWithinDays` | String | any | `1` / `5` / `10` / `30` |
| `radiusMiles` | Integer | — | Radius in miles (max 100) |
| `salaryMin` / `salaryMax` | Integer | — | USD salary floor / ceiling |
| `remoteOnly` | Boolean | `false` | Remote-eligible jobs |
| `easyApply` | Boolean | `false` | Quick Apply only |
| `includeJobDescription` | Boolean | `true` | Fetch detail JobPosting JSON-LD |
| `maxItems` | Integer | `100` | Max jobs (`0` = unlimited subject to `maxPages`) |
| `maxPages` | Integer | `20` | Pagination safety cap (max 100) |
| `monitorMode` | Boolean | `false` | Emit only new job IDs vs previous run |
| `monitorStoreName` | String | `ziprecruiter-jobs-monitor` | Named KV store for seen IDs |
| `resetMonitorState` | Boolean | `false` | Wipe the seen-job cache |
| `proxyConfiguration` | Object | US residential | Required — Cloudflare blocks datacenter / non-US IPs |

### Output Format

Each dataset item is one job listing.

| Field | Type | Description |
| :--- | :--- | :--- |
| `jobId` | String | ZipRecruiter `jid` token |
| `url` | String | Job posting URL |
| `applyUrl` | String | Apply URL (same as `url` when Quick Apply) |
| `title` | String | Job title |
| `employer` | String | Hiring company |
| `employerUrl` | String | Company website when JobPosting includes `sameAs` |
| `employerLogoUrl` | String | Logo URL |
| `location` | String | Location text |
| `city` / `state` / `country` / `postalCode` | String | Parsed address |
| `workMode` | String | `remote` / `hybrid` when detected |
| `isRemote` / `isHybrid` | Boolean | Flags from location / title |
| `employmentType` | String | e.g. `FULL_TIME` |
| `industry` | String | Employer industry |
| `occupationalCategory` | String | SOC code + label when present |
| `benefits` | Array | Benefit labels |
| `salaryNote` | String | Formatted band (e.g. `$36 - $55.8/hr`) |
| `salaryMin` / `salaryMax` | Number | Absolute USD amounts |
| `salaryPeriod` | String | `hour` / `year` / `month` / `week` / `day` |
| `salaryCurrency` | String | Usually `USD` |
| `postedAt` / `validThrough` | String | ISO dates from JobPosting |
| `description` | String | Full text (when `includeJobDescription` succeeds) |
| `descriptionHtml` | String | Original HTML description |
| `source` | String | Always `ziprecruiter` |

**Example row:**

```json
{
  "jobId": "464aac35b7123512",
  "url": "https://www.ziprecruiter.com/c/Endeavor-Health/Job/Registered-Nurse-GI-Days/-in-Chicago,IL?jid=464aac35b7123512",
  "title": "Registered Nurse - GI - Days",
  "employer": "Endeavor Health",
  "location": "Chicago, IL",
  "city": "Chicago",
  "state": "IL",
  "country": "US",
  "workMode": null,
  "employmentType": "FULL_TIME",
  "industry": "Healthcare",
  "occupationalCategory": "29-1141.00: Registered Nurses",
  "salaryNote": "$36 - $55.8/hr",
  "salaryMin": 36,
  "salaryMax": 55.8,
  "salaryPeriod": "hour",
  "salaryCurrency": "USD",
  "postedAt": "2026-08-19T07:00:00Z",
  "source": "ziprecruiter"
}
```

### Integration examples

#### Node.js

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('crawloop/ziprecruiter-jobs-scraper').call({
  position: 'software engineer',
  location: 'Austin, TX',
  maxItems: 50,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.slice(0, 5));
```

#### Python

```python
from apify_client import ApifyClient

client = ApifyClient(token)
run = client.actor("crawloop/ziprecruiter-jobs-scraper").call(
    run_input={
        "position": "software engineer",
        "location": "Austin, TX",
        "maxItems": 50,
    }
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item.get("title"), item.get("employer"), item.get("salaryNote"))
```

#### cURL

```bash
curl "https://api.apify.com/v2/acts/crawloop~ziprecruiter-jobs-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"position":"software engineer","location":"Austin, TX","maxItems":50}'
```

### MCP and AI assistants

Use this Actor from AI tools via [Apify MCP](https://docs.apify.com/platform/integrations/mcp). Connect your Apify account, then call `crawloop/ziprecruiter-jobs-scraper`.

Example prompts:

- "Run ZipRecruiter Jobs Scraper for software engineer in Austin, TX, max 50, and return title, employer, salaryNote, url as JSON"
- "Scrape ZipRecruiter registered nurse jobs in Chicago posted in the last 7 days and summarize salary bands"
- "Pull ZipRecruiter remote data analyst jobs, then run Glassdoor Scraper on the top hiring employers"
- "Monitor ZipRecruiter Python developer jobs in New York daily and return only new job IDs"

### Suite next step

ZipRecruiter is the US marketplace listing feed. For employer reviews, interview questions, and salary bands on the same companies, run [Glassdoor Scraper](https://apify.com/crawloop/glassdoor-scraper) next.

### FAQ

**Is this an official ZipRecruiter API?**\
No. ZipRecruiter’s partner API is for posting jobs, not public search. This Actor reads public `jobs-search` pages and schema.org JobPosting JSON-LD — a practical **ZipRecruiter API alternative** for pipelines.

**Do I need a proxy?**\
Yes — **US residential**. ZipRecruiter Cloudflare blocks datacenter IPs and geo-redirects many non-US connections (including to ziprecruiter.de, which is a different site).

**Can I paste a ZipRecruiter search URL?**\
Yes — `startUrls` accepts `jobs-search` links. Filters such as `days`, `radius`, `refine_by_salary`, and `refine_by_employment` map automatically.

**Do I need a ZipRecruiter account?**\
No — public listing and job pages only.

**How do I get the full job description?**\
It is on by default (`includeJobDescription: true`). Each job page is opened and JobPosting JSON-LD is parsed (description, salary, benefits, dates). Turn it off for faster listing-only runs (title, company, location, URL).

**Why is each job returned only once if the page shows ~40 cards?**\
ZipRecruiter renders every job twice (list pane + detail pane). The scraper deduplicates by `jid`.

**What is monitor mode?**\
With `monitorMode: true`, seen job IDs are stored in a named Key-Value store. The first run is the baseline (all matches are new). Later scheduled runs push and charge only IDs not seen before.

**Python / Node.js / MCP?**\
Yes — use the Apify client examples above or Apify MCP prompts.

**How many jobs per search?**\
ZipRecruiter paginates **20 unique jobs per page**. Use extra `locations` / `searchKeywords` or start URLs to cover more. There is no 500-item hard cap beyond `maxItems` / `maxPages`.

### Related Actors

| Actor | Focus |
| :--- | :--- |
| ZipRecruiter Jobs Scraper ◄── you are here | ZipRecruiter.com US job listings |
| [Glassdoor Scraper](https://apify.com/crawloop/glassdoor-scraper) | Reviews, salaries, interviews, jobs |
| [Naukri Jobs Scraper](https://apify.com/crawloop/naukri-jobs-scraper) | Naukri.com India jobs |
| [Foundit Jobs Scraper](https://apify.com/crawloop/foundit-jobs-scraper) | Foundit.in / Monster India |
| [Stepstone Jobs Scraper](https://apify.com/crawloop/stepstone-jobs-scraper) | DACH job listings |
| [Arbeitsagentur Jobs Scraper](https://apify.com/crawloop/arbeitsagentur-jobs-scraper) | Germany BA Jobsuche |

# Actor input Schema

## `position` (type: `string`):

Job title or keywords (e.g. software engineer, registered nurse, data analyst).

## `searchKeywords` (type: `array`):

Optional extra keyword queries. Each keyword is searched separately; results are merged and deduplicated by job ID.

## `location` (type: `string`):

US city/state (e.g. Austin, TX), ZIP, or Remote.

## `locations` (type: `array`):

Optional extra cities. Each city is a separate ZipRecruiter search; results are pooled and deduplicated by job ID.

## `startUrls` (type: `array`):

Optional ZipRecruiter jobs-search URLs. Query filters (days, radius, salary, employment type, remote) are parsed automatically.

## `jobType` (type: `string`):

ZipRecruiter employment-type facet.

## `postedWithinDays` (type: `string`):

Only jobs posted in the last N days.

## `radiusMiles` (type: `integer`):

Search radius around the location. 0 = ZipRecruiter default.

## `salaryMin` (type: `integer`):

Minimum salary floor (annual USD). Only listings that disclose pay at or above this amount.

## `salaryMax` (type: `integer`):

Optional salary ceiling (annual USD).

## `remoteOnly` (type: `boolean`):

Restrict results to remote-eligible jobs.

## `easyApply` (type: `boolean`):

Restrict results to ZipRecruiter Quick Apply listings.

## `includeJobDescription` (type: `boolean`):

Visit each job page and parse schema.org JobPosting (description, salary, benefits, dates, SOC category). On by default. Turn off for faster listing-only runs.

## `maxItems` (type: `integer`):

Maximum job rows to collect across all searches. 0 = unlimited (subject to maxPages).

## `maxPages` (type: `integer`):

Safety cap on ZipRecruiter pagination (20 jobs per page).

## `monitorMode` (type: `boolean`):

On a schedule, push and charge only job IDs not seen in a previous run. First run delivers the full match set (baseline). Pair with an Apify Schedule and a stable monitorStoreName.

## `monitorStoreName` (type: `string`):

Named Key-Value store for seen job IDs across scheduled runs. Use a distinct name per watch (e.g. nurse-chicago vs python-austin).

## `resetMonitorState` (type: `boolean`):

Clear the seen-job cache before this run (next run becomes a new baseline).

## `proxyConfiguration` (type: `object`):

US residential is required. ZipRecruiter Cloudflare blocks datacenter and non-US IPs.

## Actor input object example

```json
{
  "position": "software engineer",
  "location": "Austin, TX",
  "startUrls": [
    {
      "url": "https://www.ziprecruiter.com/jobs-search?search=software+engineer&location=Austin%2C+TX"
    }
  ],
  "jobType": "",
  "postedWithinDays": "",
  "remoteOnly": false,
  "easyApply": false,
  "includeJobDescription": true,
  "maxItems": 100,
  "maxPages": 20,
  "monitorMode": false,
  "monitorStoreName": "ziprecruiter-jobs-monitor",
  "resetMonitorState": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Default dataset items.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "position": "software engineer",
    "location": "Austin, TX",
    "startUrls": [
        {
            "url": "https://www.ziprecruiter.com/jobs-search?search=software+engineer&location=Austin%2C+TX"
        }
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawloop/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "position": "software engineer",
    "location": "Austin, TX",
    "startUrls": [{ "url": "https://www.ziprecruiter.com/jobs-search?search=software+engineer&location=Austin%2C+TX" }],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("crawloop/ziprecruiter-jobs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "position": "software engineer",
  "location": "Austin, TX",
  "startUrls": [
    {
      "url": "https://www.ziprecruiter.com/jobs-search?search=software+engineer&location=Austin%2C+TX"
    }
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}' |
apify call crawloop/ziprecruiter-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,crawloop/ziprecruiter-jobs-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/jrHUEkaw2KCMAtk9Y/builds/XhubewsdOAxwiYnKt/openapi.json