# ZipRecruiter API: Search jobs > Finds open ZipRecruiter jobs by keywords and location, with distance and posting-date filters. Returns up to 100 public listings in search order; details that are not shown are null. Unofficial. Not affiliated with or endorsed by ZipRecruiter. - Page: https://fous.com/methods/ziprecruiter.com/search-jobs - Method: `ziprecruiter.com/search_jobs`, version 1 - Website: ziprecruiter.com - Returns: title, company, location, remote, pay range and period, employment type, posted date, short description, job link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `keywords` | string | yes | `"forklift operator"` | Job title or search words, for example forklift operator. | | `location` | string | yes | `"Phoenix, AZ"` | City, state or ZIP code, for example Phoenix, AZ. | | `max_results` | integer | no | | Maximum jobs to return, for example 25. Default 25. | | `posted_within` | string | no | | How recently the job was posted, for example last_5_days. One of "last_day", "last_5_days", "last_10_days", "last_30_days", "any". Default "any". | | `distance_miles` | integer | no | | Search radius in miles, for example 25. One of 5, 10, 25, 50, 100. Default 25. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "keywords": "forklift operator", "location": "Phoenix, AZ" } ``` Its output: ```json { "jobs": [ { "pay": "$22 - $26.50/hr", "title": "Manufacturing Specialist", "remote": "no", "company": "American Fence Company", "currency": "USD", "job_link": "https://www.ziprecruiter.com/c/American-Fence-Company/Job/Manufacturing-Specialist/-in-Phoenix,AZ?jid=09cbc459b629bfeb", "location": "Phoenix, AZ", "pay_period": "hour", "pay_maximum": 26.5, "pay_minimum": 22, "posted_date": "2026-09-27", "employment_type": "Full-time", "short_description": "American Tube and Pipe is looking for a End Table Operator to assist with manufacturing of our tubes and pipes in our mill. We have a competitive starting pay of $22.00 to $26.50 /hour with a full" }, { "pay": null, "title": "Experienced Crane Operator", "remote": "no", "company": "Smiley Crane Service", "currency": null, "job_link": "https://www.ziprecruiter.com/c/Smiley-Crane-Service/Job/Experienced-Crane-Operator/-in-Phoenix,AZ?jid=fb3070d7a50c14a9", "location": "Phoenix, AZ", "pay_period": null, "pay_maximum": null, "pay_minimum": null, "posted_date": "2026-09-21", "employment_type": "Full-time", "short_description": "Smiley Lifting Solutions runs one of the most varied fleets in Arizona on both our taxi fleet mobile cranes and long term project job sites. If you want steady work, well-maintained equipment, and" }, { "pay": "$22 - $24/hr", "title": "Material Handler/Sit-Down Forklift Operator", "remote": "no", "company": "KINEMATICS LLC", "currency": "USD", "job_link": "https://www.ziprecruiter.com/c/KINEMATICS-LLC/Job/Material-Handler-Sit-Down-Forklift-Operator/-in-Phoenix,AZ?jid=bce326483f297c3a", "location": "Phoenix, AZ", "pay_period": "hour", "pay_maximum": 24, "pay_minimum": 22, "posted_date": "2026-09-09", "employment_type": "Full-time", "short_description": "Description: About Kinematics: Kinematics creates motion control solutions for mission-critical systems in demanding environments. Based in the U.S. with six global manufacturing centers and seven" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"ziprecruiter.com/search_jobs","input":{"keywords":"forklift operator","location":"Phoenix, AZ"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find forklift operator jobs within 10 miles of Phoenix, AZ posted in the last 5 days, and show pay ranges and employment type. - Pull up to 50 registered nurse openings near Columbus, OH from ZipRecruiter, any posting date, 50-mile radius. - What warehouse associate positions have been posted in the last 24 hours around ZIP 30318? Keep it to 5 miles. - I'm looking for remote-friendly data analyst roles listed on ziprecruiter.com near Denver, CO — give me the 15 most relevant from the past month with links. - List CDL truck driver jobs within 100 miles of Fresno, California posted in the last 10 days, including company, pay, and a short description. ## Input schema ```json { "type": "object", "required": [ "keywords", "location" ], "properties": { "keywords": { "type": "string", "minLength": 1, "description": "Job title or search words, for example forklift operator." }, "location": { "type": "string", "minLength": 1, "description": "City, state or ZIP code, for example Phoenix, AZ." }, "max_results": { "type": "integer", "default": 25, "maximum": 100, "minimum": 1, "description": "Maximum jobs to return, for example 25." }, "posted_within": { "enum": [ "last_day", "last_5_days", "last_10_days", "last_30_days", "any" ], "type": "string", "default": "any", "description": "How recently the job was posted, for example last_5_days." }, "distance_miles": { "enum": [ 5, 10, 25, 50, 100 ], "type": "integer", "default": 25, "description": "Search radius in miles, for example 25." } } } ``` ## Output schema ```json { "type": "object", "required": [ "jobs" ], "properties": { "jobs": { "type": "array", "items": { "type": "object", "required": [ "pay", "title", "remote", "company", "currency", "job_link", "location", "pay_period", "pay_maximum", "pay_minimum", "posted_date", "employment_type", "short_description" ], "properties": { "pay": { "type": [ "string", "null" ] }, "title": { "type": "string" }, "remote": { "enum": [ "yes", "no" ], "type": "string" }, "company": { "type": [ "string", "null" ] }, "currency": { "type": [ "string", "null" ] }, "job_link": { "type": "string" }, "location": { "type": [ "string", "null" ] }, "pay_period": { "type": [ "string", "null" ] }, "pay_maximum": { "type": [ "number", "null" ] }, "pay_minimum": { "type": [ "number", "null" ] }, "posted_date": { "type": [ "string", "null" ] }, "employment_type": { "type": [ "string", "null" ] }, "short_description": { "type": [ "string", "null" ] } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [ZipRecruiter API: Get salary for a job title](https://fous.com/methods/ziprecruiter.com/get-salary.md): Looks up ZipRecruiter's salary page for a job title in the United States or one US state and returns typical pay, the percentile range and the top-paying cities. Only salary pages that exist publicly are returned. - [LinkedIn API: Search jobs](https://fous.com/methods/linkedin.com/search-jobs.md): Searches public LinkedIn job listings by keywords and location, with optional date, seniority, employment type and company filters. - [SEEK API: Search jobs](https://fous.com/methods/seek.com.au/search-jobs.md): Finds current SEEK jobs in Australia by keywords, with optional location, work type and posting window. Results follow SEEK search order; some promoted listings may appear outside the selected posting window. - [Indeed API: Search jobs](https://fous.com/methods/indeed.com/search-jobs.md): Searches open Indeed jobs by keywords, location, country, posting age and job type, returning public first-page results in displayed order. - [Remote OK API: Search remote jobs](https://fous.com/methods/remoteok.com/search-jobs.md): Searches Remote OK jobs by role or skill. Results can be filtered by listed region and by minimum annual USD salary. - [Naukri API: Search jobs](https://fous.com/methods/naukri.com/search-jobs.md): Finds open public Naukri job listings by keywords, with optional city and experience filters, in Naukri's search order. Undisclosed salaries have no numeric range. - [USAJOBS API: Search federal jobs](https://fous.com/methods/usajobs.gov/search-jobs.md): Searches USAJOBS federal jobs by keywords, location, salary threshold and applicant group, in website relevance order. Salary ranges may start below the threshold; annual pay or remote status is null when the announcement does not state it. - [LinkedIn API: List company jobs](https://fous.com/methods/linkedin.com/list-company-jobs.md): Lists open LinkedIn jobs posted by a named company, with optional location and result limit. Workplace type is returned only when LinkedIn displays it. - [All ZipRecruiter methods](https://fous.com/methods/ziprecruiter.com.md)