Search companies
search_companiesSearch employers by their working-hours policy.
This answers "which companies offer a 4-day week" style questions at the employer level, where the policy actually lives, rather than per listing. The same schedule_type semantics as search_jobs apply: "compressed_week" is a 4x10 and is not a 4-day week.
Two location facts are separate and are often confused. country is where the employer is based. hires_worldwide is whether it accepts applicants from any country. remote_level is its office-presence policy, and a fully-remote employer can still hire in one country only.
Each result carries the employer's name, slug, url, schedule type, full-time hours, remote level and count of open roles. get_company takes the slug and returns the full profile.
Paging works as in search_jobs: at most 25 employers per call, with page, page_size, returned, total_matching, has_more and next_page.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-based page number. Default 1, maximum 200. | |
| sort | No | Result order. One of score (work-life score, highest first), jobs (most open roles), alphabetical, newest. Omit for the site's default order. | |
| limit | No | Results per page. Default 10, maximum 25. | |
| query | No | Free-text search over company name and website. | |
| country | No | Country name. This is where the employer is based, which is a different question from where it will hire — see hires_worldwide. | |
| has_jobs | No | Only employers with at least one live listing. | |
| remote_level | No | The employer's office-presence policy. One of fully-remote, hybrid, onsite. Independent of hires_worldwide: a fully-remote employer can still hire in one country only. | |
| schedule_type | No | Filter by the employer's schedule policy, e.g. 4_day_week. | |
| hires_worldwide | No | Only employers that accept applicants from any country. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| page | No | ||
| has_more | No | ||
| returned | No | ||
| companies | No | ||
| next_page | No | ||
| page_size | No | ||
| paging_note | No | ||
| total_matching | No | ||
| paging_limit_reached | No |