Get job postings

get

https://api.revealera.com/signals/jobs.json

Returns job postings, with full-text descriptions containing a given keyword, for a specific company, or for a specific normalized job title
Need an API key? Get a free API key here.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

keyword

string

A keyword to search for in the full-text description of job postings. You can separate multiple keywords with "OR". For example 'machine learning OR LLMs' will find jobs that have either 'machine learning' or 'LLMs'. Please exclude any quotes from the query

normalized_job_titles

string

A list of normalized job titles to filter by, separated by ';'. The entire list of normalized job titles can be found here https://api.revealera.com/normalized_job_titles.txt (the 2nd column in this CSV)

domain

string

The website domain of the company to filter by. Note that one of keyword, normalized_job_titles, and domain MUST be passed

search_job_title_only

boolean

Defaults to false

if keyword is passed, and this is true, we'll search just for the title of the job posting, instead of BOTH the title and the description

begin_date

date

Start date for filtering job postings. Defaults to '2020-01-01'.

end_date

date

End date for filtering job postings. Defaults to end of today.

search_companies_added_before_date

date

Only search job postings in companies that were "added" on or before this date. We constantly add companies to our database, so if you're looking at any trends data such as # of job postings over time containining a certain keywords since a certain date (ie. through facets) you wouldn't want to include jobs from companies that were added after a certain date (because that would overinflate the volume for recent months)

limit

integer

1 to 20

Defaults to 20

Job postings per page

active_only

boolean

Defaults to false

True if you only want to see active job postings (not deleted or taken down), false otherwise

countries

string

Only show jobs from companies headquartered (not necessarily where the job is located) in the specified countries. Country codes must be in ISO 3166-1 alpha-2 format. Separate multiple values with ';'

region_countries

string

Only show jobs that are located in the specified countries. Country codes must be in ISO 3166-1 alpha-2 format. Separate multiple values with ';' Note: If you pass in a country code, there is a chance we will not show jobs that might be located in that country because our parser wasn't able to parse the country from the job posting

exact_match

boolean

Defaults to true

True if the job posting must match the keyword passed in EXACTLY, in the order passed. For example, if keyword = "content marketing", only job postings with "content marketing" together as an exact phrase will be returned

company_size_range

string

Only show jobs from companies with number of employees that match the specified size ranges. Separate multiple values with ';'. Possible ranges are 1 employee, 2-10, 11-50, 51-200, 201-500, 501-1,000, 1,001-5,000, 5,001-10,000, 10,001+

remote_only

boolean

Defaults to false

If true, only show jobs that are marked as remote

show_facets

boolean

Defaults to false

If true, show aggregate statistics on number of jobs found per month

facet_on

string

If you wish to get aggregate statistics on the unique # of companies per month that match this query (NOT # of jobs), pass in 'company_domain'. Otherwise, pass 'jobs' (default). Only two possible values are allowed: 'jobs' or 'company_domain'. If show_facets is false, this field is ignored.

next_token

string

Pagination token from previous response (located in "pagination" > "next_token") to fetch the next page. Leave blank for the first page

company_employee_size_range

string

Only show job postings from companies with number of employees that match the specified size ranges. Separate multiple values with ';'. Possible ranges are 1 employee, 2-10, 11-50, 51-200, 201-500, 501-1,000, 1,001-5,000, 5,001-10,000, 10,001+

company_industry

string

Only show job postings from companies in the specified industries. We look at the LinkedIn company page to determine industries. All possible industries are available at https://api.revealera.com/linkedin_industries.txt . Separate multiple values with ';'

Responses

200Success response

401Unauthorized

422Validation errors