---
title: "Get an Airbnb market from the dataset"
method: GET
path: "/datasets/airbnb-markets/items/{country}"
tags: ["Datasets"]
---

# Get an Airbnb market from the dataset

`GET /datasets/airbnb-markets/items/{country}`

## Request

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

Returns one country's full aggregate Airbnb market profile from dataset id enum value `airbnb-markets` — headline supply, Superhost share, Guest Favorite share (`guest_favorite_pct`, an observed lower bound), `avg_person_capacity` (average guests a listing sleeps over the detail-page-enriched sample), ratings, its top metros, bounding box, per-currency nightly-price percentiles, and a USD-normalized `price_usd` percentile block (converted via an approximate dated FX snapshot) for cross-country comparison. Aggregate-only. Returns 404 for a country below the suppression floor.

## Path parameters

- `country` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsAirbnbMarketResponseDoc
  - `code` integer
  - `data` EsAirbnbMarketDetail
    - `avg_person_capacity` number: Average number of guests a listing sleeps, over the sampled listings. Omitted until the sample is large enough.
    - `avg_rating` number: Average listing rating across rated listings. Omitted when the country has too few rated listings.
    - `avg_review_count` number: Average number of reviews per listing.
    - `bounds` EsAirbnbGeoBounds
      - `bottom_right` EsGeoPoint
        - `lat` number: Latitude in decimal degrees.
        - `lon` number: Longitude in decimal degrees.
      - `top_left` EsGeoPoint
        - `lat` number: Latitude in decimal degrees.
        - `lon` number: Longitude in decimal degrees.
    - `country` string: ISO 3166-1 alpha-2 code of the country this profile covers.
    - `currencies` EsAirbnbPriceStats[]: Nightly price percentiles for each currency that has enough priced listings.
      - `currency` string: ISO currency code of the nightly prices.
      - `listings` integer: Number of priced listings in this currency.
      - `p25` number: 25th percentile of the nightly price, in `currency`.
      - `p50` number: Median nightly price, in `currency`.
      - `p75` number: 75th percentile of the nightly price, in `currency`.
    - `distinct_hosts` integer: Number of distinct hosts among the sampled listings. Omitted until the sample is large enough.
    - `enriched_listings` integer: Number of listings in the detail-page sample behind the reliable rates. Omitted when no listing has been sampled.
    - `guest_favorite_listings` integer: Number of listings seen with the Guest Favorite badge.
    - `guest_favorite_pct` number: Share of listings seen with the Guest Favorite badge, from 0 to 100. A lower bound, because the badge does not always show.
    - `guest_favorite_pct_enriched` number: Share of sampled listings that are Guest Favorites, from 0 to 100, taken from listing detail pages. Omitted until the sample is large enough.
    - `last_seen` string: Most recent time a listing in the country was seen, in UTC (RFC 3339).
    - `listings` integer: Number of listings in the country.
    - `listings_per_host` number: Sampled listings divided by distinct hosts, a sign of how concentrated hosting is. Omitted until the sample is large enough.
    - `metros` EsAirbnbMarketCell[]: Largest metro markets in the country, each with the same figures as a market row.
      - `avg_person_capacity` number: Average number of guests a listing sleeps, over the sampled listings. Omitted until the sample is large enough.
      - `avg_rating` number: Average listing rating across rated listings. Omitted when the market has too few rated listings.
      - `avg_review_count` number: Average number of reviews per listing.
      - `distinct_hosts` integer: Number of distinct hosts among the sampled listings. Omitted until the sample is large enough.
      - `enriched_listings` integer: Number of listings in the detail-page sample behind the reliable rates. Omitted when no listing has been sampled.
      - `guest_favorite_listings` integer: Number of listings seen with the Guest Favorite badge.
      - `guest_favorite_pct` number: Share of listings seen with the Guest Favorite badge, from 0 to 100. A lower bound, because the badge does not always show.
      - `guest_favorite_pct_enriched` number: Share of sampled listings that are Guest Favorites, from 0 to 100, taken from listing detail pages. Omitted until the sample is large enough.
      - `key` string: Market this row covers: a country code, metro name or other value of the chosen `group_by` dimension.
      - `last_seen` string: Most recent time a listing in this market was seen, in UTC (RFC 3339).
      - `listings` integer: Number of listings in the market.
      - `listings_per_host` number: Sampled listings divided by distinct hosts, a sign of how concentrated hosting is. Omitted until the sample is large enough.
      - `median_price_usd` number: Median nightly price in US dollars, converted with an approximate dated exchange rate. Omitted when too few listings have a price.
      - `rated_listings` integer: Number of listings that have a rating.
      - `superhost_listings` integer: Number of listings seen with the Superhost badge on the search card.
      - `superhost_pct` number: Share of listings seen with the Superhost badge, from 0 to 100. A lower bound, because the badge does not always show.
      - `superhost_pct_enriched` number: Share of sampled listings that are Superhosts, from 0 to 100, taken from listing detail pages. Omitted until the sample is large enough.
    - `price_usd` EsAirbnbPriceUSDStats
      - `listings` integer: Number of listings with a price converted to US dollars.
      - `p25` number: 25th percentile of the nightly price, in US dollars at an approximate dated exchange rate.
      - `p50` number: Median nightly price, in US dollars at an approximate dated exchange rate.
      - `p75` number: 75th percentile of the nightly price, in US dollars at an approximate dated exchange rate.
    - `rated_listings` integer: Number of listings that have a rating.
    - `superhost_listings` integer: Number of listings seen with the Superhost badge on the search card.
    - `superhost_pct` number: Share of listings seen with the Superhost badge, from 0 to 100. A lower bound, because the badge does not always show.
    - `superhost_pct_enriched` number: Share of sampled listings that are Superhosts, from 0 to 100, taken from listing detail pages. Omitted until the sample is large enough.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `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)