Hiring.cafe API: Search jobs (v1)

Returns one page of Hiring.cafe jobs, 40 companies with up to 4 jobs each, with title, company, location, workplace type, commitment, seniority, listed pay, skills and posting time. Search worldwide or around a city, state or country. Hiring.cafe serves 250 pages of a search.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

query?string

Keywords or a job title, such as python developer or nurse. Leave empty to list every job that matches the filters.

Lengthlength <= 200

Default""

location?string

A city, state, country or continent, such as Austin, TX, Berlin, Germany or Europe. A city covers 50 miles around it, as on hiringcafe.com. Leave empty, or pass worldwide, to search every country.

Lengthlength <= 200

workplace?string

remote, hybrid, onsite or field jobs only; any keeps all of them.

Default"any"

Value in

"any"
"remote"
"hybrid"
"onsite"
"field"

commitment?string

full_time, part_time, contract, internship, temporary, seasonal or volunteer jobs only.

Default"any"

Value in

"any"
"full_time"
"part_time"
"contract"
"internship"
"temporary"
"seasonal"
"volunteer"

seniority?string

no_experience (no prior experience required), entry, mid or senior level jobs only.

Default"any"

Value in

"any"
"no_experience"
"entry"
"mid"
"senior"

posted_within?string

Jobs posted in this window. Defaults to 3_months, as on hiringcafe.com; any searches every date.

Default"3_months"

Value in

"day"
"3_days"
"week"
"2_weeks"
"month"
"2_months"
"3_months"
"6_months"
"year"
"any"

sort?string

relevance (the default), newest, oldest, salary_high, salary_low, least_experience or most_experience.

Default"relevance"

Value in

"relevance"
"newest"
"oldest"
"salary_high"
"salary_low"
"least_experience"
"most_experience"

page?integer

One-based page. A page holds 40 companies with up to 4 jobs each. Hiring.cafe serves 250 pages of one search.

Range1 <= value <= 250

Default1

curl -X GET "https://example.com/v1/hiringcafe/search" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "query": "python developer",    "location": "Austin, TX",    "resolved_location": "Austin, TX, US",    "workplace": "string",    "commitment": "string",    "seniority": "string",    "posted_within": "string",    "sort": "string",    "page": 1,    "page_size": 40,    "total": 127029,    "company_count": 15413,    "max_page": 250,    "has_more": true,    "count": 0,    "url": "string",    "stop_reason": null,    "results": [      {        "job_id": "u48q28wr6yxu5q1i",        "url": "https://hiringcafe.com/job/u48q28wr6yxu5q1i",        "apply_url": "string",        "title": "Senior Data Engineer",        "core_title": "Data Engineer",        "company": {          "name": "Cox Enterprises",          "website": "https://www.coxenterprises.com",          "tagline": "string",          "industries": [            "Telecommunications",            "Software & SaaS"          ],          "sector": "Information Technology",          "hq_country": "US",          "employees": 50000,          "year_founded": 1898,          "organization_type": "Private",          "stock_symbol": "CHE.UN",          "stock_exchange": "TSX",          "latest_funding_type": "Series B",          "latest_funding_amount": 250000000,          "latest_funding_year": 2025        },        "location": "Austin, Texas, United States",        "cities": [          "Austin, Texas, US"        ],        "countries": [          "US"        ],        "workplace": "hybrid",        "commitment": [          "full_time"        ],        "seniority": "senior",        "category": "Software Development",        "role_type": "Individual Contributor",        "salary": {          "min": 134900,          "max": 224900,          "currency": "USD",          "period": "yearly",          "yearly_min": 134900,          "yearly_max": 224900        },        "min_years_experience": 7,        "requirements_summary": "string",        "skills": [          "Python",          "Snowflake",          "AWS"        ],        "visa_sponsorship": true,        "posted_at": "2026-11-05T12:00:00.000Z",        "source": "icims2",        "is_expired": true      }    ]  },  "details": {    "reason": "string",    "message": "string"  }}