search_jobs validates every filter against the same service the website uses.
Passing an unrecognised value returns an error listing what is allowed, so an
assistant can correct itself without guessing.
ATS source
platform — which applicant tracking system the role was posted through.
Employment type
employment_type
Full-Time · Part-Time · Contract
Values are case-sensitive and hyphenated exactly as shown.
Experience level
experience_level
Intern · Junior · Mid-level · Senior · Staff · Lead · Manager · Director
Recency
posted — only roles first seen within the window.
Location
Two independent filters, usable together:string
Substring match against the role’s location text —
Remote, Berlin,
New York. Good for free-form matching, including remote roles.string
ISO alpha-3 country code —
USA, IND, DEU, GBR. Matched on word
boundaries, so IND will not also match “Indianapolis”.Domain
domain — a slug from list_domains, e.g. software-engineering,
ai-data-science, design.
Company
company — a company slug, to restrict results to a single employer. For a
fuller picture of one company, get_company_overview is usually the better tool.
Pagination
integer
1-based page number. Defaults to
1.integer
Results per page, between 1 and 50. Defaults to
20.total, page and total_pages so an assistant knows whether
more results exist.