Crawlora icon

Crawlora

Get structured web data from the public web via the Crawlora API

Actions166

Datasets → Datasets Airbnb Markets Search

AI-generated

Summary

Searches Airbnb listing counts grouped into country, market, administrative region, locality, room type, or property type cells. Apply optional location, listing quality, freshness, and minimum-count filters, then sort and paginate the results; provide the required API key.

Inputs

  • Group By — Dimension for aggregating results: country (default), market, admin1, locality, room_type, or property_type.
  • Country — Exact ISO-3166-1 alpha-2 country code filter, such as FR.
  • Market — Exact metro-market filter, such as Paris; up to 128 characters.
  • Superhost — When enabled (default), count only Superhost listings.
  • Guest Favorite — When enabled (default), count only Guest Favorite listings. The badge under-counts, so this is an observed lower bound.
  • Min Rating — Minimum listing rating from 0 through 5; defaults to 0.
  • Min Review Count — Minimum listing review count, 0 or greater; defaults to 0.
  • Active Since — ISO-8601 date (YYYY-MM-DD); counts only listings last seen on or after that date.
  • Min Listings — Minimum listings per result cell. Raises the small-cell suppression floor and cannot lower the built-in minimum.
  • Sort — Sort order: listings_desc (default), superhost_pct_desc, rating_desc, or key_asc.
  • Page — Page number; the UI default is 0 while the parameter description says the API defaults to 1.
  • Page Size — Results per page; the UI default is 0 while the parameter description says the API defaults to 20. Maximum 100; page × page_size must be no greater than 10000.
  • X Api Key (required) — API key sent in the x-api-key request header.
  • Request Options — Optional HTTP request settings, including batching, accepting invalid SSL certificates, an HTTP proxy, and a response-header timeout.

Output shape

A paginated response containing aggregated Airbnb listing data grouped into cells.

The source pack does not show the response body schema. Cell counts may be suppressed for small groups; Guest Favorite counts are an observed lower bound.

Examples

Example 1: Count listings by country

Leave Group By at country and optionally filter by listing quality, freshness, and minimum cell size.

Example 2: Inspect Paris market data by room type

Set Group By to room_type and Market to Paris; use page and page_size to browse results.

Links

Discussion