Skip to main content
GET
Search jobs via query parameters

Authorizations

X-Api-Key
string
header
required

API key provided by Jobo

Query Parameters

q
string

Free-text search query. By default it matches broadly against the job title, company name, popular skills, and summary with typo tolerance. Wrap the value in double quotes (e.g. q="Quantitative Developer") for an exact, contiguous phrase match restricted to the job title only.

search_description
boolean
default:true

When true, search title, alternative titles, company, popular skills, and summary. When false, restrict matching to titles and curated alternative titles. A double-quoted query always matches an exact contiguous phrase in the literal title.

location
string

Location filter (city, region, or country)

sources
string

Comma-separated source identifiers

work_model
string

Comma-separated work models (remote, hybrid, onsite)

employment_type
string

Comma-separated employment types (full-time, part-time, contract, internship, freelance, temporary)

experience_level
string

Comma-separated experience levels. Canonical values: intern, entry, mid, senior, lead, executive.

posted_after
string<date-time>

Only return jobs whose employer posting date is on or after this date

posted_before
string<date-time>

Only return jobs whose employer posting date is on or before this date

min_salary_usd
integer

Minimum annual salary in USD

Required range: x >= 0
max_salary_usd
integer

Maximum annual salary in USD

Required range: x >= 0
skills
string

Comma-separated skill names

industries
string

Comma-separated company-industry names. A job matches any supplied value.

discovered_after
string<date-time>

Only return jobs first indexed on or after this UTC timestamp

discovered_before
string<date-time>

Only return jobs first indexed on or before this UTC timestamp

page
integer
default:1

Page number (1-indexed)

Required range: x >= 1
page_size
integer
default:25

Number of results per page (max 100)

Required range: 1 <= x <= 100
include_fields
string

Comma-separated list of the heavy, non-core fields to include: description, summary, qualifications, responsibilities, benefits. Omit for the full job (every field, the default). Pass a subset to keep only those non-core fields alongside the always-present core fields (id, title, company, locations, compensation, dates, …). Pass an empty value (?include_fields=) for core fields only. Unknown names are ignored; excluded non-core fields come back empty ("" / []).

include_facets
string

Comma-separated facets to compute: work_model, experience_level, employment_type, sources, industries, and skills. Omit for the default low-cardinality subset; pass an empty value to skip facets.

Response

Paginated list of matching jobs

jobs
object[]
required
total
integer<int64>
required
page
integer
required
page_size
integer
required
total_pages
integer
required
facets
object
required