Skip to main content
GET
Count open jobs

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

q
string

Words to find in the title, company or department: any part of a word, any case. Every word must match.

Required string length: 1 - 200
excludeQ
string

Words to find in the title, company or department: any part of a word, any case. Every word must match.

Required string length: 1 - 200
title
string

Words to find in the title: any part of a word, any case. Every word must match.

Required string length: 1 - 200
excludeTitle
string

Words to find in the title: any part of a word, any case. Every word must match.

Required string length: 1 - 200
department
string

Words to find in the department: any part of a word, any case. Every word must match.

Required string length: 1 - 200
excludeDepartment
string

Words to find in the department: any part of a word, any case. Every word must match.

Required string length: 1 - 200
text
string

Whole words to find in the job text, any case, any language. Every word must match.

Required string length: 1 - 200
excludeText
string

Whole words to find in the job text, any case, any language. Every word must match.

Required string length: 1 - 200
company
string[]

Company name, any case. Repeat the param to match any of several values; GET /v1/facets lists the values in use.

Required array length: 1 - 50 elements
Required string length: 1 - 200
excludeCompany
string[]

Company name, any case. Repeat the param to match any of several values; GET /v1/facets lists the values in use.

Required array length: 1 - 50 elements
Required string length: 1 - 200
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[]

Applicant tracking system, any case. Repeat the param to match any of several values; GET /v1/facets lists the values in use.

Required array length: 1 - 50 elements
Required string length: 1 - 200
excludeAts
string[]

Applicant tracking system, any case. Repeat the param to match any of several values; GET /v1/facets lists the values in use.

Required array length: 1 - 50 elements
Required string length: 1 - 200
workplaceType
string[]

Workplace type, any case. Repeat the param to match any of several values; GET /v1/facets lists the values in use.

Required array length: 1 - 50 elements
Required string length: 1 - 200
employmentType
string[]

Employment type, any case. Repeat the param to match any of several values; GET /v1/facets lists the values in use.

Required array length: 1 - 50 elements
Required string length: 1 - 200
language
string[]

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.

Required array length: 1 - 50 elements
Required string length: 1 - 200
location
string[]

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.

Required array length: 1 - 20 elements
Required string length: 1 - 200
excludeLocation
string[]

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.

Required array length: 1 - 20 elements
Required string length: 1 - 200
country
string[]

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.

Required array length: 1 - 50 elements
Required string length: 1 - 200
region
string[]

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.

Required array length: 1 - 50 elements
Required string length: 1 - 200
city
string[]

City, as GET /v1/facets lists it. Repeat the param to match any of several values; GET /v1/facets lists the values in use.

Required array length: 1 - 50 elements
Required string length: 1 - 200
occupation
string[]

ISCO-08 occupation code or group prefix ("25" holds "2512"). Repeat to match any.

Required array length: 1 - 50 elements
Pattern: ^\d{1,4}$
excludeOccupation
string[]

ISCO-08 occupation code or group prefix ("25" holds "2512"). Repeat to match any.

Required array length: 1 - 50 elements
Pattern: ^\d{1,4}$
salaryMinEur
integer | null

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.

Required range: 0 <= x <= 10000000
industry
string[]

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.

Required array length: 1 - 50 elements
Required string length: 1 - 200
companySize
enum<string>[]

Headcount band of the company. Repeat to match any; jobs of companies with no known headcount are left out.

Required array length: 1 - 8 elements
Available options:
1-10,
11-50,
51-200,
201-500,
501-1000,
1001-5000,
5001-10000,
10001+
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

Jobs posted (or first seen, when earlier or undated) at or after this date or time, UTC

ids
integer[]

Job ids. Repeat the param to match any, up to 100.

Required array length: 1 - 100 elements
Required range: x <= 2147483647
url
string[]

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.

Required array length: 1 - 10 elements
Required string length: 1 - 2000
benefit
enum<string>[]

Benefit the job text offers, read by rules: health, retirement, paid_time_off, wellness. Repeat the param to match any.

Required array length: 1 - 4 elements
Available options:
health,
retirement,
paid_time_off,
wellness
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.

Response

200 - application/json

The count

count
integer
required