---
title: "Airbnb market density near a coordinate"
method: GET
path: "/datasets/airbnb-markets/nearby"
tags: ["Datasets"]
---

# Airbnb market density near a coordinate

`GET /datasets/airbnb-markets/nearby`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/datasets/airbnb-markets/nearby`
- Auth: API key in header `x-api-key`

Returns an aggregate geohash-grid density map of Airbnb listings within a radius of a coordinate, from dataset id enum value `airbnb-markets`. Each cell reports a centroid, listing count and Superhost share; thin cells are suppressed. Aggregate-only.

## Query parameters

- `lat` number, required
- `lon` number, required
- `radius_m` integer, required
- `precision` integer
- `min_listings` integer
- `country` string
- `superhost` boolean
- `min_rating` number
- `active_since` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsAirbnbMarketsNearbyResponseDoc
  - `code` integer
  - `data` DatasetsAirbnbMarketNearbyResponse
    - `cells` EsAirbnbDensityCell[]: Density cells within the radius, each with its geohash, centre and listing counts.
      - `geohash` string: Geohash string that identifies the grid cell.
      - `lat` number: Latitude of the cell centre, in decimal degrees.
      - `listings` integer: Number of listings in the cell.
      - `lon` number: Longitude of the cell centre, in decimal degrees.
      - `superhost_listings` integer: Number of listings in the cell seen with the Superhost badge.
      - `superhost_pct` number: Share of listings in the cell seen with the Superhost badge, from 0 to 100.
    - `dataset` string: Identifier of the dataset queried (`airbnb-markets`).
    - `lat` number: Latitude of the search centre, in degrees.
    - `lon` number: Longitude of the search centre, in degrees.
    - `precision` integer: Geohash precision of the cells returned.
    - `radius_m` integer: Search radius, in metres.
    - `total` integer: Number of cells returned.
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `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/028417aa35bb?raw)