docs / ziprecruiter

ZipRecruiter

Job listings with full details.

base /ziprecruiter/v12 endpoints

post/ziprecruiter/v1/search1 credit

search jobs (q + location, paginated); country=tld — gb/ie/de work, us=.com is Phase-2 (returns TARGET_BLOCKED until the Connect-RPC mint ships)

Parameter	Required
query	required
location	optional
country	optional
page	optional
max_results	optional
days	optional
remote	optional

Try in playground →

post/ziprecruiter/v1/job_detail1 credit

full job detail (JobPosting: title/company/location/salary/type/desc)

Parameter	Required
job_id	required
url	optional
country	optional

Try in playground →

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
}