# 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.

- Platform: Hiring.cafe
- Request: `GET https://api.toolzerhub.com/v1/hiringcafe/search`
- Auth: `x-api-key` header
- Cost: 1 credit per successful request. Failed requests are not billed.
- Page: https://docs.toolzerhub.com/reference/hiring-cafe/search/get-hiringcafe-search

| Parameter | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `query` | query | no | string | Keywords or a job title, such as python developer or nurse. Leave empty to list every job that matches the filters. Default: . |
| `location` | query | no | 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. |
| `workplace` | query | no | enum: any, remote, hybrid, onsite, field | remote, hybrid, onsite or field jobs only; any keeps all of them. Default: any. |
| `commitment` | query | no | enum: any, full_time, part_time, contract, internship, temporary, seasonal, volunteer | full_time, part_time, contract, internship, temporary, seasonal or volunteer jobs only. Default: any. |
| `seniority` | query | no | enum: any, no_experience, entry, mid, senior | no_experience (no prior experience required), entry, mid or senior level jobs only. Default: any. |
| `posted_within` | query | no | enum: day, 3_days, week, 2_weeks, month, 2_months, 3_months, 6_months, year, any | Jobs posted in this window. Defaults to 3_months, as on hiringcafe.com; any searches every date. Default: 3_months. |
| `sort` | query | no | enum: relevance, newest, oldest, salary_high, salary_low, least_experience, most_experience | relevance (the default), newest, oldest, salary_high, salary_low, least_experience or most_experience. Default: relevance. |
| `page` | query | no | integer | One-based page. A page holds 40 companies with up to 4 jobs each. Hiring.cafe serves 250 pages of one search. Default: 1. |

## Example request

```bash
curl "https://api.toolzerhub.com/v1/hiringcafe/search" \
  -H "x-api-key: $TOOLZERHUB_API_KEY"
```

Success responses are wrapped as `{ "data": ... }`. Errors return `{ "error": { "code", "status", "message", "retryable", "details" } }`. See https://docs.toolzerhub.com/docs/responses-and-errors.