docs / ziprecruiter
ZipRecruiter
Job listings with full details.
base /ziprecruiter/v12 endpoints
post
/ziprecruiter/v1/search1 creditSearch live ZipRecruiter job listings by keyword and location. Covers United Kingdom (ziprecruiter.co.uk), Ireland (ziprecruiter.ie) and Germany (ziprecruiter.de). United States listings are coming soon.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Free-text job keyword: job title, skill or company name — e.g. 'software engineer', 'marketing manager'. |
| location | optional | — | City / region to filter by (e.g. 'Dublin', 'London'). Optional. |
| country = gb | optional | gb · ie · de · us | ZipRecruiter country edition to search. gb (United Kingdom), ie (Ireland) and de (Germany) are fully live; us (United States) is coming soon. Other country codes are passed through as-is. |
| page = 1 | optional | 1– | Result page number, starting at 1. Each page returns up to 20 job cards. |
| max_results = 20 | optional | 1–200 | Maximum number of job listings to return across all pages (1–200). |
| days | optional | — | Limit to jobs posted within the last N days — e.g. 7 for the past week. |
| remote = false | optional | — | If true, return only remote-friendly job listings. |
post
/ziprecruiter/v1/job_detail1 creditFull ZipRecruiter job posting: title, company, location, salary range, employment type and full description.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| job_id | required | — | ZipRecruiter job ID — the identifier in a ZipRecruiter job URL (e.g. /jobs/48f0a1b2). Provide job_id OR url. |
| url | optional | — | Full ZipRecruiter job URL — alternative to job_id (the ID is extracted automatically). |
| country = gb | optional | gb · ie · de · us | ZipRecruiter country edition to search. gb (United Kingdom), ie (Ireland) and de (Germany) are fully live; us (United States) is coming soon. Other country codes are passed through as-is. |
Example request · search
curl -X POST https://api.reefapi.com/ziprecruiter/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"software engineer","location":"Dublin","country":"ie","max_results":20}'Response shape
{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}