Skip to main content
GET
Search jobs

Endpoint

Authentication

Include your API key in the request header:

Parameters

Every parameter is optional; combine them freely. List parameters take comma-separated values (workplaceType=remote,hybrid). An unknown parameter name or a value outside a list is rejected with a free 400, rather than silently ignored.
Keywords, matched against the job title and description. At most 200 characters.
string
A place, as text (Lyon, Île-de-France, San Francisco Bay Area). It is resolved to the first suggestion of Search Geo IDs for that text, and the response’s query.geoId / query.geoTitle say which place the search ran on. Pass geoId instead to choose the place exactly.
string
The numeric ID of a place, from Search Geo IDs (e.g. 105015875 for France, 103815258 for Lyon). Overrides location.
string
One or more numeric company IDs (the companyId returned by Get Company), comma-separated.
string
relevance (the default ordering) or date (newest first).
string
office, hybrid, remote.
string
full-time, part-time, contract, temporary, internship.
string
internship, entry, associate, mid-senior, director, executive.
string
24h, week or month: only jobs posted within that window.
string
Minimum salary: 40k+, 60k+, 80k+, 100k+, 120k+, 140k+, 160k+, 180k+, 200k+. Applies to United States searches only: elsewhere the source has no salary filter and the results are the same with or without it.
string
One or more numeric industry IDs, comma-separated (e.g. 4 for Software Development).
string
One or more job function codes, comma-separated: acct, adm, advr, anls, art, bd, cnsl, cust, dist, dsgn, edu, eng, fin, genb, hcpr, hr, it, lgl, mgmt, mnfc, mrkt, othr, pr, prch, prdm, prjm, prod, qa, rsch, sale, sci, stra, supl, trng, wrt.
boolean
default:"false"
true keeps only jobs with fewer than 10 applicants.
boolean
default:"false"
true keeps only jobs you apply to without leaving the platform. false applies no filter: Easy Apply jobs cannot be excluded.
integer
default:"1"
Page number, from 1 to 40. Each page holds 25 jobs, and a search reaches at most its first 1,000 results.

Response

array
The jobs on this page, up to 25.
object
totalElements: the number of jobs the search matches; totalPages: the pages you can request (at most 40, since a search reaches its first 1,000 results); pageNumber, previousElements (jobs on the pages before this one) and pageSize (25).
object
The parameters the search ran with, plus geoId and geoTitle: the place it ran on, whether you passed geoId or a location text.

Example Request

Example Response

Errors

See Error Handling for the full list of error codes and recommended handling.
  • 400 — INVALID_PARAMETER: an unknown parameter, a value outside a list, a page outside 1-40, or a location that matches no place
  • 401 — INVALID_API_KEY
  • 402 — QUOTA_EXHAUSTED
  • 429 — RATE_LIMITED
  • 500 — INTERNAL_ERROR
  • 503 — SERVICE_UNAVAILABLE
A search that matches nothing answers 200 with an empty elements list.

Notes

This endpoint consumes 1 credit per page. Errors are free. See Quotas.
A city with workplaceType=remote returns the remote jobs posted for that city or its region. Remote jobs posted for a whole country ("France (Remote)") come with the country’s geoId.
With sortBy=relevance (or no sortBy), the ordering is the source’s own ranking and can differ between two identical calls. Use sortBy=date for a stable, newest-first walk through the pages.

Authorizations

X-API-Key
string
header
required

Query Parameters

Keywords, matched against the job title and description (at most 200 characters).

Example:

"sales"

location
string

A place as text, resolved to the first suggestion of GET /api/v1/geo-id/search; query.geoId and query.geoTitle in the response say which place the search ran on.

Example:

"Lyon"

geoId
string

Numeric ID of a place, from GET /api/v1/geo-id/search. Overrides location.

Example:

"105015875"

companyId
string

One or more numeric company IDs, comma-separated.

Example:

"1035"

sortBy
enum<string>

relevance (default ordering) or date (newest first).

Available options:
relevance,
date
workplaceType
string

Comma-separated: office, hybrid, remote.

Example:

"remote,hybrid"

employmentType
string

Comma-separated: full-time, part-time, contract, temporary, internship.

Example:

"full-time"

salary
enum<string>

Minimum salary, United States searches only.

Available options:
40k+,
60k+,
80k+,
100k+,
120k+,
140k+,
160k+,
180k+,
200k+
postedLimit
enum<string>

Only jobs posted within this window.

Available options:
24h,
week,
month
experienceLevel
string

Comma-separated: internship, entry, associate, mid-senior, director, executive.

Example:

"mid-senior"

industryId
string

One or more numeric industry IDs, comma-separated.

Example:

"4"

functionId
string

One or more job function codes, comma-separated (eng, it, sale, mrkt…; the full list is on the endpoint page).

Example:

"eng,it"

under10Applicants
boolean
default:false

true keeps only jobs with fewer than 10 applicants.

easyApply
boolean
default:false

true keeps only Easy Apply jobs; false applies no filter.

page
integer
default:1

Page number, 1 to 40, 25 jobs per page.

Required range: 1 <= x <= 40

Response

One page of jobs

elements
object[]
pagination
object
query
object

The parameters the search ran with, plus geoId and geoTitle: the place it ran on.