Airbnb Markets Dataset Country API

Endpoint facts

Method

GET

API path

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

Auth

apiKey

Credits

1 credit/request

Platform

Datasets

Response schema

#/definitions/datasets.airbnbMarketResponseDoc

Overview

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. Developers commonly use this endpoint for repeatable dataset search, filtering, facets, local business enrichment, analytics, exports, and internal tools that need structured records beyond the limited manual refinement available in the Google Maps app. Authentication uses the x-api-key header, usage is metered with the credit cost shown on this page, and the request does not trigger live scraping or proxy routing.

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost

1 credit/request

Charged response

Successful 2xx responses

Infrastructure behavior

This endpoint reads stored indexed dataset records. It does not execute a live upstream Google Maps request, browser session, or proxy-routed scraping job.

• Data source: stored Crawlora dataset records
• Proxy strategy: no proxy routing is applied
• Browser rendering: not used for dataset search or lookup requests
• Live scraping: not triggered by dataset list, search, nearby, facet, or detail endpoints
• Validation: invalid filters, coordinates, pagination, and enum values return documented errors
• Billing: credits are charged only for successful 2xx responses
• Observability: responses include request context where available

Browser cluster behavior

Some targets require real browser execution because the data is loaded through JavaScript, dynamic rendering, or interaction-like browser behavior.

For supported endpoints, Crawlora can route requests through a managed browser cluster. This allows Crawlora to execute JavaScript, load dynamic content, apply browser-level request behavior, and normalize the rendered result into JSON.

You do not need to operate your own Playwright, Puppeteer, Chrome, proxy, queue, or retry infrastructure.

Response behavior

- `avg_rating` is included only when the country has enough rated listings. - `superhost_pct` is an **observed lower bound** — it counts listings seen carrying the search-card Superhost badge, which renders inconsistently and under-counts. - `guest_favorite_pct` (with `guest_favorite_listings`) is the share of the country's listings carrying the Guest Favorite badge. Like `superhost_pct` it is an **observed lower bound** — the badge renders inconsistently on the search card, so it under-counts. - `superhost_pct_enriched` is the **reliable** Superhost share over a **random sample** of the country's listings enriched from the listing detail page (the sample is representative, so the rate is unbiased at partial coverage); `enriched_listings` (the sample size), `distinct_hosts` (distinct operators among the enriched listings) and `listings_per_host` (`enriched_listings / distinct_hosts`, an operator-concentration signal) accompany it. All four appear **only once the enriched sample is large enough to be reliable**, and are omitted otherwise; they populate for more countries over time as enrichment coverage grows. `distinct_hosts` is an aggregate count only — no host identity is returned. - `guest_favorite_pct_enriched` is the **reliable** Guest Favorite share over that same detail-page-enriched sample (the detail page carries an authoritative Guest Favorite flag, unlike the inconsistent search-card badge behind `guest_favorite_pct`), reported under the same gate as `superhost_pct_enriched` and omitted until the sample is large enough. - `avg_person_capacity` is the average number of guests a listing sleeps, over that same detail-page-enriched sample; reported under the same gate and omitted otherwise. Combine with `price_usd`/`currencies` medians for a rough price-per-guest read. - `currencies` prices are per-currency medians; most listings are priced in USD, so those are broadly comparable across countries. - `currencies` reports the 25th/50th/75th nightly-price percentiles for each currency with enough priced listings. - `price_usd` reports the country-wide 25th/50th/75th nightly-price percentiles normalized to USD via an **approximate, dated FX snapshot** — the cross-country-comparable complement to the per-currency `currencies` block. It is a market-level approximation (rates drift), not an exact conversion, and is present only when enough listings carry a USD-normalized price. - `metros` lists the country's largest metro markets that clear the suppression floor; each metro also carries `median_price_usd`, its median nightly price in USD (same approximate FX snapshot). - Returns `404` with the standard error envelope when the country has no listings above the suppression floor. - Does not trigger live scraping. Example response: ```json { "code": 200, "msg": "OK", "data": { "country": "US", "listings": 1212294, "superhost_listings": 303073, "superhost_pct": 25, "guest_favorite_listings": 121229, "guest_favorite_pct": 10, "rated_listings": 776000, "avg_rating": 4.72, "avg_review_count": 31.5, "enriched_listings": 280000, "superhost_pct_enriched": 29.4, "guest_favorite_pct_enriched": 18.7, "avg_person_capacity": 4.2, "distinct_hosts": 214500, "listings_per_host": 1.31, "last_seen": "2026-07-03T00:00:00Z", "bounds": { "top_left": { "lat": 71.4, "lon": -177.1 }, "bottom_right": { "lat": 18.9, "lon": -66.9 } }, "metros": [ { "key": "Austin", "listings": 12040, "superhost_listings": 6020, "superhost_pct": 50, "guest_favorite_listings": 3010, "guest_favorite_pct": 25, "rated_listings": 9800, "avg_rating": 4.9, "median_price_usd": 205 } ], "currencies": [ { "currency": "USD", "listings": 512000, "p25": 95, "p50": 150, "p75": 260 } ], "price_usd": { "listings": 534000, "p25": 96, "p50": 152, "p75": 265 } } } ```

Error behavior

Crawlora does not silently return invalid dataset search results when filters, pagination, coordinates, or stored record lookups cannot be satisfied.

When possible, Crawlora returns structured error context so your integration can adjust filters, page size, location inputs, or lookup identifiers.

Related