| Search ZipRecruiter with its own filters (job type, date posted, remote or hybrid, experience level, salary range, distance and 1-Click Apply) and get 56 fields per job, including ZipRecruiter's pay estimates, the full description, company profile, and the employer's own apply link. |
New York, NY), a ZIP code, a state, or United States. Enter Remote to find remote jobs nationwide. Defaults to the whole United States.
## `startUrls` (type: `array`):
Paste ZipRecruiter search URLs (https://www.ziprecruiter.com/jobs-search?search=nurse\&location=Chicago%2C+IL), category pages (https://www.ziprecruiter.com/Jobs/Nurse/-in-Chicago,IL) or job URLs (containing ?jid=). Filters in a search URL are kept as pasted.
## `jobType` (type: `string`):
Show only one employment type. Applies to keyword searches.
## `postedWithin` (type: `string`):
Show only jobs posted within this period.
## `remoteType` (type: `string`):
Show only remote, hybrid or on-site jobs.
## `experienceLevel` (type: `string`):
Show only jobs for one seniority level.
## `salaryRange` (type: `string`):
Enter a minimum annual salary in US dollars, such as 50000 for $50K+.
## `salaryMax` (type: `string`):
Enter a maximum annual salary in US dollars, such as 120000. Leave empty for no upper limit.
## `radius` (type: `string`):
Search radius around the location. Ignored for state- and country-level locations.
## `easyApplyOnly` (type: `boolean`):
Show only jobs you can apply to directly on ZipRecruiter.
## `maxItems` (type: `integer`):
Stop after saving this many jobs in total, across all searches and URLs.
## `maxPages` (type: `integer`):
Read at most this many result pages per search (20 jobs per page). ZipRecruiter shows up to about 25 pages (~500 jobs) per search; split large searches by location or filters to get more.
## `includeDetails` (type: `boolean`):
Open each job page to add the full description, industry, category, expiry date, company profile and rating, and the employer's own apply link. Each job with details is charged an extra details event (see Pricing in the README). Off = faster, cheaper runs with search-card data: title, company, salary, benefits, location, workplace type, job type, short description and posting date. Job URLs pasted in 'ZipRecruiter URLs' always include details.
## `concurrency` (type: `integer`):
Number of job pages to load in parallel when job details are on.
## `requestTimeout` (type: `integer`):
Give up on a single request after this many seconds and retry.
## `debugMode` (type: `boolean`):
Log the filters sent to ZipRecruiter.
## `proxyConfiguration` (type: `object`):
Leave empty. ZipRecruiter refuses Apify's own and proxy IPs, so the scraper connects through Apify's unblocking proxy automatically (included in the price). Set a proxy here only to force your own.
## Actor input object example
```json
{
"searches": [
"software engineer"
],
"location": "New York, NY",
"jobType": "",
"postedWithin": "anytime",
"remoteType": "",
"experienceLevel": "",
"salaryRange": "",
"salaryMax": "",
"radius": "25",
"easyApplyOnly": false,
"maxItems": 10,
"maxPages": 25,
"includeDetails": false,
"concurrency": 10,
"requestTimeout": 30,
"debugMode": false,
"proxyConfiguration": {
"useApifyProxy": false
}
}
```
# Actor output Schema
## `dataset` (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 '