---
title: "Find postings near a coordinate"
method: GET
path: "/datasets/jobs/nearby"
tags: ["Datasets"]
---

# Find postings near a coordinate

`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`

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).

## Query parameters

- `lat` number, required
- `lon` number, required
- `radius_km` number
- `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'
- `include_closed` boolean
- `page` integer
- `page_size` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsJobsSearchResponseDoc
  - `code` integer
  - `data` DatasetsJobsSearchResponse
    - `jobs` object[]: Matching job postings on this page.
    - `page` integer: Page number returned.
    - `page_size` integer: Number of items per page.
    - `total` integer: Total number of postings matching the filters.
  - `msg` string

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)