Endpoint Playground

Try the Airbnb Markets Dataset Facets API

Returns suppressed distribution counts over the Airbnb markets dataset, honoring the same filters as search. Facet enum: `country`, `market`, `currency`, `superhost`, `guest_favorite`, `rating_band`, `review_band`, `admin1` (top subdivision), `locality` (settlement), `room_type` (`entire_place`/`private_room`/`hotel`/`shared_room`), `property_type` (Airbnb's canonical listing type from the detail page), `amenities` (each amenity with the count of listings offering it). The `admin1`, `locality`, `room_type`, `property_type` and `amenities` facets stay empty until their enrichment coverage is high enough to be reliable. group_by enum: `country`, `market`, `admin1`, `locality`, `room_type`, `property_type`. Dataset Playground requests query indexed data and do not apply proxy routing.

What a live request returned

14 Oct 2026: 1 items; 2 fields had a value in every checked item.

Observed request: GET /datasets/airbnb-markets/facets?facet=currency
Fields with a value in every checked item: value, count

Request: GET /datasets/airbnb-markets/facets
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 0.38 s
Monitored request: GET /datasets/airbnb-markets/facets?facet=country

Airbnb Markets Dataset Facets API documentation Datasets platform page Pricing

Prefilled cURL

curl "https://api.crawlora.net/api/v1/datasets/airbnb-markets/facets?facet=country&group_by=country" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
facet	string	Yes	country	Facet enum: country, market, currency, superhost, guest_favorite, rating_band, review_band, admin1, locality, room_type, property_type, amenities
group_by	string	No	country	Aggregate cell dimension enum: country, market, admin1, locality, room_type, property_type. Defaults to country
country	string	No		Exact ISO-3166-1 alpha-2 country filter, e.g. FR
market	string	No		Exact metro-market filter, max 128 characters
superhost	boolean	No		Count only Superhost listings
guest_favorite	boolean	No		Count only Guest Favorite listings (an observed lower bound; the badge under-counts)
min_rating	number	No		Minimum listing rating, from 0 through 5
min_review_count	integer	No		Minimum listing review count, 0 or greater
active_since	string	No		Freshness filter, an ISO-8601 date (YYYY-MM-DD)
min_listings	integer	No		Minimum listings per bucket; raises the small-cell suppression floor

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "airbnb-markets",
    "facet": "currency",
    "items": [
      {
        "value": "USD",
        "count": 512000
      },
      {
        "value": "EUR",
        "count": 388000
      },
      {
        "value": "BRL",
        "count": 96000
      }
    ]
  }
}

More Datasets endpoints

List stored scraped datasets Get an Airbnb market from the dataset Airbnb market density near a coordinate Search the Airbnb markets dataset Facet Apple Podcasts shows dataset Get an Apple Podcasts show from dataset Search Apple Podcasts shows dataset Search the app-charts dataset Search the app-reviews dataset Search the apps-intelligence dataset Facet the BBB businesses dataset Get a business from the BBB businesses dataset All 136 Datasets endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestdatasets.airbnbMarketsFacetResponseDocDatasets

GET /datasets/airbnb-markets/facets

Facet the Airbnb markets dataset

Response behavior

- `facet` is required; unsupported values return the standard invalid params envelope. - `superhost` returns `superhost` and `not_superhost` bucket values. - `guest_favorite` returns `guest_favorite` and `not_guest_favorite` bucket values. The badge is an observed lower bound, so the `guest_favorite` count under-counts and `not_guest_favorite` correspondingly over-counts. - `rating_band` returns bucket values `<3`, `3-4`, `4-4.5`, `4.5-4.8`, `4.8+`. - `review_band` returns bucket values `<1`, `1-10`, `10-50`, `50-200`, `200+`. - The `admin1` (top subdivision), `locality` (settlement), `room_type`, `property_type` and `amenities` facets are enrichment-derived. `admin1`/`locality` come from a reverse-geocode pass; `room_type` returns bucket values `entire_place`, `private_room`, `hotel`, `shared_room`, classified from each listing's search-card descriptor; `property_type` returns Airbnb's finer canonical listing type read from the detail page; `amenities` returns each amenity (e.g. `Wifi`, `Pool`, `Free parking on premises`, `Pets allowed`) with the count of listings in the filtered market that offer it (a listing contributes to every amenity it has). Because each covers a growing share of the census, these facets return an **empty `items` array until that coverage is high enough** to be reliable, then fill in on their own as coverage grows. - Returns up to `50` buckets ordered by descending count. - Returns an empty `items` array (not an error) when no bucket clears the suppression floor. - Does not trigger live scraping.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

facet

requiredstring

Facet enum: country, market, currency, superhost, guest_favorite, rating_band, review_band, admin1, locality, room_type, property_type, amenities · allowed: country, market, currency, superhost, guest_favorite, rating_band, review_band, admin1, locality, room_type, property_type, amenities

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "airbnb-markets",
    "facet": "currency",
    "items": [
      {
        "value": "USD",
        "count": 512000
      },
      {
        "value": "EUR",
        "count": 388000
      },
      {
        "value": "BRL",
        "count": 96000
      }
    ]
  }
}

Endpoint Playground

Try the Airbnb Markets Dataset Facets API

What a live request returned

14 Oct 2026: 1 items; 2 fields had a value in every checked item.

Observed request: GET /datasets/airbnb-markets/facets?facet=currency
Fields with a value in every checked item: value, count

Request: GET /datasets/airbnb-markets/facets
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 0.38 s
Monitored request: GET /datasets/airbnb-markets/facets?facet=country

Airbnb Markets Dataset Facets API documentation Datasets platform page Pricing

Prefilled cURL

curl "https://api.crawlora.net/api/v1/datasets/airbnb-markets/facets?facet=country&group_by=country" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
facet	string	Yes	country	Facet enum: country, market, currency, superhost, guest_favorite, rating_band, review_band, admin1, locality, room_type, property_type, amenities
group_by	string	No	country	Aggregate cell dimension enum: country, market, admin1, locality, room_type, property_type. Defaults to country
country	string	No		Exact ISO-3166-1 alpha-2 country filter, e.g. FR
market	string	No		Exact metro-market filter, max 128 characters
superhost	boolean	No		Count only Superhost listings
guest_favorite	boolean	No		Count only Guest Favorite listings (an observed lower bound; the badge under-counts)
min_rating	number	No		Minimum listing rating, from 0 through 5
min_review_count	integer	No		Minimum listing review count, 0 or greater
active_since	string	No		Freshness filter, an ISO-8601 date (YYYY-MM-DD)
min_listings	integer	No		Minimum listings per bucket; raises the small-cell suppression floor

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "airbnb-markets",
    "facet": "currency",
    "items": [
      {
        "value": "USD",
        "count": 512000
      },
      {
        "value": "EUR",
        "count": 388000
      },
      {
        "value": "BRL",
        "count": 96000
      }
    ]
  }
}

More Datasets endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestdatasets.airbnbMarketsFacetResponseDocDatasets

GET /datasets/airbnb-markets/facets

Facet the Airbnb markets dataset

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

facet

requiredstring

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "airbnb-markets",
    "facet": "currency",
    "items": [
      {
        "value": "USD",
        "count": 512000
      },
      {
        "value": "EUR",
        "count": 388000
      },
      {
        "value": "BRL",
        "count": 96000
      }
    ]
  }
}