datasets_airbnb_search
Search aggregate Airbnb short-term rental market data by country, market, room type, or property type, with filters for ratings, superhosts, and guest favorites.
Instructions
Search the Airbnb markets dataset. 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). Enrichment-derived groupings include a coverage object with the number and share of filtered listings carrying that dimension; the 20% minimum gate is not a completeness guarantee, and counts still describe classified rows only. 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. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, defaults to 1 | |
| sort | No | Sort enum: listings_desc, superhost_pct_desc, rating_desc, key_asc | |
| market | No | Exact metro-market filter, e.g. Paris, max 128 characters | |
| country | No | Exact ISO-3166-1 alpha-2 country filter, e.g. FR | |
| group_by | No | Aggregate cell dimension enum: country, market, admin1, locality, room_type, property_type. Defaults to country | |
| page_size | No | Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000 | |
| superhost | No | Count only Superhost listings | |
| min_rating | No | Minimum listing rating, from 0 through 5 | |
| active_since | No | Freshness filter, an ISO-8601 date (YYYY-MM-DD); only listings last seen on or after it are counted | |
| min_listings | No | Minimum listings per cell; raises the small-cell suppression floor (never lowered below the built-in minimum) | |
| guest_favorite | No | Count only Guest Favorite listings (an observed lower bound; the badge under-counts) | |
| min_review_count | No | Minimum listing review count, 0 or greater |