API Reference

Search jobs

get
https://api.smartrecruiters.com/jobs

Search jobs by params.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

full-text search query based on a job title; case insensitive; e.g. java developer

integer
1 to 100
Defaults to 10

number of elements to return. max value is 100

integer
0 to 10000000
Defaults to 0
deprecated

number of elements to skip while processing result; this method of paging is very slow and is deprecated, please use pageId instead

string

unique identifier for next page of jobs - returned as nextPageId in previous page result. You must set job_id value for sort parameter if you use pageId.

string
enum

Order in which results are returned.

  • default - sorts results by creation date or by match score and creation date if query (q) is set. Can't be used with pageId parameter (request might not return all results)
  • job_id - sorts results by job id. The only supported sorting order when using pageId based pagination.
Allowed:
city
array of strings

city filter (part of the location object); can be used repeatedly; case sensitive; e.g. San Francisco

city
department
array of strings

department filter (by department label); can be used repeatedly; case sensitive; e.g. “Marketing”

department
date-time

ISO8601-formatted time boundaries for the job update time, Format: yyyy-MM-ddTHH:mm:ss.SSSZZ

date-time

ISO8601-formatted time boundaries for the job lastActivityOn time, Format: yyyy-MM-ddTHH:mm:ss.SSSZZ. lastActivityOn is updated when job is edited, new candidates apply or job is published.

string
enum

Exceptions to the language code ISO format:

  • "en-GB" - "English - English (UK)"
  • "es-MX" - "Spanish - español (México)"
  • "fr-CA" - "French - français (Canada)"
  • "pt-BR" - "Portugal - português (Brasil)"
  • "zh-TW" - "Chinese (Traditional) - 中文 (香港)"
  • "zh-CN" - "Chinese (Simplified) - 中文 (简体)"

Value "pt-PT" is deprecated and will not work, use "pt" instead.

string
enum
deprecated

Status of a job. Deprecated - cannot be used repeatedly. To filter by multiple status, use "statuses".

Allowed:
statuses
array of strings

Job status filter, can be used repeatedly. When present, overrides "status".

statuses
string
enum

Posting status of a job

Allowed:
hiringTeamMemberId
array of strings

Filter jobs to those where any of the given users is a member of the job's hiring team. Values are user identifiers.

hiringTeamMemberId
Headers
string
enum
Defaults to en

language of returned content

Responses

Updated 12 days ago

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 12 days ago