Datasets

Find postings near a coordinate

Finds crawled job postings within radius_km of a lat/lon, nearest first. Only geocoded postings participate (the geo-enrich worker back-fills coordinates from each posting's location). Open roles only by default. 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. Billing: this endpoint 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/nearby

Request

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

Query parameters

latnumber required

Latitude, -90..90

lonnumber required

Longitude, -180..180

radius_kmnumber

Search radius in km, default 50, max 500

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

include_closedboolean

Include closed/filled roles (default false)

pageinteger

Page number, default 1

page_sizeinteger

Page size, default 20, max 100

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 3 revisions of this API.