Airbnb Markets Dataset Search API

Endpoint facts

Method

GET

API path

/datasets/airbnb-markets/search

Auth

apiKey

Credits

2 credits/request

Platform

Datasets

Response schema

#/definitions/datasets.airbnbMarketsSearchResponseDoc

Overview

Returns aggregate Airbnb short-term-rental market rollups from the dataset id enum value `airbnb-markets`. Aggregate-only: each row is a market cell, never an individual listing. Thin cells are suppressed. group_by enum: `country`, `market`, `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). `admin1`, `locality`, `room_type` and `property_type` are enrichment-derived and stay empty until their coverage is high enough to be reliable. Each cell also carries `median_price_usd`, the median nightly price converted to USD via an approximate dated FX snapshot, for cross-country comparison (combine with `group_by=room_type` for median price by room type); `guest_favorite_pct`, the share of listings carrying the Guest Favorite badge (an observed lower bound, like `superhost_pct`); and `avg_person_capacity`, the average guests a listing sleeps over the detail-page-enriched sample. Sort enum: `listings_desc`, `superhost_pct_desc`, `rating_desc`, `key_asc`. 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

2 credits/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

- Grouping by `admin1`, `locality`, `room_type` or `property_type` returns enrichment-derived market cells (sub-country geography, or accommodation type). `admin1`/`locality` come from a reverse-geocode pass, `room_type` (`entire_place`, `private_room`, `hotel`, `shared_room`) is classified from each listing's search-card descriptor going forward, and `property_type` (Airbnb's finer canonical type) is read from the listing detail page. Because each covers a growing share of the census, these dimensions return an **empty `items` array until that coverage is high enough** for the cell counts to be reliable, then fill in on their own as coverage grows. `country` and `market` are always available. - `avg_person_capacity` is the average number of guests a listing sleeps, computed over the cell's detail-page-enriched sample; like the `*_enriched` fields it is reported only once that sample is large enough to be reliable. Combine it with `median_price_usd` for a rough price-per-guest read. - Pairing `group_by=room_type` with `median_price_usd` gives the median nightly USD price per accommodation type (e.g. entire homes vs private rooms), optionally filtered to one `country` or `market`. - `median_price_usd` is the cell's median nightly price converted to USD via an **approximate, dated FX snapshot**, so markets are price-comparable across countries despite Airbnb localizing the display currency. It is reported only for cells with enough USD-normalized priced listings and is a market-level approximation, not an exact conversion. - `avg_rating` is reported only for cells with enough rated listings, so a handful of reviews never swings a published market average; it is omitted otherwise. - `superhost_pct` is the Superhost share of the cell, from `0` through `100`. It is an **observed lower bound**: it counts listings seen carrying the Superhost badge on the search card, which renders inconsistently, so it under-counts. - `guest_favorite_pct` is the share of the cell's listings carrying the Guest Favorite badge, from `0` through `100`, with `guest_favorite_listings` the underlying count. 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, computed over a **random sample** of the cell's listings enriched from the listing detail page (enrichment draws a representative sample, so the rate is unbiased even at partial coverage). It, along with `enriched_listings` (the size of that enriched sample), `distinct_hosts` (the number of distinct operators among the enriched listings) and `listings_per_host` (`enriched_listings / distinct_hosts`, an operator-concentration signal), is reported **only once the enriched sample is large enough to be reliable**; all four are omitted until then. Detail-page enrichment covers a growing subset of the census, so these fields appear for more markets over time. `distinct_hosts` is an aggregate count only — no host identity is ever returned. - `guest_favorite_pct_enriched` is the **reliable** Guest Favorite share over that same detail-page-enriched sample (the listing detail page carries an authoritative Guest Favorite flag, unlike the inconsistent search-card badge behind `guest_favorite_pct`). It is reported under the same gate as `superhost_pct_enriched` and omitted until the enriched sample is large enough. - The `min_listings` field in the response echoes the effective suppression floor that was applied. - The maximum result window is `10000`; `page * page_size` must not exceed `10000`. - Invalid enum values return the standard invalid params envelope. - Returns an empty `items` array (not an error) when no cell clears the suppression floor. - Does not trigger live scraping. Example response: ```json { "code": 200, "msg": "OK", "data": { "dataset": "airbnb-markets", "group_by": "country", "items": [ { "key": "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, "median_price_usd": 148, "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" } ], "page": 1, "page_size": 20, "total": 1, "sort": "listings_desc", "min_listings": 50 } } ```

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