# ZipRecruiter Job Scraper | 5 Markets, Contacts & Monitoring (`corvuslab/ziprecruiter-scraper`) Actor

Extract job listings from ZipRecruiter across Ireland, UK, Germany, France and India. Get structured salary, geo-coordinates, employer contacts, and full descriptions in text/HTML/Markdown with incremental change monitoring.

- **URL**: https://apify.com/corvuslab/ziprecruiter-scraper.md
- **Developed by:** [Corvuslab](https://apify.com/corvuslab) (community)
- **Categories:** Jobs, Lead generation
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 88.5% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.49 / 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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does ZipRecruiter Job Scraper do?

ZipRecruiter Job Scraper extracts structured job listings from [ZipRecruiter](https://www.ziprecruiter.com/) across **six markets** — the United States, United Kingdom, Ireland, Germany, France and India. Each record includes the job title, company, structured location with geo-coordinates, parsed salary, employment type, workplace (remote / hybrid / on-site), benefits, apply URL, posting and expiry dates, and the full description in **text, HTML and Markdown**. Built-in contact extraction pulls employer emails, phone numbers, URLs and social profiles straight from the listing body — ready for lead-gen workflows. Export to JSON, CSV, Excel or pull from the API; no code and no login required.

Give it a search keyword (e.g. `software engineer`) and a country, and it returns every matching listing as a clean, typed record — up to **10,000 jobs per search** (the US board shows fewer jobs per search, so US searches are widened automatically to fill your request). For each job you get the core fields from the search results; **Fetch full details** (on by default) adds the complete description, geo-coordinates, employment type, benefits, expiry date and embedded contacts. You can also paste ZipRecruiter URLs directly instead of running a keyword search.

> New to Apify? You can [sign up for free](https://console.apify.com/sign-up) and use the included monthly platform credit to try this Actor.

**Why this scraper**

- ⚡ **Fast & low-cost** — lightweight, browser-free requests; a thousand fully detailed jobs in minutes.
- 🧾 **Rich, typed records** — 62 structured fields per job listing, not raw HTML.
- ♻️ **Cheap to monitor** — incremental mode re-scrapes only what changed (see below).
- 🔔 **Notifications built in** — Telegram, Slack, Discord, WhatsApp or any webhook.
- 🤖 **AI- & API-ready** — compact output, MCP-friendly, one-click integrations.

***

### 📚 What data can you extract from ZipRecruiter?

Every record carries **49 fields**, grouped like this:

| Group | What you get |
|---|---|
| **Core listing** | `jobId`, `title`, `url`, `portalUrl`, `country`, `employmentType`, `jobTypes`, `educationLevel`, `responsibilities`, `referenceNumber`, `searchKeyword`, `detailFetched` |
| **Apply** | `applyUrl`, `applyType`, `directApply`, `atsIntegration` |
| **Contacts & demand signals** | `extractedEmails`, `extractedPhones`, `extractedUrls`, `socialProfiles` |
| **Company** | `company`, `companyUrl`, `companyLogo`, `companyIndustry`, `companySize`, `companyHeadquarters`, `companyFoundedYear`, `companyDescription` (company profile: US) |
| **Pay & perks** | `salaryMin`, `salaryMax`, `salaryCurrency`, `salaryInterval`, `salaryEstimated`, `salaryText`, `benefits` |
| **Location** | `location`, `locationType`, `addressLocality`, `addressRegion`, `stateCode`, `addressCountry`, `postalCode`, `latitude`, `longitude` |
| **Description** | `description`, `descriptionHtml`, `descriptionMarkdown`, `descriptionSnippet` |
| **Dates & change tracking** | `datePosted`, `lastRefreshedAt`, `expiresAt`, `changeType`, `firstSeenAt`, `lastSeenAt`, `previousSeenAt`, `expiredAt`, `contentHash`, `isRepost`, `repostOfId` |

Every field is nullable — missing values come back as `null`. **Compact mode** returns
the core fields only for lean AI/MCP payloads, and **`excludeEmptyFields`** drops empties
entirely.

### ✨ Key features

- 🌍 **Six markets in one actor** — the United States plus Ireland, UK, Germany, France and India, with country-specific filters and localized results.
- 🔎 **Search or URL scraping** — run a keyword + location search, or paste ZipRecruiter search/detail URLs directly.
- 🧾 **Structured records** — title, company, location, salary (min/max/currency/interval), employment type, posting & expiry dates, apply URL, geo-coordinates (outside the US), and more.
- 📝 **Three description formats** — get the full job description as plain text, HTML and Markdown (or pick one to keep payloads lean).
- 📇 **Contact extraction & lead-gen filter** — emails, phone numbers, URLs and social profiles extracted from every listing; filter with `requireContact` to keep only jobs with actionable contacts.
- 🎚️ **Filters that work in every language** — job type (read from each posting: *Full Time*, *Vollzeit*, *CDI*…), remote / hybrid / on-site, posted within N days, search radius, sort by date.
- 🏠 **Workplace & benefits** — every job is tagged REMOTE, HYBRID or ONSITE, and common benefits (pension, bonus, health insurance, flexible hours…) are listed per job.
- 🔄 **Repost detection** — flags re-listed jobs and links back to the original posting; `skipReposts` drops them entirely.
- ♻️ **Incremental monitoring** — schedule it and get only what changed (NEW / UPDATED / REAPPEARED / EXPIRED); unchanged items are skipped before their page is even fetched.
- 🔔 **Notifications** — Telegram, Slack, Discord, WhatsApp or any webhook (n8n / Make / Zapier).
- 🤖 **AI-ready** — compact + drop-empty output modes keep payloads small for LLMs and MCP.

***

### 🚀 How to scrape ZipRecruiter

1. Open the actor and enter a **search keyword** (e.g. `software engineer`) and pick a **country** — or paste a ZipRecruiter URL.
2. Set **Max results** and choose whether to **fetch full details**.
3. (Optional) Pick **filters** — job type, workplace, posted within, search radius.
4. (Optional) Turn on **incremental mode** and a **notification** channel, then **Schedule** it.
5. Click **Start**.
6. Download the data as **JSON, CSV or Excel**, or pull it from the **API**.

New to Apify? Create a free account — it comes with monthly credit, no credit card required.

***

### ⚙️ Input

Configure it in the visual editor — no code needed — or pass JSON via the API.

| Field | What it does |
|---|---|
| `query` | Keyword search (comma-separate for multiple searches). |
| `country` | Which ZipRecruiter market to search: US, GB, IE, DE, FR or IN. |
| `location` | City, region or area to narrow results. |
| `startUrls` | Scrape specific ZipRecruiter search or detail URLs. |
| `jobType` | Keep one job type: full-time, part-time, permanent, contract, temporary or internship — matched in the local language. |
| `remoteFilter` | Workplace: any, on-site only, remote only, hybrid only, or remote-or-hybrid. |
| `postedWithinDays` | Keep only jobs posted in the last N days. |
| `minSalary` | Keep only jobs whose pay reaches this yearly amount (hourly, weekly and monthly pay is converted). |
| `experienceLevel` | United States: junior, mid-level or senior, as ZipRecruiter classifies the job. |
| `applyMethod` | Easy apply on ZipRecruiter (US) or the employer's own site. |
| `radius` | Search radius in km around the location (5, 10, 20, 50 or 100; in the US the nearest of 5, 10, 25, 50 or 100 miles). |
| `sort` | Sort by relevance or date posted. |
| `includeDetails` | Fetch each job's detail page for richer fields (on by default). |
| `requireContact` | Keep only listings with an email, phone or both — built-in lead-gen filter. |
| `descriptionFormat` | Which description format(s) to include: `all`, `text`, `html` or `markdown`. |
| `compact` | Return only core fields — ideal for AI agents and MCP clients. |
| `incrementalMode` | Emit only what changed since the last run. |
| `maxResults` | Cap the number of records (0 = everything, up to 10,000 per search). |

...and **39 inputs** in total — the table shows the essentials; the rest cover notification channels, output/AI modes and advanced tuning, all in the visual editor.

#### Example inputs

**Basic search — software jobs in Ireland:**

```json
{ "query": "software engineer", "country": "IE", "maxResults": 100 }
```

**United States — remote customer-service jobs nationwide:**

```json
{ "query": "customer service", "country": "US", "remoteFilter": "remote", "maxResults": 500 }
```

**Filtered search — full-time data roles in London:**

```json
{
  "query": "data analyst",
  "country": "GB",
  "location": "London",
  "jobType": "full_time",
  "includeDetails": true,
  "maxResults": 200
}
```

**Incremental monitoring with Slack alerts:**

```json
{
  "query": "python developer",
  "country": "DE",
  "incrementalMode": true,
  "slackWebhookUrl": "https://hooks.slack.com/services/YOUR/WEBHOOK/URL",
  "maxResults": 0
}
```

***

### 📤 Output

Each item in the dataset is one job listing. Every record includes the core fields; **Fetch full details** (on by default) adds the full description, geo-coordinates, employment type, benefits, expiry date and apply URL. Here is a real example record (descriptions shortened):

```json
{
  "jobId": "601589865",
  "title": "Sales Assistant",
  "url": "https://www.ziprecruiter.ie/jobs/601589865-sales-assistant-at-lush-handmade-cosmetics",
  "company": "Lush Handmade Cosmetics",
  "location": "Cork, Cork T12 NC43, Ireland",
  "country": "IE",
  "locationType": "ONSITE",
  "addressRegion": "Munster",
  "addressCountry": "Ireland",
  "postalCode": "T12",
  "latitude": 51.8728,
  "longitude": -8.4902,
  "datePosted": "2026-09-19",
  "expiresAt": "2026-10-19T17:05:59.954Z",
  "employmentType": "Full Time",
  "jobTypes": ["PART_TIME", "TEMPORARY"],
  "salaryMin": 15.4,
  "salaryMax": 15.4,
  "salaryCurrency": "EUR",
  "salaryInterval": "HOUR",
  "salaryEstimated": false,
  "benefits": ["Pension", "Bonus", "Flexible hours", "Training & development", "Wellbeing", "Parental leave"],
  "applyUrl": "https://lush.pinpointhq.com/en/postings/6a8248da-32c7-441b-853b-25620956c47e?utm_source=ziprecruiter",
  "applyType": "url",
  "directApply": false,
  "atsIntegration": false,
  "referenceNumber": "1923519213",
  "descriptionSnippet": "Sales Assistant  Application Deadline: 30 September 2026  Department: Retail  Employment Type: Seasonal - Part...",
  "description": "Sales Assistant\n\nApplication Deadline: 30 September 2026\n\nDepartment: Retail\n\nEmployment Type: Seasonal - Part time...",
  "descriptionHtml": "<strong>Sales Assistant</strong><br><br><strong>Application Deadline: </strong>30 September 2026...",
  "descriptionMarkdown": "**Sales Assistant**  \n  \n**Application Deadline:** 30 September 2026...",
  "source": "ziprecruiter",
  "searchKeyword": "sales",
  "scrapedAt": "2026-09-29T21:11:52.008780+00:00",
  "detailFetched": true,
  "contentHash": "6a9ec6374899a6e386ce4c007f31e8add795e254"
}
```

Note `jobTypes`: the site labels this job "Full Time", but the posting itself says *Seasonal – Part time*, and that is what the job-type filter uses. Choose which description formats to include with the **Description format** input. When incremental mode is on, records also carry `changeType`, `firstSeenAt`, `lastSeenAt`, `previousSeenAt` (the last sighting before this run) and `expiredAt` (when the job was found gone — on EXPIRED records, and on REAPPEARED ones for the time they were offline). Contact fields (`extractedEmails`, `extractedPhones`, `extractedUrls`, `socialProfiles`) are filled when the listing body contains actionable contact information.

#### Data fields

- **Core** — `jobId`, `title`, `url`, `portalUrl`, `company`, `companyUrl`, `location`, `country`, `descriptionSnippet`, `datePosted`, `source`, `searchKeyword`, `scrapedAt`.
- **Details** (with `includeDetails`) — `description`, `descriptionHtml`, `descriptionMarkdown`, `employmentType`, `jobTypes`, `expiresAt`, `referenceNumber`; for US jobs also `educationLevel` (ZipRecruiter's estimate), `responsibilities` and the company profile (`companyIndustry`, `companySize`, `companyHeadquarters`, `companyFoundedYear`, `companyDescription`, and the company's social accounts in `socialProfiles`).
- **Apply** — `applyUrl`, `applyType`, `directApply`, `atsIntegration`.
- **Location & workplace** — `locationType`, `addressLocality`, `addressRegion`, `stateCode` (US), `addressCountry`, `postalCode`, `latitude`, `longitude` (outside the US).
- **Pay & perks** — `salaryMin`, `salaryMax`, `salaryCurrency`, `salaryInterval`, `salaryEstimated`, `salaryText` (the pay as ZipRecruiter shows it, US), `benefits`.
- **Contacts & signals** — `extractedEmails`, `extractedPhones`, `extractedUrls`, `socialProfiles`.
- **Monitoring** — `contentHash`, `changeType`, `firstSeenAt`, `lastSeenAt`, `previousSeenAt`, `expiredAt`, `detailFetched`.
- **Repost detection** — `isRepost`, `repostOfId`, `repostDetectedAt`.

Every field is present in standard mode (missing values are `null`); **compact mode** returns the core fields only, for lean AI/MCP payloads. With **`excludeEmptyFields`** enabled, null/empty fields are omitted entirely.

***

### 🔔 How to monitor ZipRecruiter and get alerts for new jobs

Schedule the Actor with **incremental mode** on, and each run returns only what changed since the last one: **NEW**, **UPDATED** or **REAPPEARED** jobs, plus **EXPIRED** ones if you ask. Unchanged jobs are skipped *before* their detail page is fetched, so after the first run you pay only for what changed. A job that vanishes and comes back within 60 days is reported as REAPPEARED rather than NEW, and `maxResults` sets how many top results are watched. **Skip reposts** drops jobs re-posted under a new ID.

1. Set up your keyword, country and filters.
2. Turn on **Incremental mode** and **Notify only about changes**. To be told when jobs close, also turn on **Include expired records**.
3. Fill in the alert channels you want:

| Channel | What to configure |
|---|---|
| ✈️ **Telegram** | `telegramToken` (from @BotFather) + `telegramChatId` |
| 💬 **Slack** | `slackWebhookUrl` (Incoming Webhook URL) |
| 🎮 **Discord** | `discordWebhookUrl` (channel webhook URL) |
| 📱 **WhatsApp** | `whatsappPhoneNumberId` + `whatsappAccessToken` (WhatsApp Business) + `whatsappTo` |
| 🪝 **Webhook** | `webhookUrl` receives structured JSON, ideal for n8n / Make / Zapier; add `webhookHeaders` for auth |

4. Run it once. The first run delivers every match and remembers it.
5. Open the **Schedules** tab and set a recurring run, e.g. every morning.

Each message lists up to `notificationLimit` jobs with title, company, salary and change type, plus a link. Credentials are secret inputs: encrypted at rest, masked in the UI and never written to the run log. Every channel fires independently, so a broken one can't stop the scrape or the others.

***

### 💡 What can you do with ZipRecruiter data?

- **Lead generation** — extract employer emails, phones and social profiles from job listings across six markets; filter with `requireContact` to build targeted outreach lists.
- **Multi-market job monitoring** — schedule daily runs with incremental mode to track new, updated and expired vacancies across the US, UK, Ireland, Germany, France and India.
- **Salary benchmarking** — collect structured salary data (min/max, currency, interval) to compare compensation across roles, locations and countries.
- **Market & competitive research** — analyse hiring trends, employment types and company activity across the US, European and Indian job markets.
- **Enrichment & aggregation** — feed clean, structured job data into your own app, spreadsheet or data warehouse.
- **AI agents & pipelines** — compact output plugs straight into LLM/MCP workflows for automated job-market analysis.

***

### 💰 How much does it cost to scrape ZipRecruiter?

This Actor uses the **pay-per-event** pricing model: a small fee at run start plus a per-record fee. You pay only for records delivered — records removed by your filters and unchanged records in incremental mode cost nothing.

See the Actor's **Pricing** tab for exact current prices.

***

### 🔌 Integrations & export

Export to **JSON, CSV, Excel** or an HTML table, or pull from the **REST API** and the **JavaScript / Python** clients. Runs on a **schedule**, connects to **Google Sheets, Slack, Make, Zapier and n8n**, and works as an **MCP tool** for AI agents — compact mode keeps token usage small.

***

### 🔗 Using the API

You can run this Actor from your own code. Example with the Apify Python client:

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")

run_input = {
    "query": "data analyst, python developer",
    "country": "GB",
    "location": "London",
    "maxResults": 50,
}

run = client.actor("corvuslab/ziprecruiter-scraper").call(run_input=run_input)

print("Results: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

The Actor also works with the JavaScript/TypeScript client, the Apify CLI and the REST API.

***

### ❓ FAQ

**Do I need a proxy or login?** No — the default settings work out of the box, with no login.

**Which countries are supported?** The United States, United Kingdom, Ireland, Germany, France and India. Each has its own ZipRecruiter domain with localized results. (ZipRecruiter's New Zealand board has closed.)

**What is different for US jobs?** US records add `stateCode`, `lastRefreshedAt` (when ZipRecruiter last refreshed the listing), the pay as shown on the site (`salaryText`), whether you apply on ZipRecruiter or on the employer's site (`applyType`, `directApply`) and, for about 60% of jobs, a company profile: website, industry, size, headquarters, founding year, description and social accounts. Pay is filled for almost every US job; when it is ZipRecruiter's own estimate rather than the employer's figure, `salaryEstimated` is `true`. The US board does not publish geo-coordinates, an expiry date or a reference number, so those fields stay empty for US jobs. In the US the job type, workplace and posted-within filters are applied by the search itself, so they cost no extra page loads.

**Can I get only new items on a schedule?** Yes — turn on incremental mode and schedule it; each run emits only what changed and can notify your channel.

**What formats can I export?** JSON, CSV, Excel, HTML table, or via the API.

**Is it good for AI agents?** Yes — enable compact mode; the output is MCP-friendly with minimal token usage.

**How many records can I get?** Up to 10,000 per search — run several keywords or locations to go beyond that. In the US one search shows fewer jobs, so the actor widens it automatically (1,000-job US searches fill completely). Set `maxResults` to cap the count (0 = everything).

**Can it notify me when new items appear?** Yes — add a Telegram, Slack, Discord, WhatsApp or generic webhook target under Notifications, and turn on **Notify only about changes** so you only get pinged about new, updated and reappeared jobs.

**Is scraping ZipRecruiter legal?** This actor collects only **publicly available** data on ZipRecruiter. You are responsible for how you use the extracted data — in particular any personal information — and for complying with the site's terms and applicable law (including the GDPR where it applies). Not affiliated with, endorsed by, or sponsored by ZipRecruiter, Inc.

***

### 🧭 More scrapers from us

Need jobs from more markets, or a closer look at the employer? These cover the rest.

| Scraper | What it adds |
|---|---|
| [Welcome to the Jungle Jobs Scraper](https://apify.com/corvuslab/welcome-to-the-jungle-jobs-scraper) | Every job on the board, with salary, remote and company data |
| [Greenhouse, Lever & Ashby Jobs Scraper](https://apify.com/corvuslab/greenhouse-jobs-scraper) | Jobs straight from 2,800+ employers' own career pages |
| [Jobbird Scraper](https://apify.com/corvuslab/jobbird-scraper) | Jobs in the Netherlands, Germany and the UK, with salary |
| [kununu Company Profile Scraper](https://apify.com/corvuslab/kununu-scraper) | DACH employer ratings, salary ranges and benefits |
| [Levels.fyi Compensation Scraper](https://apify.com/corvuslab/levelsfyi-scraper) | Tech pay by company and level: base, stock, bonus and total |
| [LinkedIn Jobs Scraper](https://apify.com/corvuslab/linkedin-jobs-scraper) | Jobs worldwide, with company size, industry and pay range |

***

**Keywords:** ZipRecruiter scraper · ZipRecruiter API · ZipRecruiter jobs scraper · scrape ZipRecruiter · ZipRecruiter data extraction · job scraper USA · job scraper Ireland · job scraper UK · job scraper Germany · job scraper France · job scraper India · ZipRecruiter job listings · job monitoring · job market research · lead generation jobs · export jobs CSV · export jobs JSON · no-code job scraper · MCP tool for AI agents

# Changelog

This Actor's version history is a separate document: https://apify.com/corvuslab/ziprecruiter-scraper/changelog.md

# Actor input Schema

## `query` (type: `string`):

Keywords to search for. Separate multiple searches with commas — each runs as its own search and results are merged and de-duplicated.

## `country` (type: `string`):

Which ZipRecruiter market to search.

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

City, region or area to search in. Leave empty for country-wide results (in the United States: nationwide).

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

Paste ZipRecruiter search or job-detail URLs to scrape directly.

## `maxResults` (type: `integer`):

Maximum number of records to return. Set 0 for everything the search has (up to 10,000 per search). In incremental mode this is the number of top results watched each run.

## `ignoreUrlFailures` (type: `boolean`):

Skip URLs that cannot be interpreted instead of failing the whole run.

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

Keep only jobs of this type. Matched on each posting's own employment type in every market's language (e.g. Vollzeit, CDI), so full details are fetched when this is set. In the United States the search applies it directly, and Permanent means full-time.

## `sort` (type: `string`):

How to sort search results.

## `remoteFilter` (type: `string`):

Filter by work arrangement. On-site only is applied by the search itself; remote and hybrid are read from each posting's full text. In the United States every option is read from the job's own workplace type, with no extra page loads.

## `radius` (type: `integer`):

Search radius around the location in kilometres. Only used when a location is set. Values snap to the nearest option: 5, 10, 20, 50 or 100 km (United States: 5, 10, 25, 50 or 100 miles).

## `postedWithinDays` (type: `integer`):

Keep only jobs posted in the last N days. Leave empty for any age. Results are then collected newest-first.

## `minSalary` (type: `integer`):

Keep only jobs whose pay reaches this yearly amount at the top of its range, in the market's own currency (e.g. 60000). Hourly, daily, weekly and monthly pay is converted to a yearly figure. Jobs that state no pay are left out.

## `experienceLevel` (type: `string`):

United States only: keep jobs ZipRecruiter classifies as junior, mid-level or senior. Ignored in other markets.

## `applyMethod` (type: `string`):

Easy apply keeps US jobs you apply to directly on ZipRecruiter (1-Click Apply); external keeps jobs that send you to the employer's own site. Outside the US every job applies on the employer's site.

## `requireContact` (type: `string`):

Keep only records that include a contact. off = keep everything; email / phone = require that channel; either = at least one; both = email and phone.

## `includeDetails` (type: `boolean`):

Fetch each job's detail page for richer fields. Turn off for the fastest, cheapest runs.

## `descriptionFormat` (type: `string`):

Which representation(s) of the job description to include.

## `descriptionMaxLength` (type: `integer`):

Truncate description to N characters. 0 = no truncation.

## `compact` (type: `boolean`):

Emit only the core fields. Ideal for AI agents and MCP clients.

## `excludeEmptyFields` (type: `boolean`):

Remove null, empty-string and empty-array fields from each record.

## `incrementalMode` (type: `boolean`):

Track state between runs and tag every record with a changeType (NEW / UPDATED / REAPPEARED / UNCHANGED / EXPIRED).

## `stateKey` (type: `string`):

Stable name for the tracked search. Leave empty to derive one automatically from your search settings.

## `emitUnchanged` (type: `boolean`):

Also emit records that have not changed since the previous run.

## `emitExpired` (type: `boolean`):

Emit records for jobs present last run but gone now.

## `skipReposts` (type: `boolean`):

Drop jobs that are a re-listing of one already seen (same title at the same employer under a new job ID). Reposts are always flagged with isRepost either way.

## `telegramToken` (type: `string`):

Bot token from @BotFather.

## `telegramChatId` (type: `string`):

Chat or channel ID, e.g. "-100123456789" or "@yourchannel".

## `slackWebhookUrl` (type: `string`):

Slack incoming-webhook URL.

## `discordWebhookUrl` (type: `string`):

Discord incoming-webhook URL.

## `whatsappPhoneNumberId` (type: `string`):

WhatsApp Cloud API phone number ID (Meta for Developers → WhatsApp → API setup).

## `whatsappAccessToken` (type: `string`):

WhatsApp Cloud API access token.

## `whatsappTo` (type: `string`):

Recipient phone number(s) in international format, comma-separated, e.g. "353871234567". Meta delivers free-form messages to numbers that messaged your business number in the last 24 hours.

## `webhookUrl` (type: `string`):

Any HTTPS endpoint. Receives a JSON POST with the matched records — works with n8n, Make and Zapier.

## `webhookHeaders` (type: `object`):

Extra headers for the webhook request, e.g. {"Authorization": "Bearer xyz"}.

## `notificationLimit` (type: `integer`):

How many records to include in each notification message.

## `notifyOnlyChanges` (type: `boolean`):

In incremental mode, send only NEW, UPDATED and REAPPEARED jobs to your channels.

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

The default setting works out of the box — only change it if you have a reason to.

## `maxRequestRetries` (type: `integer`):

How many times to retry a failed request before giving up on it.

## `detailConcurrency` (type: `integer`):

How many job pages to load at once when fetching full details.

## Actor input object example

```json
{
  "query": "data analyst, python developer",
  "country": "IE",
  "maxResults": 25,
  "ignoreUrlFailures": true,
  "jobType": "",
  "sort": "",
  "remoteFilter": "",
  "experienceLevel": "",
  "applyMethod": "",
  "requireContact": "off",
  "includeDetails": true,
  "descriptionFormat": "all",
  "descriptionMaxLength": 0,
  "compact": false,
  "excludeEmptyFields": false,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "skipReposts": false,
  "notificationLimit": 5,
  "notifyOnlyChanges": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "maxRequestRetries": 3,
  "detailConcurrency": 16
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `allItems` (type: `string`):

No description

# 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 = {
    "query": "software engineer",
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("corvuslab/ziprecruiter-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 = {
    "query": "software engineer",
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("corvuslab/ziprecruiter-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 '{
  "query": "software engineer",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call corvuslab/ziprecruiter-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,corvuslab/ziprecruiter-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/chqOuTO3mAjcqkZTf/builds/xp8IeGWgsXygaxcZi/openapi.json
