{"openapi":"3.0.3","info":{"title":"Airbnb API","version":"1.0.0","description":"**Get your API key:** subscribe on RapidAPI at [https://rapidapi.com/DataCrawlLabs/api/airbnb74](https://rapidapi.com/DataCrawlLabs/api/airbnb74). Your key is shown there as `X-RapidAPI-Key`.\n\nSend your key in the `X-RapidAPI-Key` header. Outside this page, RapidAPI also needs `X-RapidAPI-Host: airbnb74.p.rapidapi.com`."},"servers":[{"url":"https://airbnb74.p.rapidapi.com/api/v1"}],"tags":[{"name":"Common"},{"name":"Home"},{"name":"Stays"},{"name":"Experiences"},{"name":"Services"},{"name":"Profiles"}],"components":{"securitySchemes":{"RapidAPIKey":{"type":"apiKey","in":"header","name":"X-RapidAPI-Key"},"RapidAPIHost":{"type":"apiKey","in":"header","name":"X-RapidAPI-Host","description":"airbnb74.p.rapidapi.com"}}},"paths":{"/stays/autocomplete":{"get":{"tags":["Stays"],"summary":"Find a place from typed text","description":"Type the first letters of a city, area or landmark and get matching places.\n\n- Use the `placeId` of a place in Search Stays.\n- Works from the first letter. Returns up to 10 places (default 5).","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"query","in":"query","required":true,"description":"The text typed, for example Lond.","schema":{"type":"string","example":"Lond"}},{"name":"limit","in":"query","description":"How many places, 1 to 10. Default 5.","schema":{"type":"integer","minimum":1,"maximum":10,"default":5}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.count, data.places[] {name, type, placeId, acpId, query, countryCode, placeTypes[], boundingBox {southWestLatitude, southWestLongitude, northEastLatitude, northEastLongitude}}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/stays/suggested-destinations":{"get":{"tags":["Stays"],"summary":"Suggested destinations","description":"The destinations Airbnb shows on its \"Where?\" screen before anything is typed.\n\n- Returns two lists: `recent` (searches made with this session) and `suggested` (about 20 places).\n- Every place has a `placeId` for Search Stays and an `openWith` call that is ready to send.\n- The list depends on the server location, so use it as a starting list, not as a nearby search.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"latitude","in":"query","description":"With longitude. -90 to 90","schema":{"type":"number"}},{"name":"longitude","in":"query","description":"With latitude. -180 to 180","schema":{"type":"number"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.count, data.nearby {name, reason, latitude, longitude, iconUrl}, data.sections[] {type (recent or suggested), title, count, places[] {name, reason, placeId, query, checkIn, checkOut, adults, filters[] {name, value}, countryCode, iconUrl, openWith {endpoint, params[] {name, value}}}}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/stays/place-boundary":{"get":{"tags":["Stays"],"summary":"Outline of a city or area","description":"The border of a place as a GeoJSON polygon, to draw the area on a map.\n\n- Get the `acpId` from Search Stay Destinations.\n- Some places have no outline; then `status` is false.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"acpId","in":"query","required":true,"description":"Airbnb's id of the place, from GET /stays/autocomplete, e.g. 4360b783-7c07-41a0-a227-a17d1c3d3895","schema":{"type":"string","example":"4360b783-7c07-41a0-a227-a17d1c3d3895"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.acpId, data.pointCount, data.boundingBox {southWestLatitude, southWestLongitude, northEastLatitude, northEastLongitude}, data.boundary {type, coordinates}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/stays/price-trends":{"get":{"tags":["Stays"],"summary":"Cheaper and dearer dates for a place","description":"Shows which dates are cheaper (`LOW`) or dearer (`HIGH`) for a place, like the Airbnb date picker.\n\n- Send `placeId` or `query`. Coordinates alone are not enough.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"placeId","in":"query","description":"The exact place: the `placeId` from the autocomplete endpoint. Enough on its own.","schema":{"type":"string"}},{"name":"query","in":"query","description":"Place name, for example London, United Kingdom. Prefer `placeId`; send either one.","schema":{"type":"string"}},{"name":"currencyCode","in":"query","description":"Currency of the prices, 3 letters. Values: Get Currency. Default USD.","schema":{"type":"string","default":"USD"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.count, data.dates[] {date, level (LOW or HIGH)}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/stays/search":{"get":{"tags":["Stays"],"summary":"Search homes","description":"Search Airbnb homes in a place, with dates, guests and filters.\n\n- Send `placeId` from Search Stay Destinations, or a map area, or a point (latitude and longitude).\n- With dates, prices are for the whole stay.\n- Up to 40 results per page; send `nextCursor` as `cursor` to get the next page.\n- To see which filters exist for a search, call Get Stay Search Filters.\n- Flexible dates: `flexibleDays` (1, 2, 3, 7 or 14 days around your dates) or `flexibleMonths` (1 to 12 months, with `flexibleLength`).","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"placeId","in":"query","description":"The exact place: the `placeId` from the autocomplete endpoint. Enough on its own.","schema":{"type":"string"}},{"name":"query","in":"query","description":"Place name, for example London, United Kingdom. Prefer `placeId`; send either one.","schema":{"type":"string","example":"London, United Kingdom"}},{"name":"northEastLatitude","in":"query","description":"Map area: top-right corner latitude. Send all four corners; the area beats placeId and query","schema":{"type":"number","example":51.5175}},{"name":"northEastLongitude","in":"query","description":"Map area: top-right corner longitude","schema":{"type":"number","example":-0.125}},{"name":"southWestLatitude","in":"query","description":"Map area: bottom-left corner latitude (below northEastLatitude)","schema":{"type":"number","example":51.51}},{"name":"southWestLongitude","in":"query","description":"Map area: bottom-left corner longitude","schema":{"type":"number","example":-0.142}},{"name":"latitude","in":"query","description":"Stays around a point (send with longitude; not with a map area)","schema":{"type":"number","example":51.5074}},{"name":"longitude","in":"query","description":"Stays around a point (send with latitude)","schema":{"type":"number","example":-0.1278}},{"name":"flexibleDays","in":"query","description":"Dates flexible by this many days before and after checkIn/checkOut: 1, 2, 3, 7 or 14 (needs checkIn and checkOut)","schema":{"type":"integer","enum":[1,2,3,7,14]}},{"name":"flexibleMonths","in":"query","description":"Flexible dates: comma separated month names, 1 to 12, e.g. December,January (instead of checkIn/checkOut)","schema":{"type":"string","example":"December,January"}},{"name":"flexibleLength","in":"query","description":"With flexibleMonths: weekend, week or month (default week)","schema":{"type":"string","enum":["weekend","week","month"]}},{"name":"checkIn","in":"query","description":"YYYY-MM-DD (send with checkOut)","schema":{"type":"string","example":"2026-12-25"}},{"name":"checkOut","in":"query","description":"YYYY-MM-DD, after checkIn (send with checkIn)","schema":{"type":"string","example":"2026-12-27"}},{"name":"adults","in":"query","description":"1 to 16","schema":{"type":"integer","minimum":1,"maximum":16,"example":2}},{"name":"children","in":"query","description":"0 to 5","schema":{"type":"integer","minimum":0,"maximum":5}},{"name":"infants","in":"query","description":"0 to 5","schema":{"type":"integer","minimum":0,"maximum":5}},{"name":"pets","in":"query","description":"0 to 5","schema":{"type":"integer","minimum":0,"maximum":5}},{"name":"priceMin","in":"query","description":"Lowest price (whole stay when dates are sent, else per night), in currencyCode","schema":{"type":"integer","minimum":0,"maximum":1000000}},{"name":"priceMax","in":"query","description":"Highest price, in currencyCode; not below priceMin","schema":{"type":"integer","minimum":0,"maximum":1000000}},{"name":"minBedrooms","in":"query","description":"At least this many bedrooms, 0 to 16","schema":{"type":"integer","minimum":0,"maximum":16}},{"name":"minBeds","in":"query","description":"At least this many beds, 0 to 16","schema":{"type":"integer","minimum":0,"maximum":16}},{"name":"minBathrooms","in":"query","description":"At least this many bathrooms, 0 to 16","schema":{"type":"integer","minimum":0,"maximum":16}},{"name":"superhost","in":"query","description":"true = only Superhosts","schema":{"type":"boolean"}},{"name":"instantBook","in":"query","description":"true = only Instant Book listings","schema":{"type":"boolean"}},{"name":"guestFavorite","in":"query","description":"true = only Guest favourites","schema":{"type":"boolean"}},{"name":"freeCancellation","in":"query","description":"true = only flexible-cancellation listings","schema":{"type":"boolean"}},{"name":"discounted","in":"query","description":"true = only listings with a discount","schema":{"type":"boolean"}},{"name":"luxe","in":"query","description":"true = only Airbnb Luxe","schema":{"type":"boolean"}},{"name":"minRating","in":"query","description":"Lowest review score, 0 to 5","schema":{"type":"number","minimum":0,"maximum":5}},{"name":"tags","in":"query","description":"Category tags separated by commas, for example Tag:9613 (hotels). Values come from the home feed tiles.","schema":{"type":"string"}},{"name":"neighborhoodIds","in":"query","description":"Neighbourhood ids separated by commas, from the neighbourhoods section of Get Stay Search Filters.","schema":{"type":"string"}},{"name":"bathroomPrivacy","in":"query","description":"Bathroom type, from Get Stay Search Filters. ENSUITE = private attached bathroom.","schema":{"type":"string"}},{"name":"roomTypes","in":"query","description":"Comma separated: Entire home/apt, Private room, Hotel room, Shared room","schema":{"type":"string"}},{"name":"amenities","in":"query","description":"Comma separated amenity ids from GET /stays/search-filters (all must be present)","schema":{"type":"string"}},{"name":"propertyTypeIds","in":"query","description":"Comma separated property type ids from GET /stays/search-filters","schema":{"type":"string"}},{"name":"hostLanguages","in":"query","description":"Comma separated language codes the host speaks, e.g. en,fr","schema":{"type":"string"}},{"name":"limit","in":"query","description":"Listings per page, 2 to 40 (default 16)","schema":{"type":"integer","minimum":2,"maximum":40,"default":16}},{"name":"cursor","in":"query","description":"The `nextCursor` of the previous answer, to get the next page.","schema":{"type":"string"}},{"name":"currencyCode","in":"query","description":"Currency of the prices, 3 letters. Values: Get Currency. Default USD.","schema":{"type":"string","default":"USD"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.totalCount, data.resultCount, data.nextCursor, data.searchSummary, data.listings[] {listingId, url, title, name, city, latitude, longitude, rating, reviewCount, badges[], details[], photos[], price {price, amount, originalPrice, originalAmount, qualifier, description, breakdown[], notes[] (\"Price may vary by room type\", \"<host> recently lowered the price ...\")}, bedCount}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/stays/search-filters":{"get":{"tags":["Stays"],"summary":"Filters available for a search","description":"The live filter menu for a search: sections, options, result counts and the parameter each option sets.\n\n- Takes the same place, dates and guests as Search Stays.\n- To apply an option, send its `searchParam` name with its value to Search Stays. Several options of one section are comma separated.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"placeId","in":"query","description":"The exact place: the `placeId` from the autocomplete endpoint. Enough on its own.","schema":{"type":"string"}},{"name":"query","in":"query","description":"Place name, for example London, United Kingdom. Prefer `placeId`; send either one.","schema":{"type":"string","example":"London, United Kingdom"}},{"name":"checkIn","in":"query","description":"YYYY-MM-DD (send with checkOut)","schema":{"type":"string","example":"2026-12-25"}},{"name":"checkOut","in":"query","description":"YYYY-MM-DD, after checkIn (send with checkIn)","schema":{"type":"string","example":"2026-12-27"}},{"name":"adults","in":"query","description":"1 to 16","schema":{"type":"integer","minimum":1,"maximum":16,"example":2}},{"name":"children","in":"query","description":"0 to 5","schema":{"type":"integer","minimum":0,"maximum":5}},{"name":"infants","in":"query","description":"0 to 5","schema":{"type":"integer","minimum":0,"maximum":5}},{"name":"currencyCode","in":"query","description":"Currency of the prices, 3 letters. Values: Get Currency. Default USD.","schema":{"type":"string","default":"USD"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.totalCount, data.sections[] {sectionId, title, options[] {kind, title, subtitle, params[] {key, value, searchParam, remove}, minValue, maxValue, histogram}}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/stays/details":{"get":{"tags":["Stays"],"summary":"Listing details","description":"The listing page: title, rating, highlights, description, location and house facts.\n\n- Get the `listingId` from Search Stays.\n- An unknown id returns `status:false`.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"listingId","in":"query","required":true,"description":"The `listingId` of a search result, e.g. 1772056939923148193","schema":{"type":"string","example":"1772056939923148193"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data {listingId, url, title, heading, propertyType, spaceType, maxGuests, summary[], description, highlights[], isGuestFavorite, isNewListing, isLuxe, rating {average, count, categories[], distribution[], tags[], reviewSorts[]}, host {name, isSuperhost, pictureUrl, userId, contextualUserId}, location {name, subtitle, country, latitude, longitude, about[]}, guestLimits}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/stays/amenities":{"get":{"tags":["Stays"],"summary":"Listing amenities","description":"All amenities of a listing, grouped, including the ones that are not available.\n\n- Get the `listingId` from Search Stays.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"listingId","in":"query","required":true,"description":"The `listingId` of a search result, e.g. 1772056939923148193","schema":{"type":"string","example":"1772056939923148193"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.title, data.count, data.popular[] {amenityId, title, available, icon, note}, data.groups[] {groupId, title, amenities[]}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/stays/photos":{"get":{"tags":["Stays"],"summary":"Listing photos","description":"Every photo of a listing with its caption, grouped by room.\n\n- Get the `listingId` from Search Stays.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"listingId","in":"query","required":true,"description":"The `listingId` of a search result, e.g. 1772056939923148193","schema":{"type":"string","example":"1772056939923148193"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.count, data.photos[] {photoId, url, caption, aspectRatio}, data.rooms[] {stopId, name, descriptions, photos[]}, data.sleeping[] (the beds, same shape as rooms)","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/stays/policies":{"get":{"tags":["Stays"],"summary":"House rules and cancellation policy","description":"House rules, safety information and cancellation policy of a listing.\n\n- Send `checkIn` and `checkOut` to get the cancellation timeline with real dates.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"listingId","in":"query","required":true,"description":"The `listingId` of a search result, e.g. 1772056939923148193","schema":{"type":"string","example":"1772056939923148193"}},{"name":"checkIn","in":"query","description":"YYYY-MM-DD (send with checkOut)","schema":{"type":"string","example":"2026-12-25"}},{"name":"checkOut","in":"query","description":"YYYY-MM-DD, after checkIn (send with checkIn)","schema":{"type":"string","example":"2026-12-27"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.summary[], data.houseRules {title, description, groups[]}, data.safetyAndProperty {title, description, groups[]}, data.cancellationPolicy {policyId, title, timeline[] {when, dates, refund, terms, description}, notes[]}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/stays/host":{"get":{"tags":["Stays"],"summary":"Host of a listing","description":"The \"Meet your host\" section: name, Superhost status, years hosting, response rate and co-hosts.\n\n- To open the host profile, send the long `contextualUserId` to Get Profile Details. Co-hosts have their own `contextualUserId`.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"listingId","in":"query","required":true,"description":"The `listingId` of a search result, e.g. 1772056939923148193","schema":{"type":"string","example":"1772056939923148193"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data {name, userId, contextualUserId, pictureUrl, isSuperhost, isVerified, isAirbnbManaged, title, hostingYears, hostingMonths, rating, reviewCount, about, responseRate, responseTime, canBeMessaged, highlights[] {type (Airbnb sends null), icon, text}, coHosts[] {name, contextualUserId, pictureUrl}}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/stays/pricing":{"get":{"tags":["Stays"],"summary":"Price for your dates","description":"The price of a listing for your dates and guests, with the full breakdown (nightly rate, fees, taxes).\n\n- Without `checkIn` and `checkOut` there is no price: `data.price` is null.\n- Infants do not change the price.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"listingId","in":"query","required":true,"description":"The `listingId` of a search result, e.g. 1772056939923148193","schema":{"type":"string","example":"1772056939923148193"}},{"name":"checkIn","in":"query","description":"YYYY-MM-DD (send with checkOut)","schema":{"type":"string","example":"2026-12-25"}},{"name":"checkOut","in":"query","description":"YYYY-MM-DD, after checkIn (send with checkIn)","schema":{"type":"string","example":"2026-12-27"}},{"name":"adults","in":"query","description":"1 to 16","schema":{"type":"integer","minimum":1,"maximum":16,"example":2}},{"name":"children","in":"query","description":"0 to 5","schema":{"type":"integer","minimum":0,"maximum":5}},{"name":"infants","in":"query","description":"0 to 5","schema":{"type":"integer","minimum":0,"maximum":5}},{"name":"pets","in":"query","description":"0 to 5","schema":{"type":"integer","minimum":0,"maximum":5}},{"name":"currencyCode","in":"query","description":"Currency of the prices, 3 letters. Values: Get Currency. Default USD.","schema":{"type":"string","default":"USD"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data {available, canInstantBook, unavailabilityReason, unavailabilityMessage, dates, price, amount, originalPrice, originalAmount, qualifier, description, breakdown[] {description, price, amount, originalPrice}, cancellationNote, tip, announcement, guestLimits}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/stays/reviews":{"get":{"tags":["Stays"],"summary":"Listing reviews","description":"Guest reviews of a listing, page by page.\n\n- Use `limit` (1 to 50) and `offset` to page. Sort with `sortBy`.\n- `tag` narrows the reviews to a topic from the \"Guests mention\" list in the answer.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"listingId","in":"query","required":true,"description":"The `listingId` of a search result, e.g. 1772056939923148193","schema":{"type":"string","example":"1772056939923148193"}},{"name":"limit","in":"query","description":"1 to 50 (default 20)","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"offset","in":"query","description":"Reviews to skip (default 0)","schema":{"type":"integer","minimum":0,"maximum":100000,"default":0}},{"name":"sortBy","in":"query","description":"MOST_RECENT, RATING_DESC or RATING_ASC","schema":{"type":"string","enum":["MOST_RECENT","RATING_DESC","RATING_ASC"]}},{"name":"tag","in":"query","description":"A review topic, e.g. LOCATION","schema":{"type":"string"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.totalCount, data.resultCount, data.tags[] {tag, label, count}, data.reviews[] {reviewId, createdAt, date, rating, room (the room type stayed in), comment, originalComment, language, translatedNotice, highlight, reviewer, host, hostResponse, respondedDate, photos}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/stays/availability-calendar":{"get":{"tags":["Stays"],"summary":"Availability calendar","description":"Which days of a listing are free, month by month, with check-in and check-out rules and minimum nights.\n\n- Starts at `month` and `year` (default: this month) and covers `months` months (1 to 12, default 12). The window ends 36 months from now.\n- Airbnb sends no price per day; use Get Stay Pricing for a price.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"listingId","in":"query","required":true,"description":"The `listingId` of a search result, e.g. 1772056939923148193","schema":{"type":"string","example":"1772056939923148193"}},{"name":"month","in":"query","description":"1 to 12","schema":{"type":"integer","minimum":1,"maximum":12}},{"name":"year","in":"query","description":"e.g. 2026","schema":{"type":"integer","minimum":2020,"maximum":2100}},{"name":"months","in":"query","description":"How many months, 1 to 12 (default 12)","schema":{"type":"integer","minimum":1,"maximum":12,"default":12}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.listingId, data.firstBookableDate, data.constantMinNights, data.months[] {month, year, days[] {date, available, bookable, canCheckIn, canCheckOut, minNights, maxNights}}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/experiences/autocomplete":{"get":{"tags":["Experiences"],"summary":"Find a place for experiences","description":"Type the first letters of a city, area or landmark and get matching places.\n\n- Use the `placeId` in Search Experiences. The ids are the same as in the stays and services lookups.\n- Returns up to 10 places (default 5).","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"query","in":"query","required":true,"description":"The text typed, for example Lond.","schema":{"type":"string","example":"Lond"}},{"name":"limit","in":"query","description":"How many places, 1 to 10. Default 5.","schema":{"type":"integer","minimum":1,"maximum":10,"default":5}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.count, data.places[] {name, type, placeId, acpId, query, countryCode, placeTypes[], boundingBox {southWestLatitude, southWestLongitude, northEastLatitude, northEastLongitude}}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/experiences/search":{"get":{"tags":["Experiences"],"summary":"Search experiences","description":"Search Airbnb Experiences (tours, classes, activities) in a place.\n\n- Send `placeId` from Search Experience Destinations. Add dates, guests and filters if you like.\n- Up to 40 results per page; send `nextCursor` as `cursor` for the next page. Durations are in minutes.\n- To see the available filters call Get Experience Search Filters.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"placeId","in":"query","description":"The exact place: the `placeId` from the autocomplete endpoint. Enough on its own.","schema":{"type":"string"}},{"name":"query","in":"query","description":"Place name, for example London, United Kingdom. Prefer `placeId`; send either one.","schema":{"type":"string","example":"Paris, France"}},{"name":"checkIn","in":"query","description":"YYYY-MM-DD (send with checkOut)","schema":{"type":"string","example":"2026-11-25"}},{"name":"checkOut","in":"query","description":"YYYY-MM-DD, after checkIn (send with checkIn)","schema":{"type":"string","example":"2026-11-28"}},{"name":"adults","in":"query","description":"1 to 16","schema":{"type":"integer","minimum":1,"maximum":16,"example":2}},{"name":"children","in":"query","description":"0 to 5","schema":{"type":"integer","minimum":0,"maximum":5}},{"name":"infants","in":"query","description":"0 to 5","schema":{"type":"integer","minimum":0,"maximum":5}},{"name":"categoryTags","in":"query","description":"Comma separated category tags from GET /experiences/search-filters, e.g. Tag:5348","schema":{"type":"string"}},{"name":"attractionTags","in":"query","description":"Attraction tags separated by commas, taken from an attraction tile of the home feed.","schema":{"type":"string"}},{"name":"featuredTags","in":"query","description":"Comma separated featured tags","schema":{"type":"string"}},{"name":"ticketTags","in":"query","description":"Comma separated ticket tags","schema":{"type":"string"}},{"name":"travelerTags","in":"query","description":"Comma separated traveler-type tags","schema":{"type":"string"}},{"name":"accessibilityTags","in":"query","description":"Comma separated accessibility tags","schema":{"type":"string"}},{"name":"priceMin","in":"query","description":"Lowest price per guest, in currencyCode","schema":{"type":"integer","minimum":0,"maximum":1000000}},{"name":"priceMax","in":"query","description":"Highest price per guest, in currencyCode; not below priceMin","schema":{"type":"integer","minimum":0,"maximum":1000000}},{"name":"minDuration","in":"query","description":"Shortest duration in MINUTES, 0 to 1440","schema":{"type":"integer","minimum":0,"maximum":1440}},{"name":"maxDuration","in":"query","description":"Longest duration in MINUTES, 0 to 1440; not below minDuration","schema":{"type":"integer","minimum":0,"maximum":1440}},{"name":"timeOfDay","in":"query","description":"Comma separated: morning, afternoon, evening","schema":{"type":"string"}},{"name":"languages","in":"query","description":"Comma separated language ids from GET /experiences/search-filters","schema":{"type":"string"}},{"name":"topRated","in":"query","description":"true = only top-rated experiences","schema":{"type":"boolean"}},{"name":"limit","in":"query","description":"Experiences per page, 2 to 40 (default 16)","schema":{"type":"integer","minimum":2,"maximum":40,"default":16}},{"name":"cursor","in":"query","description":"The `nextCursor` of the previous answer, to get the next page.","schema":{"type":"string"}},{"name":"currencyCode","in":"query","description":"Currency of the prices, 3 letters. Values: Get Currency. Default USD.","schema":{"type":"string","default":"USD"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.totalCount, data.resultCount, data.nextCursor, data.experiences[] {experienceId, url, title, description, theme, rating, reviewCount, durationMinutes, badges[], price {price, amount, qualifier, description, breakdown[], notes[] (e.g. \"Last-minute discount applied\", \"Ages 18 and up\")}, paymentMessages[] (e.g. \"Book off-peak and save\"), photos[], nextSession}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/experiences/search-filters":{"get":{"tags":["Experiences"],"summary":"Filters available for experiences","description":"The live filter menu for a place: categories, tags, price range, duration, time of day and languages.\n\n- To apply an option, send its `searchParam` name with its value to Search Experiences.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"placeId","in":"query","description":"The exact place: the `placeId` from the autocomplete endpoint. Enough on its own.","schema":{"type":"string"}},{"name":"query","in":"query","description":"Place name, for example London, United Kingdom. Prefer `placeId`; send either one.","schema":{"type":"string","example":"Paris, France"}},{"name":"checkIn","in":"query","description":"YYYY-MM-DD (send with checkOut)","schema":{"type":"string","example":"2026-11-25"}},{"name":"checkOut","in":"query","description":"YYYY-MM-DD, after checkIn (send with checkIn)","schema":{"type":"string","example":"2026-11-28"}},{"name":"adults","in":"query","description":"1 to 16","schema":{"type":"integer","minimum":1,"maximum":16,"example":2}},{"name":"children","in":"query","description":"0 to 5","schema":{"type":"integer","minimum":0,"maximum":5}},{"name":"infants","in":"query","description":"0 to 5","schema":{"type":"integer","minimum":0,"maximum":5}},{"name":"currencyCode","in":"query","description":"Currency of the prices, 3 letters. Values: Get Currency. Default USD.","schema":{"type":"string","default":"USD"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.totalCount, data.sections[] {sectionId, title, options[] {kind, title, subtitle, params[] {key, value, searchParam, remove}, minValue, maxValue, histogram}}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/experiences/details":{"get":{"tags":["Experiences"],"summary":"Experience details","description":"The experience page: description, meeting point, location, hosts, highlights, what to bring, cancellation text, agenda, rating and photos.\n\n- Get the `experienceId` from Search Experiences.\n- Every host has a `contextualUserId` for the Profiles endpoints.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"experienceId","in":"query","required":true,"description":"The `experienceId` of a search result, e.g. 6785604","schema":{"type":"string","example":"6785604"}},{"name":"currencyCode","in":"query","description":"Currency of the prices, 3 letters. Values: Get Currency. Default USD.","schema":{"type":"string","default":"USD"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.experienceId, url, shareUrl, title, description, meetingPoint, category, theme, location {city, address, latitude, longitude}, guestRequirements {minAge, childrenAllowed, childrenMinAge, childrenMaxAge, infantsAllowed}, highlights[] {type, title, text, imageUrl}, tips[] {type, name}, hosts[] {isPrimary, name, userId, contextualUserId, jobTitle, pictureUrl}, aboutHost, thingsToKnow[] {type, title, text, icon}, vetting {title, text}, agendaIntro, agenda[] {title, description, imageUrl}, rating {average, count, writtenCount}, photos[] {imageId, url, aspectRatio}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/experiences/pricing":{"get":{"tags":["Experiences"],"summary":"Experience price","description":"The \"from\" price of an experience, per guest, with its breakdown.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"experienceId","in":"query","required":true,"description":"The `experienceId` of a search result, e.g. 6785604","schema":{"type":"string","example":"6785604"}},{"name":"adults","in":"query","description":"1 to 16","schema":{"type":"integer","minimum":1,"maximum":16,"example":2}},{"name":"children","in":"query","description":"0 to 5","schema":{"type":"integer","minimum":0,"maximum":5}},{"name":"infants","in":"query","description":"0 to 5","schema":{"type":"integer","minimum":0,"maximum":5}},{"name":"currencyCode","in":"query","description":"Currency of the prices, 3 letters. Values: Get Currency. Default USD.","schema":{"type":"string","default":"USD"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.experienceId, data.price {price, amount, qualifier, description, breakdown[]}, data.tips, data.offerings","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/experiences/sessions":{"get":{"tags":["Experiences"],"summary":"Bookable sessions","description":"Bookable sessions of an experience: date, time, remaining seats and price, per offering.\n\n- Set the window with `from` and `to`. Only real availability is returned.\n- Up to 100 sessions per offering (default 50).\n- This API does not book; `offeringId` and `availabilityKey` are for reference.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"experienceId","in":"query","required":true,"description":"The `experienceId` of a search result, e.g. 6785604","schema":{"type":"string","example":"6785604"}},{"name":"from","in":"query","description":"First day, YYYY-MM-DD (default today)","schema":{"type":"string","example":"2026-10-27"}},{"name":"to","in":"query","description":"Last day, YYYY-MM-DD, not before `from`, at most 366 days after it (default: a month after `from`)","schema":{"type":"string","example":"2026-11-26"}},{"name":"adults","in":"query","description":"1 to 16","schema":{"type":"integer","minimum":1,"maximum":16,"example":2}},{"name":"children","in":"query","description":"0 to 5","schema":{"type":"integer","minimum":0,"maximum":5}},{"name":"infants","in":"query","description":"0 to 5","schema":{"type":"integer","minimum":0,"maximum":5}},{"name":"limit","in":"query","description":"Sessions per offering, 1 to 100 (default 50)","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"currencyCode","in":"query","description":"Currency of the prices, 3 letters. Values: Get Currency. Default USD.","schema":{"type":"string","default":"USD"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.experienceId, data.timeZone, data.city, data.offerings[] {offeringId, maxGuestsPublicGroup, maxGuestsPrivateGroup, freeForInfants, hasNextPage, sessions[] {availabilityKey, day, time, startTime, endTime, startsAtUtc, remainingCapacity, soldOut, lowAvailability, privateBookable, price, pricePerGuest}}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/experiences/calendar":{"get":{"tags":["Experiences"],"summary":"Experience calendar","description":"Which days an experience has a session.\n\n- The window can be up to 366 days.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"experienceId","in":"query","required":true,"description":"The `experienceId` of a search result, e.g. 6785604","schema":{"type":"string","example":"6785604"}},{"name":"from","in":"query","description":"First day, YYYY-MM-DD (default today)","schema":{"type":"string","example":"2026-10-27"}},{"name":"to","in":"query","description":"Last day, YYYY-MM-DD, not before `from`, at most 366 days after it (default: a month after `from`)","schema":{"type":"string","example":"2026-11-26"}},{"name":"adults","in":"query","description":"1 to 16","schema":{"type":"integer","minimum":1,"maximum":16}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.count, data.availableCount, data.days[] {date, available}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/experiences/reviews":{"get":{"tags":["Experiences"],"summary":"Experience reviews","description":"Guest reviews of an experience, page by page.\n\n- Use `limit` (1 to 50) and `offset` to page.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"experienceId","in":"query","required":true,"description":"The `experienceId` of a search result, e.g. 6785604","schema":{"type":"string","example":"6785604"}},{"name":"limit","in":"query","description":"1 to 50 (default 20)","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"offset","in":"query","description":"Reviews to skip (default 0)","schema":{"type":"integer","minimum":0,"maximum":100000,"default":0}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.resultCount, data.hasNextPage, data.reviews[] {reviewId, createdAt, date, rating, comment, originalComment, language, offering, paidPromotionNotice, reviewer, host, hostResponse, respondedDate}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/experiences/similar":{"get":{"tags":["Experiences"],"summary":"Similar experiences","description":"The \"More experiences\" row at the bottom of an experience page.\n\n- Each card has an `experienceId` that opens Get Experience Details.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"experienceId","in":"query","required":true,"description":"The `experienceId` of a search result, e.g. 6785604","schema":{"type":"string","example":"6785604"}},{"name":"currencyCode","in":"query","description":"Currency of the prices, 3 letters. Values: Get Currency. Default USD.","schema":{"type":"string","default":"USD"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.count, data.experiences[] {experienceId, url, title, theme, rating, reviewCount, durationMinutes, price {price, amount, qualifier, description, breakdown[], notes[]}, photos[], location, description, badges[], paymentMessages[], nextSession}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/services/autocomplete":{"get":{"tags":["Services"],"summary":"Find a place for services","description":"Type the first letters of a city, area or landmark and get matching places.\n\n- Use the `placeId` in Get Service Types. The ids are the same as in the stays and experiences lookups.\n- Returns up to 10 places (default 5).","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"query","in":"query","required":true,"description":"The text typed, for example Lond.","schema":{"type":"string","example":"Lond"}},{"name":"limit","in":"query","description":"How many places, 1 to 10. Default 5.","schema":{"type":"integer","minimum":1,"maximum":10,"default":5}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.count, data.places[] {name, type, placeId, acpId, query, countryCode, placeTypes[], boundingBox {southWestLatitude, southWestLongitude, northEastLatitude, northEastLongitude}}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/services/types":{"get":{"tags":["Services"],"summary":"Service types in a place","description":"The kinds of service offered in a place (photography, chefs, massage and more).\n\n- Use the `serviceType` of a type in Search Services.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"placeId","in":"query","description":"The exact place: the `placeId` from the autocomplete endpoint. Enough on its own.","schema":{"type":"string"}},{"name":"query","in":"query","description":"Place name, for example London, United Kingdom. Prefer `placeId`; send either one.","schema":{"type":"string","example":"Paris, France"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.place, data.count, data.types[] {title, serviceType, imageUrl}, data.partnerServices[] {title, imageUrl}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/services/search":{"get":{"tags":["Services"],"summary":"Search services","description":"Search Airbnb Services (chefs, photographers and more) of one type in a place.\n\n- Send `placeId` and `serviceType` from Get Service Types.\n- Up to 40 results per page; send `nextCursor` as `cursor` for the next page.\n- To see the available filters call Get Service Search Filters.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"placeId","in":"query","description":"The exact place: the `placeId` from the autocomplete endpoint. Enough on its own.","schema":{"type":"string"}},{"name":"query","in":"query","description":"Place name, for example London, United Kingdom. Prefer `placeId`; send either one.","schema":{"type":"string","example":"Paris, France"}},{"name":"serviceType","in":"query","required":true,"description":"The kind of service, a tag from GET /services/types, e.g. Tag:8952","schema":{"type":"string","example":"Tag:8952"}},{"name":"checkIn","in":"query","description":"A day to check, YYYY-MM-DD","schema":{"type":"string","example":"2026-10-29"}},{"name":"adults","in":"query","description":"1 to 16","schema":{"type":"integer","minimum":1,"maximum":16}},{"name":"children","in":"query","description":"0 to 5","schema":{"type":"integer","minimum":0,"maximum":5}},{"name":"infants","in":"query","description":"0 to 5","schema":{"type":"integer","minimum":0,"maximum":5}},{"name":"priceMin","in":"query","description":"Lowest price per guest","schema":{"type":"integer","minimum":0,"maximum":1000000}},{"name":"priceMax","in":"query","description":"Highest price per guest","schema":{"type":"integer","minimum":0,"maximum":1000000}},{"name":"minDuration","in":"query","description":"Shortest duration in minutes","schema":{"type":"integer","minimum":0,"maximum":1440}},{"name":"maxDuration","in":"query","description":"Longest duration in minutes","schema":{"type":"integer","minimum":0,"maximum":1440}},{"name":"timeOfDay","in":"query","description":"Comma separated: morning, afternoon, evening","schema":{"type":"string"}},{"name":"accessibilityTags","in":"query","description":"Accessibility tags separated by commas, from the search filters endpoint.","schema":{"type":"string"}},{"name":"languages","in":"query","description":"Comma separated language ids from GET /services/search-filters","schema":{"type":"string"}},{"name":"limit","in":"query","description":"Services per page, 2 to 40 (default 16)","schema":{"type":"integer","minimum":2,"maximum":40,"default":16}},{"name":"cursor","in":"query","description":"The `nextCursor` of the previous answer, to get the next page.","schema":{"type":"string"}},{"name":"currencyCode","in":"query","description":"Currency of the prices, 3 letters. Values: Get Currency. Default USD.","schema":{"type":"string","default":"USD"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.totalCount, data.resultCount, data.nextCursor, data.services[] {serviceId, url, title, description, category, rating, reviewCount, yearsOfExperience, where, duration, host {name, pictureUrl}, badges[], price {price, amount, qualifier, description, breakdown[], notes[] (e.g. \"Minimum $135 USD to book\", \"Up to 10 guests\")}, paymentMessages[], photo, nextAvailabilityKey}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/services/search-filters":{"get":{"tags":["Services"],"summary":"Filters available for services","description":"The live filter menu for one service type in a place.\n\n- To apply an option, send its `searchParam` name with its value to Search Services.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"placeId","in":"query","description":"The exact place: the `placeId` from the autocomplete endpoint. Enough on its own.","schema":{"type":"string"}},{"name":"query","in":"query","description":"Place name, for example London, United Kingdom. Prefer `placeId`; send either one.","schema":{"type":"string","example":"Paris, France"}},{"name":"serviceType","in":"query","required":true,"description":"The kind of service, a tag from GET /services/types, e.g. Tag:8952","schema":{"type":"string","example":"Tag:8952"}},{"name":"currencyCode","in":"query","description":"Currency of the prices, 3 letters. Values: Get Currency. Default USD.","schema":{"type":"string","default":"USD"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.totalCount, data.sections[] {sectionId, title, options[] {kind, title, subtitle, params[] {key, value, searchParam, remove}, minValue, maxValue, histogram}}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/services/details":{"get":{"tags":["Services"],"summary":"Service details","description":"The service page: description, meeting point, location, service area, host with qualifications, guest requirements, cancellation text, rating and photos.\n\n- Get the `serviceId` from Search Services.\n- Prices are in Get Service Offerings. The host `contextualUserId` opens the Profiles endpoints.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"serviceId","in":"query","required":true,"description":"The `serviceId` of a search result, e.g. 6740930","schema":{"type":"string","example":"6740930"}},{"name":"currencyCode","in":"query","description":"Currency of the prices, 3 letters. Values: Get Currency. Default USD.","schema":{"type":"string","default":"USD"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.serviceId, url, shareUrl, title, description, meetingPoint, category, hostTitle, providedAt, meetingTypes[], location {city, address, latitude, longitude, serviceAreaText, serviceArea}, host {name, userId, contextualUserId, jobTitle, pictureUrl, about, qualifications[] {icon, title, description}}, thingsToKnow[] {type, title, text, icon}, rating {average, count, writtenCount}, galleryTitle, photos[] {imageId, url, aspectRatio}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/services/offerings":{"get":{"tags":["Services"],"summary":"Service packages and prices","description":"What the provider offers: each package with title, description, duration and price, plus the \"from\" price and the cancellation rule.\n\n- Set the window with `from` and `to` (up to 366 days).","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"serviceId","in":"query","required":true,"description":"The `serviceId` of a search result, e.g. 6740930","schema":{"type":"string","example":"6740930"}},{"name":"from","in":"query","description":"First day, YYYY-MM-DD (default today)","schema":{"type":"string","example":"2026-10-29"}},{"name":"to","in":"query","description":"Last day, YYYY-MM-DD, not before `from`. Default one month after `from`.","schema":{"type":"string","example":"2026-10-31"}},{"name":"adults","in":"query","description":"1 to 16","schema":{"type":"integer","minimum":1,"maximum":16}},{"name":"children","in":"query","description":"0 to 5","schema":{"type":"integer","minimum":0,"maximum":5}},{"name":"infants","in":"query","description":"0 to 5","schema":{"type":"integer","minimum":0,"maximum":5}},{"name":"currencyCode","in":"query","description":"Currency of the prices, 3 letters. Values: Get Currency. Default USD.","schema":{"type":"string","default":"USD"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.serviceId, data.fromPrice (the \"From $19 per guest\" of the page), data.showOfferingDuration, data.cancellation {type, name, description} (\"Free cancellation, up to 1 day before start time\"), data.offerings[] {offeringId, title, description, duration, imageUrl, price, availability}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/services/location":{"get":{"tags":["Services"],"summary":"Service location","description":"Where the service takes place: the area covered, whether a custom location is allowed and how it is booked.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"serviceId","in":"query","required":true,"description":"The `serviceId` of a search result, e.g. 6740930","schema":{"type":"string","example":"6740930"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.host, data.title, data.subtitle, data.allowsCustomLocation, data.serviceArea {northEast {latitude, longitude}, southWest {latitude, longitude}}, data.coordinate {latitude, longitude}, data.bookingFlow (INSTANT_BOOK = booked at once), data.bookingWarning, data.locationTitle","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/services/calendar":{"get":{"tags":["Services"],"summary":"Service calendar","description":"Which days the provider is free.\n\n- The window can be up to 366 days.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"serviceId","in":"query","required":true,"description":"The `serviceId` of a search result, e.g. 6740930","schema":{"type":"string","example":"6740930"}},{"name":"from","in":"query","description":"First day, YYYY-MM-DD (default today)","schema":{"type":"string","example":"2026-10-29"}},{"name":"to","in":"query","description":"Last day, YYYY-MM-DD, not before `from`. Default one month after `from`.","schema":{"type":"string","example":"2026-10-31"}},{"name":"adults","in":"query","description":"1 to 16","schema":{"type":"integer","minimum":1,"maximum":16}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.count, data.availableCount, data.days[] {date, available}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/services/slots":{"get":{"tags":["Services"],"summary":"Service time slots","description":"Packages with their start times and price, per day.\n\n- The window is at most 14 days.\n- This API does not book; `offeringId` and `availabilityKey` are for reference.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"serviceId","in":"query","required":true,"description":"The `serviceId` of a search result, e.g. 6740930","schema":{"type":"string","example":"6740930"}},{"name":"from","in":"query","description":"First day, YYYY-MM-DD (default today)","schema":{"type":"string","example":"2026-10-29"}},{"name":"to","in":"query","description":"Last day, YYYY-MM-DD, not before `from`, at most 14 days after it.","schema":{"type":"string","example":"2026-10-31"}},{"name":"adults","in":"query","description":"1 to 16","schema":{"type":"integer","minimum":1,"maximum":16}},{"name":"currencyCode","in":"query","description":"Currency of the prices, 3 letters. Values: Get Currency. Default USD.","schema":{"type":"string","default":"USD"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.title, data.host, data.days[] {date, available, offerings[] {offeringId, title, description, duration, durationMinutes, maxGuestsPrivateGroup, photo, price, slots[] {availabilityKey, startTime, startsAtUtc, price, tips[]}}}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/services/reviews":{"get":{"tags":["Services"],"summary":"Service reviews","description":"Guest reviews of a service, page by page.\n\n- Use `limit` (1 to 50) and `offset` to page.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"serviceId","in":"query","required":true,"description":"The `serviceId` of a search result, e.g. 6740930","schema":{"type":"string","example":"6740930"}},{"name":"limit","in":"query","description":"1 to 50 (default 20)","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"offset","in":"query","description":"Reviews to skip (default 0)","schema":{"type":"integer","minimum":0,"maximum":100000,"default":0}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.resultCount, data.hasNextPage, data.reviews[] {reviewId, createdAt, date, rating, comment, originalComment, language, offering (the package booked), paidPromotionNotice, reviewer, host, hostResponse, respondedDate}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/profiles/details":{"get":{"tags":["Profiles"],"summary":"Profile of a host or guest","description":"The public profile: name, verification, host or guest badges, ratings, time on Airbnb and highlighted reviews.\n\n- Send the long `contextualUserId` from Get Stay Host, Get Stay Details or Get Stay Reviews. The short `userId` does not work.\n- An unknown id returns `status:false`.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"userId","in":"query","required":true,"description":"The long user id (about 19 digits): `contextualUserId` from the stays endpoints, or `userId` from the experience and service reviews.","schema":{"type":"string","example":"1584884159059872779"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.profile {id, displayFirstName, isAHost, isSuperHost, verificationInfo, userRepresentationUrl, timeAsHost, hostRatingStats, ...}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/profiles/past-locations":{"get":{"tags":["Profiles"],"summary":"Places a person has stayed","description":"Places this person has stayed. Shown only when the person made them public, so the list is often empty, especially for hosts.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"userId","in":"query","required":true,"description":"The long user id (about 19 digits): `contextualUserId` from the stays endpoints, or `userId` from the experience and service reviews.","schema":{"type":"string","example":"1584884159059872779"}},{"name":"limit","in":"query","description":"1 to 50 (default 50)","schema":{"type":"integer","minimum":1,"maximum":50,"default":50}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.count, data.hasNextPage, data.locations[]","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/profiles/reviews":{"get":{"tags":["Profiles"],"summary":"Reviews about a person","description":"Reviews written about this person.\n\n- `type=guests` (default): reviews from guests. `type=hosts`: reviews from hosts.\n- Use `limit` (1 to 50, default 10) and `offset` to page.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"userId","in":"query","required":true,"description":"The long user id (about 19 digits): `contextualUserId` from the stays endpoints, or `userId` from the experience and service reviews.","schema":{"type":"string","example":"1584884159059872779"}},{"name":"type","in":"query","description":"guests = reviews from guests, hosts = reviews from hosts (default guests)","schema":{"type":"string","enum":["guests","hosts"],"default":"guests"}},{"name":"limit","in":"query","description":"1 to 50 (default 10)","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}},{"name":"offset","in":"query","description":"Reviews to skip (default 0)","schema":{"type":"integer","minimum":0,"maximum":100000,"default":0}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"data.resultCount, data.hasNextPage, data.reviews[] {reviewId, type, createdAt, rating, comment, translatedComment, language, revieweeRole, paidPromotionNotice, reviewer {userId, name, location, pictureUrl, superhost}, reviewee, response, respondedAt}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/home/tabs":{"get":{"tags":["Home"],"summary":"Home tabs","description":"The tabs along the top of the Airbnb app: All, Homes, Hotels, Experiences and Services.\n\n- Use a `tab` value in Get Home Feed.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"responses":{"200":{"description":"data.count, data.tabs[] {tab, name}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}},"parameters":[{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}]}},"/home/feed":{"get":{"tags":["Home"],"summary":"Home feed","description":"The home screen of one tab: rows of homes, hotels, experiences or services such as \"Homes in Pune\".\n\n- Pick the tab with `tab` (see Get Home Tabs).\n- Each row has `openWith`: the call that opens its \"see all\" list. Cards have an id for the detail endpoints.\n- One call returns one page of rows. Send `nextCursor` as `cursor` for the next page; when it is null the feed has ended.\n- The places shown follow the server location, not your coordinates.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"parameters":[{"name":"tab","in":"query","description":"Tab from Get Home Tabs: all, stays, hotels, experiences or services. Default all.","schema":{"type":"string","default":"all"}},{"name":"cursor","in":"query","description":"The `nextCursor` of the previous answer, to get the next page.","schema":{"type":"string"}},{"name":"currencyCode","in":"query","description":"Currency of the prices, 3 letters. Values: Get Currency. Default USD.","schema":{"type":"string","default":"USD"}},{"name":"languageCode","in":"query","description":"Language of the texts, for example en-GB, fr or ja. Values: Get Languages. Default en-GB.","schema":{"type":"string","default":"en-GB"}},{"name":"sessionId","in":"query","description":"Optional. A default session is prefilled. Create your own with Create Session.","schema":{"type":"string","pattern":"^[a-f0-9]{40}$","default":"cfae564947d6c3e6d2557c9387ac93aa3147d410","example":"cfae564947d6c3e6d2557c9387ac93aa3147d410"}}],"responses":{"200":{"description":"Home feed: one page of the feed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object","properties":{"tab":{"type":"string","example":"all"},"nextCursor":{"type":"string","nullable":true,"description":"Send as `cursor` for the next page; null = the feed has ended"},"sectionCount":{"type":"integer","description":"Number of sections on this page"},"shortcuts":{"type":"array","description":"The \"Continue searching\" card (first page only, empty if the device has no recent search)","items":{"type":"object","properties":{"type":{"type":"string","example":"CONTINUE_SEARCHING"},"title":{"type":"string","example":"Continue searching for photographers in Paris"},"dates":{"type":"string","example":"20–22 Feb 2027","nullable":true},"guests":{"type":"string","example":"2 guests","nullable":true},"imageUrls":{"type":"array","items":{"type":"string","example":"https://a0.muscache.com/im/pictures/airbnb-platform-assets/AirbnbPlatformAssets-ServicesTy…"}},"search":{"type":"object","properties":{"placeId":{"type":"string","example":"ChIJD7fiBh9u5kcRYJSMaMOCCwQ"},"query":{"type":"string","example":"Paris, France"},"checkIn":{"type":"string","example":"2027-02-20","nullable":true},"checkOut":{"type":"string","example":"2027-02-22","nullable":true},"adults":{"type":"integer","example":2,"nullable":true}}}}}},"sections":{"type":"array","description":"The carousels and headings of this page, in screen order. Every section has the same fields.","items":{"type":"object","properties":{"type":{"type":"string","enum":["carousel","header"],"description":"carousel = a row of cards; header = a heading line between carousels (e.g. \"Popular with travellers from your area\"), with no cards"},"sectionId":{"type":"string","example":"HOMES_RECENT_SEARCH_SUGGESTED_TRIP:Montbéliard"},"title":{"type":"string","example":"Based on your Montbéliard search","nullable":true},"subtitle":{"type":"string","example":"Industrial town near Montbeliard","nullable":true},"place":{"type":"object","properties":{"placeId":{"type":"string","example":"ChIJ2XrI1owWkkcRENoTszTOCQQ","nullable":true},"query":{"type":"string","example":"25200 Montbéliard, France","nullable":true}},"nullable":true},"kinds":{"type":"array","items":{"type":"string","enum":["homes","experiences","services","tiles"]},"description":"The kinds of card in items (a carousel has one kind)"},"openWith":{"type":"object","properties":{"endpoint":{"type":"string","example":"/stays/search","nullable":true},"params":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","example":"placeId"},"value":{"description":"String, number or true/false","oneOf":[{"type":"string"},{"type":"integer"},{"type":"boolean"}]}}}},"note":{"type":"string","example":"Airbnb sends no \"see all\" for this row; this is the closest call of ours, not an exact cop…","nullable":true}},"description":"The \"see all\" of the carousel: our endpoint and its parameters, ready to send, with the carousel's filters (hotels only, free cancellation, service type, flexible dates ...). Use this rather than `place`, which loses those filters. Some rows have no exact \"see all\"; then `openWith` holds the closest call and `note` says so. `endpoint` is null for headings and for rows whose cards are the buttons (use the call of each card)."},"items":{"type":"array","description":"The cards. Every card has `kind`: homes = a stay (the fields of one /stays/search result), experiences = the fields of one /experiences/search result, services = the fields of one /services/search result, tiles = a destination, theme, service type, partner tile or banner. Cards of one kind always have the same fields.","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["homes"]},"listingId":{"type":"string","example":"1431827952815462675"},"url":{"type":"string","example":"https://www.airbnb.com/rooms/1431827952815462675"},"title":{"type":"string","example":"Room in Montbéliard"},"name":{"type":"string","example":"Cozy break in Montbéliard"},"city":{"nullable":true,"description":"Always null in the samples"},"latitude":{"nullable":true,"description":"Always null in the samples"},"longitude":{"nullable":true,"description":"Always null in the samples"},"rating":{"type":"number","example":4.97,"nullable":true},"reviewCount":{"nullable":true,"description":"Always null in the samples"},"ratingText":{"type":"string","example":"4.97","nullable":true},"badges":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","example":"TOP_X_GUEST_FAVORITE"},"text":{"type":"string","example":"Guest favourite"}}}},"details":{"type":"array","items":{}},"highlights":{"type":"array","items":{}},"photos":{"type":"array","items":{"type":"object","properties":{"photoId":{"type":"string","example":"2192253023"},"url":{"type":"string","example":"https://a0.muscache.com/im/pictures/hosting/Hosting-1431827952815462675/original/c9334a7a-…"},"aspectRatio":{"type":"number","example":1.3333333333333333}}}},"price":{"type":"object","properties":{"price":{"type":"string","example":"$99 USD"},"amount":{"type":"integer","example":99},"originalPrice":{"type":"string","example":"$210 USD","nullable":true},"originalAmount":{"type":"integer","example":210,"nullable":true},"qualifier":{"type":"string","example":"total"},"description":{"type":"string","example":"$99 USD total"},"notes":{"type":"array","items":{}},"breakdown":{"type":"array","items":{}}}},"paymentMessages":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","example":"STAY_EARLY_BIRD_DISCOUNT_HIGHLIGHT"},"text":{"type":"string","example":"Book early to save"}}}},"bedCount":{"nullable":true,"description":"Always null in the samples"}}},{"type":"object","properties":{"kind":{"type":"string","enum":["experiences"]},"experienceId":{"type":"string","example":"7286500"},"location":{"type":"string","example":"Paris, France","nullable":true},"url":{"type":"string","example":"https://www.airbnb.com/experiences/7286500"},"title":{"type":"string","example":"Freeflow cold plunge & sauna at Sant Roch"},"description":{"type":"string","example":"Access all spaces freely and compose your own ritual at your own pace. An autonomous sessi…"},"theme":{"nullable":true,"description":"Always null in the samples"},"rating":{"type":"number","example":4.86},"reviewCount":{"type":"integer","example":88},"durationMinutes":{"nullable":true,"description":"Always null in the samples"},"badges":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","example":"EXPERIENCE_BADGE_POPULAR"},"text":{"type":"string","example":"Trending"}}}},"price":{"type":"object","properties":{"prefix":{"type":"string","example":"From"},"price":{"type":"string","example":"$51 USD"},"amount":{"type":"integer","example":51},"originalPrice":{"nullable":true,"description":"Always null in the samples"},"originalAmount":{"nullable":true,"description":"Always null in the samples"},"qualifier":{"type":"string","example":"/ guest"},"description":{"type":"string","example":"From $51 USD per guest"},"breakdown":{"type":"array","items":{}},"notes":{"type":"array","items":{}}}},"paymentMessages":{"type":"array","items":{}},"photos":{"type":"array","items":{"type":"string","example":"https://a0.muscache.com/im/pictures/Mt/MtTemplate-7286500/original/52fbfc81-7d17-4611-afdc…"}},"nextSession":{"nullable":true,"description":"Always null in the samples"}}},{"type":"object","properties":{"kind":{"type":"string","enum":["services"]},"serviceId":{"type":"string","example":"7340658"},"url":{"type":"string","example":"https://www.airbnb.com/services/7340658"},"title":{"type":"string","example":"Professional photography"},"description":{"type":"string","example":"It will always be a pleasure to capture images of the fabulous people that you are."},"category":{"nullable":true,"description":"Always null in the samples"},"rating":{"type":"number","example":0},"reviewCount":{"type":"integer","example":0},"yearsOfExperience":{"nullable":true,"description":"Always null in the samples"},"where":{"nullable":true,"description":"Always null in the samples"},"duration":{"nullable":true,"description":"Always null in the samples"},"highlight":{"nullable":true,"description":"Always null in the samples"},"host":{"type":"object","properties":{"name":{"type":"string","example":"Morgan"},"pictureUrl":{"type":"string","example":"https://a0.muscache.com/im/pictures/user/User/original/52f6ab5b-7d54-47d4-a0e6-02b5f6e4249…"}}},"badges":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","example":"SERVICE_BADGE_POPULAR"},"text":{"type":"string","example":"Popular"}}}},"price":{"type":"object","properties":{"prefix":{"type":"string","example":"From"},"price":{"type":"string","example":"$90 USD"},"amount":{"type":"integer","example":90},"originalPrice":{"nullable":true,"description":"Always null in the samples"},"originalAmount":{"nullable":true,"description":"Always null in the samples"},"qualifier":{"type":"string","example":"/ guest"},"description":{"type":"string","example":"From $90 USD per guest"},"breakdown":{"type":"array","items":{}},"notes":{"type":"array","items":{"type":"string","example":"Minimum $135 USD to book"}}}},"paymentMessages":{"type":"array","items":{}},"photo":{"type":"string","example":"https://a0.muscache.com/im/pictures/Mt/MtTemplate-7340658/original/9776dbc3-588b-417f-865b…"},"nextAvailabilityKey":{"type":"string","example":"LBas960GGBgyMDI3LTAyLTIyVDA5OjAwOjAwLjAwMFoAAA=="}}},{"type":"object","properties":{"kind":{"type":"string","enum":["tiles"]},"type":{"type":"string","enum":["search","partner","promotion","spotlight","other"],"description":"search = a card that opens a search (destination, theme, attraction, service type): use opens, placeId, query, dates and filters; partner = a partner's order flow such as Car hire (partnerCategory); promotion = a banner with a button and a url (the url is a search, so openWith is filled); spotlight = the big banner of the services tab; other = a card type Airbnb added that we have not seen yet (only title, subtitle, imageUrl)"},"title":{"type":"string","example":"Get 15% Airbnb credit at featured hotels in Paris"},"subtitle":{"type":"string","example":"Prime beach spot","nullable":true},"imageUrl":{"type":"string","example":"https://a0.muscache.com/pictures/AirbnbPlatformAssets/AirbnbPlatformAssets-Spotlight-2026/…"},"opens":{"type":"string","example":"homes","nullable":true,"enum":["homes","hotels","experiences","services",null],"description":"Which search the card leads to (homes and hotels are both /stays/search)"},"placeId":{"type":"string","example":"ChIJD7fiBh9u5kcRYJSMaMOCCwQ"},"query":{"type":"string","example":"Dubai","nullable":true},"checkIn":{"type":"string","example":"2027-02-20","nullable":true},"checkOut":{"type":"string","example":"2027-02-22","nullable":true},"adults":{"type":"integer","example":4,"nullable":true},"filters":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","example":"kg_and_tags"},"value":{"type":"string","example":"Tag:9613"}}},"description":"The tile's search filters exactly as Airbnb names them, as {name, value} pairs, e.g. {name: \"service_type_tag\", value: \"Tag:8949\"}. For information only: use openWith, which has them translated to our parameter names."},"openWith":{"type":"object","properties":{"endpoint":{"type":"string","example":"/stays/search","nullable":true},"params":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","example":"placeId"},"value":{"description":"String, number or true/false","oneOf":[{"type":"string"},{"type":"integer"},{"type":"boolean"}]}}}},"note":{"nullable":true,"description":"Always null in the samples"}},"description":"WHAT TO CALL WHEN THE USER TAPS THE TILE: `endpoint` is our endpoint and `params` are its parameters in OUR names, ready to send as they are (value is a string, number or true/false). endpoint is null for tiles that do not open a search (type partner, e.g. Car hire: a partner's own order flow). A promotion opens the search written in its url, so it has a call too. `note` is null for an exact call. Add your own adults, dates, languageCode and currencyCode as needed."},"buttonText":{"type":"string","example":"Browse hotels","nullable":true},"url":{"type":"string","example":"https://www.airbnb.co.uk/s/homes?place_id=ChIJD7fiBh9u5kcRYJSMaMOCCwQ&refinement_paths%5B%…","nullable":true},"partnerCategory":{"type":"string","example":"CAR_RENTALS","nullable":true},"disabled":{"nullable":true,"description":"Always null in the samples"}}}]}}}}}}}}}}}}}}},"/common/sessions":{"post":{"tags":["Common"],"summary":"Create a session","description":"Returns a new `sessionId`. Send it as the optional `sessionId` on the other endpoints.\n\n- A session remembers its searches, and Get Home Feed is built from them.\n- Without a `sessionId` a default session is used.\n- Limit: 10 new sessions per hour.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"responses":{"200":{"description":"data.sessionId (40 hex characters)","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/common/languages":{"get":{"tags":["Common"],"summary":"Supported languages","description":"The accepted `languageCode` values (64), each checked against Airbnb.\n\n- A fixed list; it does not use your monthly quota.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"responses":{"200":{"description":"data.count, data.languages[] {code, name}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/common/currencies":{"get":{"tags":["Common"],"summary":"Supported currencies","description":"The accepted `currencyCode` values (69), each checked against Airbnb.\n\n- A fixed list; it does not use your monthly quota.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}],"responses":{"200":{"description":"data.count, data.currencies[] {code, name}","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/common/server-status":{"get":{"tags":["Common"],"summary":"Server status","responses":{"200":{"description":"data.server (\"online\"), data.timestamp (current server time, ISO 8601)","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"true on success, false on any error"},"message":{"type":"string"},"data":{"type":"object"}}}}}}},"description":"Answers \"online\" while the service is running. No parameters; it does not use your monthly quota.","security":[{"RapidAPIKey":[],"RapidAPIHost":[]}]}}}}