Datasets

Search the jobs dataset (all companies' live postings)

Full-text + faceted search over every job posting crawled from every discovered company ATS board (Greenhouse, Lever, Ashby, Workday, SmartRecruiters, Workable, Recruitee, Rippling, Personio, Teamtailor, Oracle, UKG, iCIMS, Eightfold, Gem, Pinpoint) plus 5 single-company big-tech careers platforms (Amazon, Apple, Google, Meta, Tesla). Open roles only by default (set include_closed=true for historical/filled roles). Salary is parsed from a structured field when the provider has one, or from an explicit pay figure stated in the description otherwise, so coverage varies by posting rather than by provider; min_salary/max_salary filter on it and require salary_currency, since comparing raw compensation numbers across currencies is meaningless. Location is also exposed as structured city/state/country fields alongside the free-text location string, so city/state/country filter on an exact match of those parsed components rather than substring-matching the display string. job_family is an exact level-2 ISCO family label assigned from ESCO occupation evidence; ambiguous postings remain unclassified and do not match that filter. employment_type is never populated for google-jobs/meta-jobs, and posted_at (so sort=posted_desc) is never populated for meta-jobs/tesla-jobs -- their upstream APIs expose no such field. provider enum: greenhouse, lever, ashby, workday, smartrecruiters, workable, recruitee, rippling, personio, teamtailor, oracle, ukg, icims, eightfold, gem, pinpoint, amazon-jobs, apple-jobs, google-jobs, meta-jobs, tesla-jobs. workplace_type enum: onsite, hybrid, remote. sort enum: relevance, posted_desc, company_asc. Billing: this search costs 1 credit per 10 records returned, rounded up, with a minimum of 1 (up to 10 records cost 1, a full page of 100 costs 10).

get/datasets/jobs/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/datasets/jobs/search
  • Auth: API key in header x-api-key

Query parameters

qstring

Full-text over title, company, description

companystring

Company name match

provider'greenhouse' | 'lever' | 'ashby' | 'workday' | 'smartrecruiters' | 'workable' | 'recruitee' | 'rippling' | 'personio' | 'teamtailor' | 'oracle' | 'ukg' | 'icims' | 'eightfold' | 'gem' | 'pinpoint' | 'amazon-jobs' | 'apple-jobs' | 'google-jobs' | 'meta-jobs' | 'tesla-jobs'

Provider filter

departmentstring

Exact department filter

locationstring

Location match

citystring

Exact city filter (parsed location component)

statestring

Exact state/region filter (parsed location component)

countrystring

Exact country filter (parsed location component); ISO country code or name, matched case-insensitively

employment_typestring

Exact employment-type filter

job_familystring

Exact ESCO/ISCO job-family label filter

remoteboolean

Filter by remote (true or false)

workplace_type'onsite' | 'hybrid' | 'remote'

Workplace type filter

include_closedboolean

Include closed/filled roles (default false = open only)

min_salarynumber

Minimum salary (matches postings whose range reaches at least this); requires salary_currency

max_salarynumber

Maximum salary (matches postings whose range starts at or below this); requires salary_currency

salary_currencystring

3-letter ISO currency code (e.g. USD) the min_salary/max_salary bounds are in; required when either bound is set

sort'relevance' | 'posted_desc' | 'company_asc'

Sort enum: relevance, posted_desc, company_asc

pageinteger

Page number, default 1

page_sizeinteger

Page size, default 20, max 100; page*page_size must be <= 10000

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.