q | string | Words to find in the title, company or department: any part of a word, any case. Every word must match. | |
excludeQ | string | Words to find in the title, company or department: any part of a word, any case. Every word must match. | |
title | string | Words to find in the title: any part of a word, any case. Every word must match. | |
excludeTitle | string | Words to find in the title: any part of a word, any case. Every word must match. | |
department | string | Words to find in the department: any part of a word, any case. Every word must match. | |
excludeDepartment | string | Words to find in the department: any part of a word, any case. Every word must match. | |
text | string | Whole words to find in the job text, any case, any language. Every word must match. | |
excludeText | string | Whole words to find in the job text, any case, any language. Every word must match. | |
company | string, repeatable | Company name, any case. Repeat the param to match any of several values; GET /v1/facets lists the values in use. | yes |
excludeCompany | string, repeatable | Company name, any case. Repeat the param to match any of several values; GET /v1/facets lists the values in use. | |
agency | boolean | true: only jobs of staffing and recruiting firms; false: none of them. Firms are known by name (a list of large firms and the words such firms put in their names). | |
ats | string, repeatable | Applicant tracking system, any case. Repeat the param to match any of several values; GET /v1/facets lists the values in use. | yes |
excludeAts | string, repeatable | Applicant tracking system, any case. Repeat the param to match any of several values; GET /v1/facets lists the values in use. | |
workplaceType | string, repeatable | Workplace type, any case. Repeat the param to match any of several values; GET /v1/facets lists the values in use. | yes |
employmentType | string, repeatable | Employment type, any case. Repeat the param to match any of several values; GET /v1/facets lists the values in use. | yes |
language | string, repeatable | Language of the job text (ISO 639-1), any case. Repeat the param to match any of several values; GET /v1/facets lists the values in use. | yes |
location | string, repeatable | A place in any common form: a city (“Munich”, “München, DE”), a region in any language or its ISO 3166-2 code (“Bavaria”, “Bayern”, “DE-BY”), a country or its code (“Germany”, “DE”), a group of countries (“Europe”, “EU”). “Remote” or “Remote in Germany” keep remote jobs only. Repeat the param to match any of several places. | |
excludeLocation | string, repeatable | A place in any common form: a city (“Munich”, “München, DE”), a region in any language or its ISO 3166-2 code (“Bavaria”, “Bayern”, “DE-BY”), a country or its code (“Germany”, “DE”), a group of countries (“Europe”, “EU”). “Remote” or “Remote in Germany” keep remote jobs only. Repeat the param to match any of several places. | |
country | string, repeatable | Country (ISO 3166-1 alpha-2, any case); a job in several places matches any. Repeat the param to match any of several values; GET /v1/facets lists the values in use. | yes |
region | string, repeatable | Region or state, as GET /v1/facets lists it, or its ISO 3166-2 code (“DE-BY”). Repeat the param to match any of several values; GET /v1/facets lists the values in use. | yes |
city | string, repeatable | City, as GET /v1/facets lists it. Repeat the param to match any of several values; GET /v1/facets lists the values in use. | yes |
occupation | string, repeatable | ISCO-08 occupation code or group prefix (“25” holds “2512”). Repeat to match any. | yes |
excludeOccupation | string, repeatable | ISCO-08 occupation code or group prefix (“25” holds “2512”). Repeat to match any. | |
salaryMinEur | integer | Yearly pay at least this, in EUR (the middle of the employer’s range, converted at the day’s rate). Jobs without pay are left out. | |
industry | string, repeatable | Industry of the company, as Wikidata names it (“software industry”); jobs of companies with no known industry are left out. Repeat the param to match any of several values; GET /v1/facets lists the values in use. | yes |
companySize | string, repeatable | Headcount band of the company. Repeat to match any; jobs of companies with no known headcount are left out. | yes |
canonical | boolean | true: one job per duplicate group (the first posted) and every job without duplicates; false: only the other jobs of each group. Without it, all jobs. A group is the same company, title and places on two or more boards, posted within 30 days. | |
postedAfter | date-time or date | Jobs posted (or first seen, when earlier or undated) at or after this date or time, UTC | |
ids | integer, repeatable | Job ids. Repeat the param to match any, up to 100. | |
url | string, repeatable | The job’s URL on its board or its application form URL, exactly as the job has it. Repeat the param to match any, up to 10. | |
benefit | string, repeatable | Benefit the job text offers, read by rules: health, retirement, paid_time_off, wellness. Repeat the param to match any. | yes |
visaSponsorship | boolean | Read by rules from the job text. true: jobs that say they sponsor visas; false: jobs that say they do not, or that need the right to work already. Jobs whose text says nothing are left out. | yes |