API Reference

Search jobs

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

Search jobs by params.

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 7 months ago

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