# ZipRecruiter Jobs Scraper — Remote Jobs, Salaries & Details (`crowdpull/crowdpull-ziprecruiter-jobs-scraper`) Actor
Extract ZipRecruiter jobs by keyword, location, or direct URL. Supports remote filters, salary and apply fields, detail enrichment, US residential proxy defaults, and in-run deduplication.
- **URL**: https://apify.com/crowdpull/crowdpull-ziprecruiter-jobs-scraper.md
- **Developed by:** [Crowd Pull](https://apify.com/crowdpull) (community)
- **Categories:** Jobs, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
from $3.75 / 1,000 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.
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
## CrowdPull ZipRecruiter Jobs Search
Pure HTTP Apify actor for searching ZipRecruiter jobs by keyword and location.
This actor is designed for SignalApply-style job discovery pipelines:
- Search multiple titles/keywords across multiple locations.
- Start from ZipRecruiter search URLs or job detail URLs while preserving URL filters.
- Search generated keyword/location pairs across supported ZipRecruiter country domains.
- Emit normalized job rows into the default Apify dataset.
- Deduplicate results by external ID, URL, or title/company/location.
- Run in incremental mode so recurring runs emit only new or changed jobs.
- Save run metadata to `SEARCH_SPECS` and `SUMMARY` key-value records.
- Run in API mode, pure HTTP web mode, auto mode, or fallback URL mode.
- Parse `/jobs-search` Schema.org `ItemList` results and job-page `JobPosting` JSON-LD.
- Normalize richer fields when exposed by ZipRecruiter: typed salary ranges, remote/hybrid flags, company metadata, apply URLs, benefits, and geo fields.
### Search Modes
- `auto`: uses the ZipRecruiter Search API when `apiKey` is present and no `startUrls` are supplied, otherwise uses pure HTTP web search.
- `api`: requires a ZipRecruiter Search API key.
- `web`: fetches ZipRecruiter search URLs, parses result links, then optionally fetches job detail pages for `JobPosting` JSON-LD.
- `fallbackUrls`: emits search URLs only.
With empty input, the actor defaults to this remote-first sales search:
```text
https://www.ziprecruiter.com/jobs-search?search=Sales&location=USA&refine_by_location_type=only_remote
````
Production Apify runs require a proxy. The default input uses US residential Apify Proxy because ZipRecruiter blocked direct Apify datacenter egress during remote testing, while US residential proxying allowed search results and better detail-page enrichment:
```json
{
"proxyConfig": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"],
"apifyProxyCountry": "US"
}
}
```
### Input
```json
{
"startUrls": [
{
"url": "https://www.ziprecruiter.com/jobs-search?search=Sales&location=USA&refine_by_location_type=only_remote"
}
],
"searchQueries": [
"Sales"
],
"locations": ["USA"],
"countryCodes": ["US"],
"searchMode": "auto",
"apiKey": "YOUR_ZIPRECRUITER_SEARCH_API_KEY",
"maxItems": 100,
"jobsPerPage": 25,
"pagesPerSearch": 1,
"radiusMiles": 25,
"daysAgo": 7,
"employmentType": "full_time",
"locationType": "only_remote",
"minAnnualSalary": 100000,
"maxAnnualSalary": 180000,
"applyType": "one_click_apply",
"experienceLevel": "senior_level",
"includeEmptyFilterParams": false,
"seniorityFiltersExplicitlySet": false,
"applyTypesExplicitlySet": false,
"employmentTypesExplicitlySet": false,
"locationTypesExplicitlySet": false,
"linkKey": "hGEq63bjJQ2bOUaqEdaVJA",
"includeJobDetails": true,
"fallbackToSearchUrls": true,
"pushFallbackSearchUrls": true,
"deduplicate": true,
"incrementalMode": false,
"incrementalStoreName": "ziprecruiter-incremental",
"delayMs": 250,
"proxyConfig": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"],
"apifyProxyCountry": "US"
}
}
```
You can also provide the API key as `ZIPRECRUITER_SEARCH_API_KEY` or `ZIPRECRUITER_API_KEY`.
### Supported Search Filters
The actor currently maps these web search parameters:
- `locations`: becomes ZipRecruiter's `location` parameter. Pass multiple locations to fan out searches.
- `countryCodes`: generated searches can target `US`, `CA`, `GB`, `IE`, `IN`, `DE`, `FR`, or `NZ`. URL-based searches use the domain from each `startUrls` entry.
- `startUrls`: direct ZipRecruiter search or job URLs. Existing query parameters are preserved and paginated with `page`.
- `daysAgo`: becomes `days` in web mode and `days_ago` in API mode. Use `1`, `7`, `14`, `30`, etc.
- `radiusMiles`: becomes `radius` in web mode and `radius_miles` in API mode. ZipRecruiter web search normalizes very small radii to 25 miles.
- `employmentType`: maps to `refine_by_employment`, e.g. `full_time`, `part_time`, `contract`, `temporary`, `internship`.
- `locationType`: maps to `refine_by_location_type`, e.g. `remote`, `only_remote`, `hybrid`, `in_person`, `remote_optional`.
- `minAnnualSalary` and `maxAnnualSalary`: map to `refine_by_salary` and `refine_by_salary_ceil`.
- `applyType`: maps to `refine_by_apply_type`, currently `one_click_apply`.
- `experienceLevel`: maps to `refine_by_experience_level`, e.g. `entry_level`, `mid_level`, `senior_level`.
- `includeEmptyFilterParams`: includes empty `refine_by_*` parameters for filters left as `Any`, matching ZipRecruiter's browser URLs more closely.
- `seniorityFiltersExplicitlySet`, `applyTypesExplicitlySet`, `employmentTypesExplicitlySet`, and `locationTypesExplicitlySet`: add ZipRecruiter's `*_explicitly_set=` URL markers.
- `linkKey`: advanced passthrough for ZipRecruiter's opaque `lk` query parameter when copied from a browser URL.
- `extraSearchParams`: raw escape hatch for newly discovered query parameters. Empty string values are preserved.
- `incrementalMode`: saves fingerprints in a named key-value store and emits only new or changed jobs on later runs.
- `pushFallbackSearchUrls`: set to `false` when using pay-per-job pricing so generated fallback links are saved to `FALLBACK_SEARCH_URLS` but not counted as dataset result rows.
- `proxyConfig`: required for Apify runs. Defaults to US residential Apify Proxy (`RESIDENTIAL`, country `US`) because ZipRecruiter blocks direct Apify datacenter egress.
### Recommended Pricing
Recommended launch pricing is pay-per-event with platform usage included:
| Event | Price | Notes |
|-------|-------|-------|
| `apify-actor-start` | $0.00005/run | Synthetic start event; keep Apify's default and do not charge manually in code. |
| `job-extracted` | $3.75 / 1,000 jobs | Primary event, charged for job records pushed to the dataset. |
Configure these events in Apify Monetization before Store publication. The actor code emits `job-extracted`; the synthetic start event is handled by Apify.
This prices the actor between the cheapest direct ZipRecruiter competitors and the higher-priced detail-enrichment actors while protecting residential proxy margin. Fallback `search_url` rows should remain free or disabled with `pushFallbackSearchUrls: false` for paid Store runs.
### Output
Job rows look like:
```json
{
"type": "job",
"source": "ziprecruiter",
"sourceMode": "web",
"countryCode": "US",
"searchQuery": "Fire Alarm Technician",
"searchLocation": "Westbury, NY",
"externalId": "VklYGmxpudK3jnCJl23TbA",
"listingVersionKey": "VklYGmxpudK3jnCJl23TbA",
"encryptedQuizId": "827e0df3",
"title": "Full-Time Alarm technicians",
"company": "Securetell Inc",
"companyUrl": "https://www.ziprecruiter.com/co/Securetell-Inc/Jobs",
"companyUuid": "zr_missing_company_default",
"location": "Westbury, NY",
"city": "Westbury",
"state": "NY",
"postalCode": "11590",
"latitude": 40.75566101074219,
"longitude": -73.5876235961914,
"url": "https://www.ziprecruiter.com/c/Securetell-Inc/Job/Full-Time-Alarm-technicians/-in-Westbury,NY?jid=dff3b05032fd7e28",
"applyUrl": "https://www.ziprecruiter.com/jobs/apply/...",
"directApply": true,
"hasZipApply": true,
"isExternalApply": false,
"quickApplyUrl": "https://www.ziprecruiter.com/jobs/apply/...",
"description": "Growing Alarm Company based in Nassau County is looking for Full-Time technicians...",
"descriptionHtml": "Job Description
...
",
"snippet": "Growing Alarm Company based in Nassau County is looking for Full-Time technicians...",
"salary": "$25 Hourly",
"formattedSalaryShort": "$25 / hr",
"salaryMin": 25,
"salaryMax": 25,
"salaryCurrency": "USD",
"salaryPeriod": "hour",
"salarySource": "provided",
"employmentType": "Full-Time",
"benefits": ["Paid Time Off", "Retirement"],
"isRemote": false,
"isHybrid": false,
"postedAt": "2026-04-08T23:44:29Z",
"postedTime": "24 days ago",
"industry": "Real Estate",
"companyDetails": {
"name": "Securetell Inc",
"city": "Westbury",
"state": "NY",
"countryCode": "USA",
"postalCode": "11590",
"joinedYear": "2021",
"followers": 14
},
"applyDetails": {
"hasZipApply": true,
"destination": "Internal",
"applyButtonType": "Open Apply Flow"
},
"statusDetails": {
"isActive": true,
"isClosed": false,
"postedTime": "24 days ago"
},
"jobPageImage": {
"url": "https://www.ziprecruiter.com/...",
"alt": "Securetell Inc job posting for a Full-Time Alarm technicians in Westbury, NY..."
},
"zipRecruiter": {
"listingVersionKey": "VklYGmxpudK3jnCJl23TbA",
"encryptedQuizId": "827e0df3",
"impressionId": "5Z6lVs8Bhgoo29-8"
},
"fingerprint": "d9b8...",
"scrapedAt": "2026-04-23T12:00:00.000Z",
"raw": {},
"rawSources": {}
}
```
The actor keeps the stable fields above table-friendly while also preserving source payloads in `raw` and `rawSources`. When ZipRecruiter exposes richer page data, the output includes apply/status metadata, listing identifiers, salary display strings, company details, job page image data, and ZipRecruiter-specific metadata in normalized camelCase fields.
Fallback mode emits rows like:
```json
{
"type": "search_url",
"source": "ziprecruiter",
"searchQuery": "Senior Patching Engineer",
"searchLocation": "Remote",
"searchUrl": "https://www.ziprecruiter.com/Jobs/Remote-Senior-Patching-Engineer?search=Senior+Patching+Engineer&location=Remote",
"reason": "missing_api_key"
}
```
### Local Development
Install dependencies:
```bash
npm install
```
Build:
```bash
npm run build
```
Run locally with pure HTTP web search:
```bash
CROWDPULL_DISABLE_DEFAULT_PROXY=1 apify run --input '{"searchMode":"web","searchQueries":["Senior Patching Engineer"],"locations":["Remote"],"daysAgo":7,"locationType":"remote","employmentType":"full_time","minAnnualSalary":100000,"maxItems":5,"includeJobDetails":true}'
```
Run locally with fallback URLs only:
```bash
CROWDPULL_DISABLE_DEFAULT_PROXY=1 apify run --input '{"searchMode":"fallbackUrls","searchQueries":["Senior Patching Engineer"],"locations":["Remote"]}'
```
Dataset output is written under `storage/datasets/default`.
Run locally from a copied ZipRecruiter search URL:
```bash
CROWDPULL_DISABLE_DEFAULT_PROXY=1 apify run --input '{"searchMode":"web","startUrls":[{"url":"https://www.ziprecruiter.com/jobs-search?search=data+engineer&location=Remote&days=7"}],"maxItems":5,"includeJobDetails":true}'
```
Run locally in incremental mode:
```bash
CROWDPULL_DISABLE_DEFAULT_PROXY=1 apify run --input '{"searchMode":"web","searchQueries":["Senior Patching Engineer"],"locations":["Remote"],"maxItems":5,"incrementalMode":true,"incrementalStoreName":"ziprecruiter-incremental-dev"}'
```
`CROWDPULL_DISABLE_DEFAULT_PROXY=1` is only for local development where Apify Proxy credentials are not available. Do not use it for production Apify runs.
### SignalApply Integration
The SignalApply app can call this actor as a source adapter:
1. Build search specs from the candidate profile and target roles.
2. Run the actor in `auto` or `web` mode.
3. Pull dataset items from the run.
4. Import `type: "job"` rows into SignalApply's `jobs` table.
5. Score, rank, and generate review-before-apply packets in the app.
No auto-submit is included. Application submission should remain human-approved.
# Actor input Schema
## `startUrls` (type: `array`):
Optional ZipRecruiter search result or job detail URLs. Search URL filters are preserved exactly, including radius, salary, employment type, and date filters.
## `searchQueries` (type: `array`):
Job titles or keywords to search for.
## `locations` (type: `array`):
Locations to search. Use USA for nationwide US results.
## `countryCodes` (type: `array`):
ZipRecruiter country domains to search for generated keyword/location searches. Supported: US, CA, GB, IE, IN, DE, FR, NZ.
## `apiKey` (type: `string`):
Optional. In auto mode, a key makes generated keyword/location searches use the ZipRecruiter Search API unless start URLs are supplied. Without a key, auto mode uses pure HTTP web search.
## `searchMode` (type: `string`):
Auto uses API when a key exists and no start URLs are supplied, otherwise HTTP web search. API requires a key. Web uses pure HTTP search parsing. Fallback URLs only emits manual search links.
## `maxItems` (type: `integer`):
Maximum number of job rows to emit. Set to 0 for unlimited within the query/page limits.
## `jobsPerPage` (type: `integer`):
Number of jobs requested per ZipRecruiter API page.
## `pagesPerSearch` (type: `integer`):
Number of API pages to fetch for each query/location pair.
## `radiusMiles` (type: `integer`):
Search radius in miles. Web mode uses ZipRecruiter's radius parameter, usually normalized to 25 miles minimum.
## `daysAgo` (type: `integer`):
Only return jobs posted within this many days. Web mode sends this as days; API mode sends this as days\_ago. Set 0 for no date filter.
## `employmentType` (type: `string`):
Filter web results by employment type.
## `locationType` (type: `string`):
Filter web results by remote/hybrid/on-site signal.
## `minAnnualSalary` (type: `integer`):
Filter web results by minimum annual salary when ZipRecruiter supports it for the query.
## `maxAnnualSalary` (type: `integer`):
Filter web results by maximum annual salary ceiling when ZipRecruiter supports it for the query.
## `applyType` (type: `string`):
Filter web results by apply type. Currently maps quick\_apply to ZipRecruiter's one\_click\_apply value.
## `experienceLevel` (type: `string`):
Filter web results by seniority signal.
## `includeEmptyFilterParams` (type: `boolean`):
When true, generated web search URLs include empty refine\_by\_\* parameters for filters left as Any, matching ZipRecruiter's browser URLs more closely.
## `seniorityFiltersExplicitlySet` (type: `boolean`):
Adds seniority\_filters\_explicitly\_set= to generated web search URLs.
## `applyTypesExplicitlySet` (type: `boolean`):
Adds apply\_types\_explicitly\_set= to generated web search URLs.
## `employmentTypesExplicitlySet` (type: `boolean`):
Adds employment\_types\_explicitly\_set= to generated web search URLs.
## `locationTypesExplicitlySet` (type: `boolean`):
Adds location\_types\_explicitly\_set= to generated web search URLs.
## `linkKey` (type: `string`):
Advanced passthrough for ZipRecruiter's lk query parameter. This is usually an opaque browser/session token copied from a URL.
## `extraSearchParams` (type: `object`):
Advanced escape hatch for raw ZipRecruiter web query parameters discovered later. Empty string values are preserved.
## `includeJobDetails` (type: `boolean`):
When web mode is used, fetch each result URL and parse JobPosting JSON-LD for description, company, location, salary, and dates.
## `fallbackToSearchUrls` (type: `boolean`):
When true and API/web search does not return results, generate one search\_url row per search. Rows are always saved to the FALLBACK\_SEARCH\_URLS key-value record.
## `pushFallbackSearchUrls` (type: `boolean`):
When true, fallback search\_url rows are also pushed to the default dataset. Turn off for pay-per-job pricing so fallback links are not counted as job results.
## `deduplicate` (type: `boolean`):
Deduplicate jobs within a single run by URL, external ID, or title/company/location.
## `incrementalMode` (type: `boolean`):
When true, recurring runs emit only jobs that are new or whose tracked content changed after re-fetching them.
## `incrementalStoreName` (type: `string`):
Named key-value store used for incremental state across runs.
## `delayMs` (type: `integer`):
Polite delay between HTTP requests.
## `proxyConfig` (type: `object`):
Required. ZipRecruiter blocks direct Apify datacenter egress in remote runs; US residential Apify Proxy is the default and recommended setting, especially for detail-page enrichment.
## Actor input object example
```json
{
"startUrls": [
{
"url": "https://www.ziprecruiter.com/jobs-search?search=Sales&location=USA&refine_by_location_type=only_remote"
}
],
"searchQueries": [
"Sales"
],
"locations": [
"USA"
],
"countryCodes": [
"US"
],
"searchMode": "auto",
"maxItems": 100,
"jobsPerPage": 25,
"pagesPerSearch": 1,
"radiusMiles": 25,
"daysAgo": 0,
"employmentType": "",
"locationType": "only_remote",
"minAnnualSalary": 0,
"maxAnnualSalary": 0,
"applyType": "",
"experienceLevel": "",
"includeEmptyFilterParams": false,
"seniorityFiltersExplicitlySet": false,
"applyTypesExplicitlySet": false,
"employmentTypesExplicitlySet": false,
"locationTypesExplicitlySet": false,
"includeJobDetails": true,
"fallbackToSearchUrls": true,
"pushFallbackSearchUrls": true,
"deduplicate": true,
"incrementalMode": false,
"incrementalStoreName": "ziprecruiter-incremental",
"delayMs": 250,
"proxyConfig": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "US"
}
}
```
# Actor output Schema
## `results` (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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"startUrls": [
{
"url": "https://www.ziprecruiter.com/jobs-search?search=Sales&location=USA&refine_by_location_type=only_remote"
}
],
"searchQueries": [
"Sales"
],
"locations": [
"USA"
],
"countryCodes": [
"US"
],
"maxItems": 100
};
// Run the Actor and wait for it to finish
const run = await client.actor("crowdpull/crowdpull-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 = {
"startUrls": [{ "url": "https://www.ziprecruiter.com/jobs-search?search=Sales&location=USA&refine_by_location_type=only_remote" }],
"searchQueries": ["Sales"],
"locations": ["USA"],
"countryCodes": ["US"],
"maxItems": 100,
}
# Run the Actor and wait for it to finish
run = client.actor("crowdpull/crowdpull-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 '{
"startUrls": [
{
"url": "https://www.ziprecruiter.com/jobs-search?search=Sales&location=USA&refine_by_location_type=only_remote"
}
],
"searchQueries": [
"Sales"
],
"locations": [
"USA"
],
"countryCodes": [
"US"
],
"maxItems": 100
}' |
apify call crowdpull/crowdpull-ziprecruiter-jobs-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=crowdpull/crowdpull-ziprecruiter-jobs-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "ZipRecruiter Jobs Scraper — Remote Jobs, Salaries & Details",
"description": "Extract ZipRecruiter jobs by keyword, location, or direct URL. Supports remote filters, salary and apply fields, detail enrichment, US residential proxy defaults, and in-run deduplication.",
"version": "0.4",
"x-build-id": "HaMZ6US9rS359UVms"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/crowdpull~crowdpull-ziprecruiter-jobs-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-crowdpull-crowdpull-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/crowdpull~crowdpull-ziprecruiter-jobs-scraper/runs": {
"post": {
"operationId": "runs-sync-crowdpull-crowdpull-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/crowdpull~crowdpull-ziprecruiter-jobs-scraper/run-sync": {
"post": {
"operationId": "run-sync-crowdpull-crowdpull-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",
"required": [
"proxyConfig"
],
"properties": {
"startUrls": {
"title": "Start URLs",
"type": "array",
"description": "Optional ZipRecruiter search result or job detail URLs. Search URL filters are preserved exactly, including radius, salary, employment type, and date filters.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL",
"description": "ZipRecruiter search result or job detail URL."
}
}
}
},
"searchQueries": {
"title": "Search Queries",
"type": "array",
"description": "Job titles or keywords to search for.",
"items": {
"type": "string"
}
},
"locations": {
"title": "Locations",
"type": "array",
"description": "Locations to search. Use USA for nationwide US results.",
"items": {
"type": "string"
}
},
"countryCodes": {
"title": "Country Codes",
"type": "array",
"description": "ZipRecruiter country domains to search for generated keyword/location searches. Supported: US, CA, GB, IE, IN, DE, FR, NZ.",
"items": {
"type": "string"
}
},
"apiKey": {
"title": "ZipRecruiter Search API Key",
"type": "string",
"description": "Optional. In auto mode, a key makes generated keyword/location searches use the ZipRecruiter Search API unless start URLs are supplied. Without a key, auto mode uses pure HTTP web search."
},
"searchMode": {
"title": "Search Mode",
"enum": [
"auto",
"api",
"web",
"fallbackUrls"
],
"type": "string",
"description": "Auto uses API when a key exists and no start URLs are supplied, otherwise HTTP web search. API requires a key. Web uses pure HTTP search parsing. Fallback URLs only emits manual search links.",
"default": "auto"
},
"maxItems": {
"title": "Max Jobs",
"minimum": 0,
"maximum": 10000,
"type": "integer",
"description": "Maximum number of job rows to emit. Set to 0 for unlimited within the query/page limits.",
"default": 100
},
"jobsPerPage": {
"title": "Jobs Per API Page",
"minimum": 1,
"maximum": 100,
"type": "integer",
"description": "Number of jobs requested per ZipRecruiter API page.",
"default": 25
},
"pagesPerSearch": {
"title": "Pages Per Search",
"minimum": 1,
"maximum": 20,
"type": "integer",
"description": "Number of API pages to fetch for each query/location pair.",
"default": 1
},
"radiusMiles": {
"title": "Radius Miles",
"minimum": 0,
"maximum": 5000,
"type": "integer",
"description": "Search radius in miles. Web mode uses ZipRecruiter's radius parameter, usually normalized to 25 miles minimum.",
"default": 25
},
"daysAgo": {
"title": "Posted Within Days",
"minimum": 0,
"maximum": 90,
"type": "integer",
"description": "Only return jobs posted within this many days. Web mode sends this as days; API mode sends this as days_ago. Set 0 for no date filter.",
"default": 0
},
"employmentType": {
"title": "Employment Type",
"enum": [
"",
"full_time",
"part_time",
"contract",
"temporary",
"internship"
],
"type": "string",
"description": "Filter web results by employment type.",
"default": ""
},
"locationType": {
"title": "Location Type",
"enum": [
"",
"remote",
"only_remote",
"hybrid",
"in_person",
"remote_optional"
],
"type": "string",
"description": "Filter web results by remote/hybrid/on-site signal.",
"default": "only_remote"
},
"minAnnualSalary": {
"title": "Minimum Annual Salary",
"minimum": 0,
"maximum": 1000000,
"type": "integer",
"description": "Filter web results by minimum annual salary when ZipRecruiter supports it for the query.",
"default": 0
},
"maxAnnualSalary": {
"title": "Maximum Annual Salary",
"minimum": 0,
"maximum": 1000000,
"type": "integer",
"description": "Filter web results by maximum annual salary ceiling when ZipRecruiter supports it for the query.",
"default": 0
},
"applyType": {
"title": "Apply Type",
"enum": [
"",
"one_click_apply"
],
"type": "string",
"description": "Filter web results by apply type. Currently maps quick_apply to ZipRecruiter's one_click_apply value.",
"default": ""
},
"experienceLevel": {
"title": "Experience Level",
"enum": [
"",
"entry_level",
"mid_level",
"senior_level"
],
"type": "string",
"description": "Filter web results by seniority signal.",
"default": ""
},
"includeEmptyFilterParams": {
"title": "Include Empty Filter Parameters",
"type": "boolean",
"description": "When true, generated web search URLs include empty refine_by_* parameters for filters left as Any, matching ZipRecruiter's browser URLs more closely.",
"default": false
},
"seniorityFiltersExplicitlySet": {
"title": "Seniority Filters Explicitly Set",
"type": "boolean",
"description": "Adds seniority_filters_explicitly_set= to generated web search URLs.",
"default": false
},
"applyTypesExplicitlySet": {
"title": "Apply Types Explicitly Set",
"type": "boolean",
"description": "Adds apply_types_explicitly_set= to generated web search URLs.",
"default": false
},
"employmentTypesExplicitlySet": {
"title": "Employment Types Explicitly Set",
"type": "boolean",
"description": "Adds employment_types_explicitly_set= to generated web search URLs.",
"default": false
},
"locationTypesExplicitlySet": {
"title": "Location Types Explicitly Set",
"type": "boolean",
"description": "Adds location_types_explicitly_set= to generated web search URLs.",
"default": false
},
"linkKey": {
"title": "Link Key",
"type": "string",
"description": "Advanced passthrough for ZipRecruiter's lk query parameter. This is usually an opaque browser/session token copied from a URL."
},
"extraSearchParams": {
"title": "Extra Search Parameters",
"type": "object",
"description": "Advanced escape hatch for raw ZipRecruiter web query parameters discovered later. Empty string values are preserved."
},
"includeJobDetails": {
"title": "Fetch Job Details",
"type": "boolean",
"description": "When web mode is used, fetch each result URL and parse JobPosting JSON-LD for description, company, location, salary, and dates.",
"default": true
},
"fallbackToSearchUrls": {
"title": "Generate Search URLs Without API Key",
"type": "boolean",
"description": "When true and API/web search does not return results, generate one search_url row per search. Rows are always saved to the FALLBACK_SEARCH_URLS key-value record.",
"default": true
},
"pushFallbackSearchUrls": {
"title": "Push Fallback URLs to Dataset",
"type": "boolean",
"description": "When true, fallback search_url rows are also pushed to the default dataset. Turn off for pay-per-job pricing so fallback links are not counted as job results.",
"default": true
},
"deduplicate": {
"title": "Deduplicate Results",
"type": "boolean",
"description": "Deduplicate jobs within a single run by URL, external ID, or title/company/location.",
"default": true
},
"incrementalMode": {
"title": "Incremental Mode",
"type": "boolean",
"description": "When true, recurring runs emit only jobs that are new or whose tracked content changed after re-fetching them.",
"default": false
},
"incrementalStoreName": {
"title": "Incremental Store Name",
"type": "string",
"description": "Named key-value store used for incremental state across runs.",
"default": "ziprecruiter-incremental"
},
"delayMs": {
"title": "Delay Between HTTP Requests (ms)",
"minimum": 0,
"maximum": 10000,
"type": "integer",
"description": "Polite delay between HTTP requests.",
"default": 250
},
"proxyConfig": {
"title": "Proxy Configuration",
"type": "object",
"description": "Required. ZipRecruiter blocks direct Apify datacenter egress in remote runs; US residential Apify Proxy is the default and recommended setting, especially for detail-page enrichment.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "US"
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```