{"openapi":"3.1.0","info":{"title":"AirBnb API — RealtyAPI","version":"1.0.0","description":"AirBnb API endpoints All endpoints require an API key sent in the `x-realtyapi-key` header. Get a key and try every endpoint interactively at https://www.realtyapi.io/api/airbnb.","contact":{"name":"RealtyAPI","url":"https://www.realtyapi.io","email":"support@realtyapi.io"}},"externalDocs":{"description":"Interactive API playground and docs","url":"https://www.realtyapi.io/api/airbnb"},"servers":[{"url":"https://airbnb.realtyapi.io"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"Tools","description":"Tools endpoints"},{"name":"📚 Get Details","description":"📚 Get Details endpoints"},{"name":"🔎 Search Airbnb","description":"🔎 Search Airbnb endpoints"},{"name":"🔝 Filters (stays)","description":"🔝 Filters (stays) endpoints"}],"paths":{"/categories":{"get":{"operationId":"get_categories","summary":"categories","tags":["Tools"],"parameters":[{"name":"language_code","in":"query","required":false,"schema":{"type":"string"},"description":"All supported language codes can be found on the `/language_codes` endpoint.","example":"en-US"}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"Get the list of categories just like on Airbnb."}},"/home/details":{"get":{"operationId":"get_home_details","summary":"home details","tags":["📚 Get Details"],"parameters":[{"name":"stayListingId","in":"query","required":true,"schema":{"type":"string"},"description":"You can find the ID from the  experiences search endpoint `output > searchResults > listing > id`","example":"RGVtYW5kU3RheUxpc3Rpbmc6MTI1NTc2NzAzNTg2MDMzMTgxOQ=="},{"name":"checkIn","in":"query","required":true,"schema":{"type":"string"},"description":"Format: `YYYY-MM-DD`\n\nChoose a check‑in date from today onward and a check‑out date after that."},{"name":"checkOut","in":"query","required":true,"schema":{"type":"string"},"description":"Format: `YYYY-MM-DD`"}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"Get home details."}},"/autocomplete":{"get":{"operationId":"get_autocomplete","summary":"autocomplete","tags":["🔎 Search Airbnb"],"parameters":[{"name":"keyword","in":"query","required":true,"schema":{"type":"string"},"description":"Enter any `keyword/location` to get the auto-completion.","example":"paris"},{"name":"language_code","in":"query","required":false,"schema":{"type":"string"},"description":"All supported language codes can be found on the `/language_codes` endpoint.","example":"en-US"}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"Get autocomplete results just like on Airbnb."}},"/filter/accessibility":{"get":{"operationId":"get_filter_accessibility","summary":"filter/accessibility","tags":["🔝 Filters (stays)"],"parameters":[{"name":"language_code","in":"query","required":false,"schema":{"type":"string"},"description":"All supported language codes can be found on the `/language_codes` endpoint.","example":"en-US"}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"accessibilities filter list."}},"/currencies":{"get":{"operationId":"get_currencies","summary":"currencies","tags":["Tools"],"parameters":[],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"Get the list of currencies available."}},"/home/availability":{"get":{"operationId":"get_home_availability","summary":"home availability","tags":["📚 Get Details"],"parameters":[{"name":"listingId","in":"query","required":true,"schema":{"type":"string"},"description":"You can find listingId from /home details endpoint `output > baseData > metadata > clientLoggingContext > productId`","example":"868126372367701281"}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"Airbnb home availability"}},"/search/homes/bydestination":{"get":{"operationId":"get_search_homes_bydestination","summary":"🏠  homes/bydestination","tags":["🔎 Search Airbnb"],"parameters":[{"name":"searchDestinations","in":"query","required":true,"schema":{"type":"string"},"description":"Enter any `destination/location` to search.","example":"toronto, canada"},{"name":"checkIn","in":"query","required":false,"schema":{"type":"string"},"description":"- Pick any check‑in date from today onward (sorry, no time travel).\n- If used, `flexibleStayPeriod` or `months` parameters will be ignored."},{"name":"checkOut","in":"query","required":false,"schema":{"type":"string"},"description":"- Choose a check‑in date from today onward and a check‑out date after that.\n- If used, `flexibleStayPeriod` or `months` parameters will be ignored."},{"name":"flexibleDateFilters","in":"query","required":false,"schema":{"type":"string","enum":["Exact_dates","plusminus_1day","plusminus_2days","plusminus_3days","plusminus_7days","plusminus_14days"]},"description":"Set the flexible days limit."},{"name":"months","in":"query","required":false,"schema":{"type":"string","enum":["None","1","2","3","4","5","6","7","8","9","10","11","12"]},"description":"- Select the number of months for stay\n- It will automatically select the 1st date of next month to the 1st of last month selected."},{"name":"flexibleStayPeriod","in":"query","required":false,"schema":{"type":"string","enum":["Weekend","Week","Month"]}},{"name":"goAnytimeMonths","in":"query","required":false,"schema":{"type":"string"},"description":"- Type the month's name in lowercase, separated with a comma. \n- Lists that are available anytime within the selected months will show.","example":"january,february,march"},{"name":"adults","in":"query","required":false,"schema":{"type":"number"},"description":"Ages `13` or above","example":2},{"name":"children","in":"query","required":false,"schema":{"type":"number"},"description":"Ages `2-12`"},{"name":"infants","in":"query","required":false,"schema":{"type":"number"},"description":"Ages `2` or below"},{"name":"pets","in":"query","required":false,"schema":{"type":"number"}},{"name":"nextPageCursor","in":"query","required":false,"schema":{"type":"string"},"description":"Enter the value found from the last page's response.\nEx. `eyJzZWN0aW9uX29mZnNldCI6MCwiaXRlbXNfb2Zmc2V0IjoxNiwidmVyc2lvbiI6MX0=`"},{"name":"imFlexibleOfDestination","in":"query","required":false,"schema":{"type":"boolean"},"description":"Search for any `random places/destination`"},{"name":"resultsType","in":"query","required":false,"schema":{"type":"string","enum":["search_results","map_results","map_plus_search_results"]},"description":"What do you want to get as output:\n- search_results: the list of places.\n- map_results: results from the map.\n- Both: Combine both types.\n\n----------------- `Search Result Filters` -----------------\n"},{"name":"typeOfPlace","in":"query","required":false,"schema":{"type":"string","enum":["Any_type","Room","Entire_home"]}},{"name":"currency","in":"query","required":false,"schema":{"type":"string"},"example":"USD"},{"name":"priceRangeMin","in":"query","required":false,"schema":{"type":"number"},"example":20},{"name":"priceRangeMax","in":"query","required":false,"schema":{"type":"number"},"example":5000},{"name":"bedrooms","in":"query","required":false,"schema":{"type":"number"},"example":2},{"name":"beds","in":"query","required":false,"schema":{"type":"number"},"example":2},{"name":"bathrooms","in":"query","required":false,"schema":{"type":"number"},"example":2},{"name":"amenities","in":"query","required":false,"schema":{"type":"string"},"description":"Put amenities numbers separated with a comma. \nEx. `4, 8, 33`\n- You can find the list of amenities in the `/filter/amenities` endpoint."},{"name":"bookingOptions","in":"query","required":false,"schema":{"type":"string"},"description":"Separate with a comma:\n- Available Filters: `instant book, self checkin, allow pets, free cancellation`\n- You can set one or more."},{"name":"guestFavorite","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"luxuryHomes","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"superhost","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"propertyType","in":"query","required":false,"schema":{"type":"string"},"description":"Separate with a comma:\n- Available Options: `House, Flat, Guest house, Hotel`\n- You can set one or more."},{"name":"accessibilityFeatures","in":"query","required":false,"schema":{"type":"string"},"description":"Separate with a comma:\n- Available values can be found at the `/filter/accessibility` endpoint.\n- Example: **110, 111, 291**"},{"name":"hostLanguages","in":"query","required":false,"schema":{"type":"string"},"description":"Separate with a comma:\n- Available values can be found at the `/filter/host_language` endpoint.\n- Example: **zh, de**"}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"Search Airbnb website via destination/location input."}},"/filter/amenities":{"get":{"operationId":"get_filter_amenities","summary":"filter/amenities","tags":["🔝 Filters (stays)"],"parameters":[{"name":"language_code","in":"query","required":false,"schema":{"type":"string"},"description":"All supported language codes can be found on the `/language_codes` endpoint.","example":"en-US"}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"Amenities filter list."}},"/language_codes":{"get":{"operationId":"get_language_codes","summary":"language_codes","tags":["Tools"],"parameters":[],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"Get all the language codes available."}},"/home/reviews":{"get":{"operationId":"get_home_reviews","summary":"home reviews","tags":["📚 Get Details"],"parameters":[{"name":"stayListingId","in":"query","required":true,"schema":{"type":"string"},"description":"You can find the ID from the experiences search endpoint `output > searchResults > listing > id`","example":"U3RheUxpc3Rpbmc6MTExNjA4Mjc3OTc0NDI3OTM4Nw=="},{"name":"offset","in":"query","required":false,"schema":{"type":"string"},"description":"Offset is the start index. The default is 0.","example":"0"},{"name":"reviewLimit","in":"query","required":false,"schema":{"type":"string"},"description":"Number of reviews to return","example":"20"},{"name":"sortingPreference","in":"query","required":false,"schema":{"type":"string","enum":["most_relevant","highest_rated","lowest_rated","most_recent"]}}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"Get airbnb home review details"}},"/search/homes/byplaceid":{"get":{"operationId":"get_search_homes_byplaceid","summary":"🏠 homes/byplaceid","tags":["🔎 Search Airbnb"],"parameters":[{"name":"placeId","in":"query","required":true,"schema":{"type":"string"},"description":"Enter place_id for any location.\n- Ex. `ChIJpTvG15DL1IkRd8S0KlBVNTI`","example":"ChIJpTvG15DL1IkRd8S0KlBVNTI"},{"name":"checkIn","in":"query","required":false,"schema":{"type":"string"},"description":"- Pick any check‑in date from today onward (sorry, no time travel).\n- If used, `flexibleStayPeriod` or `months` parameters will be ignored."},{"name":"checkOut","in":"query","required":false,"schema":{"type":"string"},"description":"- Choose a check‑in date from today onward and a check‑out date after that.\n- If used, `flexibleStayPeriod` or `months` parameters will be ignored."},{"name":"flexibleDateFilters","in":"query","required":false,"schema":{"type":"string","enum":["Exact_dates","plusminus_1day","plusminus_2days","plusminus_3days","plusminus_7days","plusminus_14days"]},"description":"Set the flexible days limit."},{"name":"months","in":"query","required":false,"schema":{"type":"string","enum":["None","1","2","3","4","5","6","7","8","9","10","11","12"]},"description":"- Select the number of months for stay\n- It will automatically select the 1st date of next month to the 1st of last month selected."},{"name":"flexibleStayPeriod","in":"query","required":false,"schema":{"type":"string","enum":["Weekend","Week","Month"]}},{"name":"goAnytimeMonths","in":"query","required":false,"schema":{"type":"string"},"description":"- Type the month's name in lowercase, separated with a comma. \n- Lists that are available anytime within the selected months will show.","example":"january,february,march"},{"name":"adults","in":"query","required":false,"schema":{"type":"number"},"description":"Ages `13` or above","example":2},{"name":"children","in":"query","required":false,"schema":{"type":"number"},"description":"Ages `2-12`"},{"name":"infants","in":"query","required":false,"schema":{"type":"number"},"description":"Ages `2` or below"},{"name":"pets","in":"query","required":false,"schema":{"type":"number"}},{"name":"nextPageCursor","in":"query","required":false,"schema":{"type":"string"},"description":"Enter the value found from the last page's response.\nEx. `eyJzZWN0aW9uX29mZnNldCI6MCwiaXRlbXNfb2Zmc2V0IjoxNiwidmVyc2lvbiI6MX0=`"},{"name":"imFlexibleOfDestination","in":"query","required":false,"schema":{"type":"boolean"},"description":"Search for any `random places/destination`"},{"name":"resultsType","in":"query","required":false,"schema":{"type":"string","enum":["search_results","map_results","map_plus_search_results"]},"description":"What do you want to get as output:\n- search_results: the list of places.\n- map_results: results from the map.\n- Both: Combine both types.\n\n----------------- `Search Result Filters` -----------------\n"},{"name":"typeOfPlace","in":"query","required":false,"schema":{"type":"string","enum":["Any_type","Room","Entire_home"]}},{"name":"currency","in":"query","required":false,"schema":{"type":"string"},"example":"USD"},{"name":"priceRangeMin","in":"query","required":false,"schema":{"type":"number"},"example":20},{"name":"priceRangeMax","in":"query","required":false,"schema":{"type":"number"},"example":5000},{"name":"bedrooms","in":"query","required":false,"schema":{"type":"number"},"example":2},{"name":"beds","in":"query","required":false,"schema":{"type":"number"},"example":2},{"name":"bathrooms","in":"query","required":false,"schema":{"type":"number"},"example":2},{"name":"amenities","in":"query","required":false,"schema":{"type":"string"},"description":"Put amenities numbers separated with a comma. \nEx. `4, 8, 33`\n- You can find the list of amenities in the `/filter/amenities` endpoint."},{"name":"bookingOptions","in":"query","required":false,"schema":{"type":"string"},"description":"Separate with a comma:\n- Available Filters: `instant book, self checkin, allow pets, free cancellation`\n- You can set one or more."},{"name":"guestFavorite","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"luxuryHomes","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"superhost","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"propertyType","in":"query","required":false,"schema":{"type":"string"},"description":"Separate with a comma:\n- Available Options: `House, Flat, Guest house, Hotel`\n- You can set one or more."},{"name":"accessibilityFeatures","in":"query","required":false,"schema":{"type":"string"},"description":"Separate with a comma:\n- Available values can be found at the `/filter/accessibility` endpoint.\n- Example: **110, 111, 291**"},{"name":"hostLanguages","in":"query","required":false,"schema":{"type":"string"},"description":"Separate with a comma:\n- Available values can be found at the `/filter/host_language` endpoint.\n- Example: `zh, de`"}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"Search the Airbnb website via placeId input."}},"/filter/host_language":{"get":{"operationId":"get_filter_host_language","summary":"filter/host_language","tags":["🔝 Filters (stays)"],"parameters":[],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"host languages filter list."}},"/":{"get":{"operationId":"get","summary":"up_check","tags":["Tools"],"parameters":[],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"Check if the api is up or not."}},"/experience/details":{"get":{"operationId":"get_experience_details","summary":"experience details","tags":["📚 Get Details"],"parameters":[{"name":"experienceListingId","in":"query","required":true,"schema":{"type":"string"},"description":"You can find the ID from the  experiences search endpoint `output > searchResults > listing > id`","example":"QWN0aXZpdHlMaXN0aW5nOjMxMDk1ODQ="}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"Get experience details."}},"/search/homes/bycategory":{"get":{"operationId":"get_search_homes_bycategory","summary":"🏠 homes/bycategory","tags":["🔎 Search Airbnb"],"parameters":[{"name":"category_tag","in":"query","required":true,"schema":{"type":"string"},"description":"Search via category. Find the available list on the `/categories` endpoint.\nFor example, Tag:4104 is the `Countryside` category.","example":"Tag:4104"},{"name":"checkIn","in":"query","required":false,"schema":{"type":"string"},"description":"- Pick any check‑in date from today onward (sorry, no time travel).\n- If used, `flexibleStayPeriod` or `months` parameters will be ignored."},{"name":"checkOut","in":"query","required":false,"schema":{"type":"string"},"description":"- Choose a check‑in date from today onward and a check‑out date after that.\n- If used, `flexibleStayPeriod` or `months` parameters will be ignored."},{"name":"flexibleDateFilters","in":"query","required":false,"schema":{"type":"string","enum":["Exact_dates","plusminus_1day","plusminus_2days","plusminus_3days","plusminus_7days","plusminus_14days"]},"description":"Set the flexible days limit."},{"name":"months","in":"query","required":false,"schema":{"type":"string","enum":["None","1","2","3","4","5","6","7","8","9","10","11","12"]},"description":"- Select the number of months for stay\n- It will automatically select the 1st date of next month to the 1st of last month selected."},{"name":"flexibleStayPeriod","in":"query","required":false,"schema":{"type":"string","enum":["Weekend","Week","Month"]}},{"name":"goAnytimeMonths","in":"query","required":false,"schema":{"type":"string"},"description":"- Type the month's name in lowercase, separated with a comma. \n- Lists that are available anytime within the selected months will show.","example":"january,february,march"},{"name":"adults","in":"query","required":false,"schema":{"type":"number"},"description":"Ages `13` or above","example":2},{"name":"children","in":"query","required":false,"schema":{"type":"number"},"description":"Ages `2-12`"},{"name":"infants","in":"query","required":false,"schema":{"type":"number"},"description":"Ages `2` or below"},{"name":"pets","in":"query","required":false,"schema":{"type":"number"}},{"name":"nextPageCursor","in":"query","required":false,"schema":{"type":"string"},"description":"Enter the value found from the last page's response.\nEx. `eyJzZWN0aW9uX29mZnNldCI6MCwiaXRlbXNfb2Zmc2V0IjoxNiwidmVyc2lvbiI6MX0=`"},{"name":"imFlexibleOfDestination","in":"query","required":false,"schema":{"type":"boolean"},"description":"Search for any `random places/destination`"},{"name":"resultsType","in":"query","required":false,"schema":{"type":"string","enum":["search_results","map_results","map_plus_search_results"]},"description":"What do you want to get as output:\n- search_results: the list of places.\n- map_results: results from the map.\n- Both: Combine both types.\n\n----------------- `Search Result Filters` -----------------\n"},{"name":"typeOfPlace","in":"query","required":false,"schema":{"type":"string","enum":["Any_type","Room","Entire_home"]}},{"name":"currency","in":"query","required":false,"schema":{"type":"string"},"example":"USD"},{"name":"priceRangeMin","in":"query","required":false,"schema":{"type":"number"},"example":20},{"name":"priceRangeMax","in":"query","required":false,"schema":{"type":"number"},"example":5000},{"name":"bedrooms","in":"query","required":false,"schema":{"type":"number"},"example":2},{"name":"beds","in":"query","required":false,"schema":{"type":"number"},"example":2},{"name":"bathrooms","in":"query","required":false,"schema":{"type":"number"},"example":2},{"name":"amenities","in":"query","required":false,"schema":{"type":"string"},"description":"Put amenities numbers separated with a comma. \nEx. `4, 8, 33`\n- You can find the list of amenities in the `/filter/amenities` endpoint."},{"name":"bookingOptions","in":"query","required":false,"schema":{"type":"string"},"description":"Separate with a comma:\n- Available Filters: `instant book, self checkin, allow pets, free cancellation`\n- You can set one or more."},{"name":"guestFavorite","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"luxuryHomes","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"superhost","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"propertyType","in":"query","required":false,"schema":{"type":"string"},"description":"Separate with a comma:\n- Available Options: `House, Flat, Guest house, Hotel`\n- You can set one or more."},{"name":"accessibilityFeatures","in":"query","required":false,"schema":{"type":"string"},"description":"Separate with a comma:\n- Available values can be found at the `/filter/accessibility` endpoint.\n- Example: **110, 111, 291**"},{"name":"hostLanguages","in":"query","required":false,"schema":{"type":"string"},"description":"Separate with a comma:\n- Available values can be found at the `/filter/host_language` endpoint.\n- Example: **zh, de**"}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"Search the Airbnb website via category input."}},"/filter/property_types":{"get":{"operationId":"get_filter_property_types","summary":"filter/property_types","tags":["🔝 Filters (stays)"],"parameters":[{"name":"language_code","in":"query","required":false,"schema":{"type":"string"},"description":"All supported language codes can be found on the `/language_codes` endpoint.","example":"en-US"}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"property_types filter list."}},"/experience/availability":{"get":{"operationId":"get_experience_availability","summary":"experience availability","tags":["📚 Get Details"],"parameters":[{"name":"experienceListingId","in":"query","required":false,"schema":{"type":"string"},"example":"QWN0aXZpdHlMaXN0aW5nOjMxMDk1ODQ="},{"name":"startDate","in":"query","required":true,"schema":{"type":"string"},"description":"Format: `YYYY-MM-DD`\n\n- Choose a startDate from today onward and an endDate after that."},{"name":"endDate","in":"query","required":true,"schema":{"type":"string"},"description":"Format: `YYYY-MM-DD`\n"}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"Airbnb experience availability."}},"/search/homes/bycoordinates":{"get":{"operationId":"get_search_homes_bycoordinates","summary":"🏠 homes/bycoordinates","tags":["🔎 Search Airbnb"],"parameters":[{"name":"ne_lat","in":"query","required":true,"schema":{"type":"string"},"description":"`ne_lat` = NorthEast Latitude (top-right corner)\n- Example Value: `43.8555`","example":"44.02943332291518"},{"name":"ne_lng","in":"query","required":true,"schema":{"type":"string"},"description":"`ne_lng` = NorthEast Longitude\n- Example Value: `-79.1169`","example":"-79.31739214807749"},{"name":"sw_lat","in":"query","required":true,"schema":{"type":"string"},"description":"`sw_lat` = SouthWest Latitude (bottom-left corner)\n- Example Value: `43.5810`","example":"43.824096854497604"},{"name":"sw_lng","in":"query","required":true,"schema":{"type":"string"},"description":"`sw_lng` = SouthWest Longitude\n- Example Value: `-79.6393`","example":"-79.49830144643784"},{"name":"checkIn","in":"query","required":false,"schema":{"type":"string"},"description":"- Pick any check‑in date from today onward (sorry, no time travel).\n- If used, `flexibleStayPeriod` or `months` parameters will be ignored."},{"name":"checkOut","in":"query","required":false,"schema":{"type":"string"},"description":"- Choose a check‑in date from today onward and a check‑out date after that.\n- If used, `flexibleStayPeriod` or `months` parameters will be ignored."},{"name":"flexibleDateFilters","in":"query","required":false,"schema":{"type":"string","enum":["Exact_dates","plusminus_1day","plusminus_2days","plusminus_3days","plusminus_7days","plusminus_14days"]},"description":"Set the flexible days limit."},{"name":"months","in":"query","required":false,"schema":{"type":"string","enum":["None","1","2","3","4","5","6","7","8","9","10","11","12"]},"description":"- Select the number of months for stay\n- It will automatically select the 1st date of next month to the 1st of last month selected."},{"name":"flexibleStayPeriod","in":"query","required":false,"schema":{"type":"string","enum":["Weekend","Week","Month"]}},{"name":"goAnytimeMonths","in":"query","required":false,"schema":{"type":"string"},"description":"- Type the month's name in lowercase, separated with a comma. \n- Lists that are available anytime within the selected months will show.","example":"january,february,march"},{"name":"adults","in":"query","required":false,"schema":{"type":"number"},"description":"Ages `13` or above","example":2},{"name":"children","in":"query","required":false,"schema":{"type":"number"},"description":"Ages `2-12`"},{"name":"infants","in":"query","required":false,"schema":{"type":"number"},"description":"Ages `2` or below"},{"name":"pets","in":"query","required":false,"schema":{"type":"number"}},{"name":"nextPageCursor","in":"query","required":false,"schema":{"type":"string"},"description":"Enter the value found from the last page's response.\nEx. `eyJzZWN0aW9uX29mZnNldCI6MCwiaXRlbXNfb2Zmc2V0IjoxNiwidmVyc2lvbiI6MX0=`"},{"name":"imFlexibleOfDestination","in":"query","required":false,"schema":{"type":"boolean"},"description":"Search for any `random places/destination`"},{"name":"resultsType","in":"query","required":false,"schema":{"type":"string","enum":["search_results","map_results","map_plus_search_results"]},"description":"What do you want to get as output:\n- search_results: the list of places.\n- map_results: results from the map.\n- Both: Combine both types.\n\n----------------- `Search Result Filters` -----------------\n"},{"name":"typeOfPlace","in":"query","required":false,"schema":{"type":"string","enum":["Any_type","Room","Entire_home"]}},{"name":"currency","in":"query","required":false,"schema":{"type":"string"},"example":"USD"},{"name":"priceRangeMin","in":"query","required":false,"schema":{"type":"number"},"example":20},{"name":"priceRangeMax","in":"query","required":false,"schema":{"type":"number"},"example":5000},{"name":"bedrooms","in":"query","required":false,"schema":{"type":"number"},"example":2},{"name":"beds","in":"query","required":false,"schema":{"type":"number"},"example":2},{"name":"bathrooms","in":"query","required":false,"schema":{"type":"number"},"example":2},{"name":"amenities","in":"query","required":false,"schema":{"type":"string"},"description":"Put amenities numbers separated with a comma. \nEx. `4, 8, 33`\n- You can find the list of amenities in the `/filter/amenities` endpoint."},{"name":"bookingOptions","in":"query","required":false,"schema":{"type":"string"},"description":"Separate with a comma:\n- Available Filters: `instant book, self checkin, allow pets, free cancellation`\n- You can set one or more."},{"name":"guestFavorite","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"luxuryHomes","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"superhost","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"propertyType","in":"query","required":false,"schema":{"type":"string"},"description":"Separate with a comma:\n- Available Options: `House, Flat, Guest house, Hotel`\n- You can set one or more."},{"name":"accessibilityFeatures","in":"query","required":false,"schema":{"type":"string"},"description":"Separate with a comma:\n- Available values can be found at the `/filter/accessibility` endpoint.\n- Example: **110, 111, 291**"},{"name":"hostLanguages","in":"query","required":false,"schema":{"type":"string"},"description":"Separate with a comma:\n- Available values can be found at the `/filter/host_language` endpoint.\n- Example: `zh, de`"}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"Search the Airbnb website via coordinates input."}},"/experience/reviews":{"get":{"operationId":"get_experience_reviews","summary":"experience reviews","tags":["📚 Get Details"],"parameters":[{"name":"experienceListingId","in":"query","required":true,"schema":{"type":"string"},"description":"You can find the ID from the experiences search endpoint `output > searchResults > listing > id`","example":"U3RheUxpc3Rpbmc6OTQxOTg1NTQyMTc4NDcxMjA0"},{"name":"offset","in":"query","required":false,"schema":{"type":"string"},"description":"Offset is the start index. The default is 0.","example":"0"},{"name":"reviewLimit","in":"query","required":false,"schema":{"type":"string"},"description":"Number of reviews to return","example":"20"},{"name":"sortingPreference","in":"query","required":false,"schema":{"type":"string","enum":["most_relevant","highest_rated","lowest_rated","most_recent"]}}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"Get airbnb experience review details"}},"/search/homes/byurl":{"get":{"operationId":"get_search_homes_byurl","summary":"🏠 homes/byurl","tags":["🔎 Search Airbnb"],"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"},"example":"https://www.airbnb.com/s/Austin--Texas--United-States/homes?refinement_paths%5B%5D=%2Fhomes&place_id=ChIJLwPMoJm1RIYRetVp1EtGm10&location_bb=QfQiGsLDDiBB8JrIwsPgcA%3D%3D&acp_id=64dd18cd-47c8-42ae-b3a3-99e14f79b357&date_picker_type=calendar&checkin=2026-04-01&checkout=2026-04-30&search_type=autocomplete_click"},{"name":"nextPageCursor","in":"query","required":false,"schema":{"type":"string"},"example":"eyJzZWN0aW9uX29mZnNldCI6MCwiaXRlbXNfb2Zmc2V0IjoxOCwidmVyc2lvbiI6MX0="}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"What url you are searching?"}},"/service/details":{"get":{"operationId":"get_service_details","summary":"service details","tags":["📚 Get Details"],"parameters":[{"name":"serviceListingId","in":"query","required":true,"schema":{"type":"string"},"description":"You can find \\\"serviceListingId\\\" from the `/Services/bydestination` endpoint results.","example":"QWN0aXZpdHlMaXN0aW5nOjYwNjcyNzE="}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"Get service details."}},"/search/exp/bydestination":{"get":{"operationId":"get_search_exp_bydestination","summary":"🪂  experience/bydestination","tags":["🔎 Search Airbnb"],"parameters":[{"name":"searchDestinations","in":"query","required":true,"schema":{"type":"string"},"description":"Enter any `destination/location` to search.","example":"toronto, canada"},{"name":"checkIn","in":"query","required":false,"schema":{"type":"string"},"description":"- Pick any check‑in date from today onward (sorry, no time travel).\n"},{"name":"checkOut","in":"query","required":false,"schema":{"type":"string"},"description":"- Choose a check‑in date from today onward and a check‑out date after that.\n"},{"name":"adults","in":"query","required":false,"schema":{"type":"number"},"description":"Ages `13` or above","example":2},{"name":"children","in":"query","required":false,"schema":{"type":"number"},"description":"Ages `2-12`"},{"name":"infants","in":"query","required":false,"schema":{"type":"number"},"description":"Ages `2` or below"},{"name":"nextPageCursor","in":"query","required":false,"schema":{"type":"string"},"description":"Enter the value found from the last page's response.\nEx. `eyJzZWN0aW9uX29mZnNldCI6MCwiaXRlbXNfb2Zmc2V0IjoxNiwidmVyc2lvbiI6MX0=`"},{"name":"experienceType","in":"query","required":false,"schema":{"type":"string"},"description":"Type all the **experienceType** filters separated by commas. Ex. **architecture,art,beauty**\n- All available Filters: `architecture,art,beauty,cooking,cultural,dining,flying,food,galleries,\nlandmarks,museum,outdoor,performance,shopping,tasting,water,wellness,wildlife,workout`","example":"art, beauty"},{"name":"travelerType","in":"query","required":false,"schema":{"type":"string"},"description":"Put values separated with a comma. \nlist of values: `Kids, Big Groups, Solo Travellers,  Date Night`","example":"Big Groups"},{"name":"pricePerGuest_min","in":"query","required":false,"schema":{"type":"number"},"example":20},{"name":"pricePerGuest_max","in":"query","required":false,"schema":{"type":"number"},"example":5000},{"name":"minDuration","in":"query","required":false,"schema":{"type":"number"},"description":"Minimum tour duration in minutes. Available values: `30, 45, 60, 90, 120, 180`","example":30},{"name":"maxDuration","in":"query","required":false,"schema":{"type":"number"},"description":"Maximum tour duration in minutes. Available values: `45, 60, 90, 120, 180`","example":180},{"name":"timeOfDay","in":"query","required":false,"schema":{"type":"string"},"description":"Enter the time of day of the experience:\n- 'morning': `Starts before 12 PM`\n- 'afternoon': `Starts after 12 PM`\n- 'evening': `Starts after 5 PM`","example":"morning, afternoon, evening"},{"name":"hostLanguages","in":"query","required":false,"schema":{"type":"string"},"description":"Select multiple, separated with a comma:\n`english,french,german,italian,japanese,russian,spanish,arabic,chinese,hindi,portuguese,turkish,indonesian,dutch,korean,bengali,thai,punjabi,greek,sign,hebrew,polish,swedish,norwegian,finnish,czech,hungarian,ukrainian`"},{"name":"accessibilityFeatures","in":"query","required":false,"schema":{"type":"string"},"description":"Separate with a comma:\n- Available values: `Step-free access, Sign language options, Designated sighted guide, No extreme sensory stimuli`"}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"Search Airbnb website via destination/location input."}},"/service/reviews":{"get":{"operationId":"get_service_reviews","summary":"service reviews","tags":["📚 Get Details"],"parameters":[{"name":"serviceListingId","in":"query","required":true,"schema":{"type":"string"},"description":"You can find \\\"serviceListingId\\\" from the `/Services/bydestination` endpoint results.","example":"QWN0aXZpdHlMaXN0aW5nOjYwNjcyNzE="},{"name":"offset","in":"query","required":false,"schema":{"type":"string"},"description":"Offset is the start index. The default is 0.","example":"0"},{"name":"reviewLimit","in":"query","required":false,"schema":{"type":"string"},"description":"Number of reviews to return","example":"20"},{"name":"sortingPreference","in":"query","required":false,"schema":{"type":"string","enum":["most_recent","highest_rated","lowest_rated"]}}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"Get airbnb service review details."}},"/search/exp/byplaceid":{"get":{"operationId":"get_search_exp_byplaceid","summary":"🪂 experience/byplaceid","tags":["🔎 Search Airbnb"],"parameters":[{"name":"placeId","in":"query","required":true,"schema":{"type":"string"},"example":"ChIJpTvG15DL1IkRd8S0KlBVNTI"},{"name":"checkIn","in":"query","required":false,"schema":{"type":"string"},"description":"- Pick any check‑in date from today onward (sorry, no time travel).\n"},{"name":"checkOut","in":"query","required":false,"schema":{"type":"string"},"description":"- Choose a check‑in date from today onward and a check‑out date after that.\n"},{"name":"adults","in":"query","required":false,"schema":{"type":"number"},"description":"Ages `13` or above","example":2},{"name":"children","in":"query","required":false,"schema":{"type":"number"},"description":"Ages `2-12`"},{"name":"infants","in":"query","required":false,"schema":{"type":"number"},"description":"Ages `2` or below"},{"name":"nextPageCursor","in":"query","required":false,"schema":{"type":"string"},"description":"Enter the value found from the last page's response.\nEx. `eyJzZWN0aW9uX29mZnNldCI6MCwiaXRlbXNfb2Zmc2V0IjoxNiwidmVyc2lvbiI6MX0=`"},{"name":"experienceType","in":"query","required":false,"schema":{"type":"string"},"description":"Type all the **experienceType** filters separated by commas. Ex. **architecture,art,beauty**\nAll available Filters: `architecture,art,beauty,cooking,cultural,dining,flying,food,galleries,landmarks,museum,outdoor,performance,shopping,tasting,water,wellness,wildlife,workout`","example":"art, beauty"},{"name":"travelerType","in":"query","required":false,"schema":{"type":"string"},"description":"Put values separated with a comma. \nlist of values: `Kids, Big Groups, Solo Travellers,  Date Night`","example":"Big Groups"},{"name":"pricePerGuest_min","in":"query","required":false,"schema":{"type":"number"},"example":20},{"name":"pricePerGuest_max","in":"query","required":false,"schema":{"type":"number"},"example":5000},{"name":"minDuration","in":"query","required":false,"schema":{"type":"number"},"description":"Minimum tour duration in minutes. Available values: `30, 45, 60, 90, 120, 180`","example":30},{"name":"maxDuration","in":"query","required":false,"schema":{"type":"number"},"description":"Maximum tour duration in minutes. Available values: `45, 60, 90, 120, 180`","example":180},{"name":"timeOfDay","in":"query","required":false,"schema":{"type":"string"},"description":"Enter the time of day of the experience:\n- 'morning': `Starts before 12 PM`\n- 'afternoon': `Starts after 12 PM`\n- 'evening': `Starts after 5 PM`","example":"morning, afternoon, evening"},{"name":"hostLanguages","in":"query","required":false,"schema":{"type":"string"},"description":"Select multiple, separated with a comma:\n`english,french,german,italian,japanese,russian,spanish,arabic,chinese,hindi,portuguese,turkish,indonesian,dutch,korean,bengali,thai,punjabi,greek,sign,hebrew,polish,swedish,norwegian,finnish,czech,hungarian,ukrainian`"},{"name":"accessibilityFeatures","in":"query","required":false,"schema":{"type":"string"},"description":"Separate with a comma:\n- Available values: `Step-free access, Sign language options, Designated sighted guide, No extreme sensory stimuli`"}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"Search experiences via byplaceid input."}},"/search/services/bydestination":{"get":{"operationId":"get_search_services_bydestination","summary":"🛎️  services/bydestination","tags":["🔎 Search Airbnb"],"parameters":[{"name":"searchDestinations","in":"query","required":true,"schema":{"type":"string"},"description":"Enter any `destination/location` to search.","example":"toronto, canada"},{"name":"checkIn","in":"query","required":true,"schema":{"type":"string"},"description":"- Pick any check‑in date from today onward (sorry, no time travel).\n"},{"name":"checkOut","in":"query","required":true,"schema":{"type":"string"},"description":"- Choose a check‑in date from today onward and a check‑out date after that.\n"},{"name":"typeOfService","in":"query","required":true,"schema":{"type":"string","enum":["Photography","Prepared_Meals","Training","Makeup","Hair","Spa_Treatment","Catering","Nails","Chefs"]},"description":"Select any type"},{"name":"nextPageCursor","in":"query","required":false,"schema":{"type":"string"},"description":"Enter the value found from the last page's response.\nEx. `eyJzZWN0aW9uX29mZnNldCI6MCwiaXRlbXNfb2Zmc2V0IjoxNiwidmVyc2lvbiI6MX0=`"},{"name":"pricePerGuest_min","in":"query","required":false,"schema":{"type":"number"},"example":20},{"name":"pricePerGuest_max","in":"query","required":false,"schema":{"type":"number"},"example":5000},{"name":"minDuration","in":"query","required":false,"schema":{"type":"number"},"description":"Minimum tour duration in minutes. Available values: `30, 45, 60, 90, 120, 180`","example":30},{"name":"maxDuration","in":"query","required":false,"schema":{"type":"number"},"description":"Maximum tour duration in minutes. Available values: `45, 60, 90, 120, 180`","example":180},{"name":"timeOfDay","in":"query","required":false,"schema":{"type":"string"},"description":"Enter the time of day of the experience. For multiple inputs, separate by comma:\n- 'morning': `Starts before 12 PM`\n- 'afternoon': `Starts after 12 PM`\n- 'evening': `Starts after 5 PM`","example":"morning, afternoon, evening"},{"name":"hostLanguages","in":"query","required":false,"schema":{"type":"string"},"description":"Select multiple, separated with a comma:\n- `english,french,german,italian,japanese,russian,spanish,arabic,chinese,hindi,portuguese,turkish,indonesian,dutch,korean,bengali,thai,punjabi,greek,sign,hebrew,polish,swedish,norwegian,finnish,czech,hungarian,ukrainian`"},{"name":"accessibilityFeatures","in":"query","required":false,"schema":{"type":"string"},"description":"Separate with a comma:\n- Available values: `Step-free access, Sign language options, Designated sighted guide, No extreme sensory stimuli`"}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"Search the Airbnb website for services via destination/location input."}},"/host/details":{"get":{"operationId":"get_host_details","summary":"host details","tags":["📚 Get Details"],"parameters":[{"name":"contextualUserId","in":"query","required":true,"schema":{"type":"string"},"example":"Q29udGV4dHVhbFVzZXI6MTQ2MjcwODYwNzUxNDU2NDAzNQ=="}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"Get host details"}},"/home/extract":{"get":{"operationId":"get_home_extract","summary":"Extended Property Details","tags":["📚 Get Details"],"parameters":[{"name":"stayListingId","in":"query","required":true,"schema":{"type":"string"},"example":"RGVtYW5kU3RheUxpc3Rpbmc6MTI1NTc2NzAzNTg2MDMzMTgxOQ=="},{"name":"checkIn","in":"query","required":true,"schema":{"type":"string"},"example":"2026-05-01  "},{"name":"checkOut","in":"query","required":true,"schema":{"type":"string"},"example":"2026-05-01  "},{"name":"contextualUserId","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response.","headers":{"x-credits-limit":{"description":"Total credits in your current plan period.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Credits remaining in your current plan period.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"}},"description":"get extended property details"}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-realtyapi-key","description":"RealtyAPI key from your dashboard at https://www.realtyapi.io."}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"responses":{"Unauthorized":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"PaymentRequired":{"description":"No credits remaining on the API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}