{"uid":"cap_Z2Ykk4nUM-VjUwC3jw0Cz","slug":"aisa-mpp-data-apis-airbnb-listing-search-6518e170","name":"Airbnb Listing Search","description":"<!-- aisa-pricing:start -->\nPublished reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","url":"https://api.aisa.one/apis/v1/airbnb/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["engine"],"properties":{"q":{"type":"string","description":"Search query for location (e.g., \"Barcelona\", \"Paris\"). Either q or bounding_box is required."},"beds":{"type":"integer","maximum":8,"minimum":0,"description":"Minimum number of beds"},"pets":{"type":"integer","maximum":5,"minimum":0,"description":"Number of pets"},"adults":{"type":"integer","maximum":16,"minimum":0,"description":"Number of adult guests"},"engine":{"enum":["airbnb"],"type":"string","description":"Search engine identifier"},"infants":{"type":"integer","maximum":5,"minimum":0,"description":"Number of infant guests"},"bedrooms":{"type":"integer","maximum":8,"minimum":0,"description":"Minimum number of bedrooms"},"children":{"type":"integer","maximum":15,"minimum":0,"description":"Number of children guests"},"currency":{"enum":["USD","AUD","BRL","BGN","BAM","CAD","CLP","CNY","COP","CRC","CZK","DKK","EGP","AED","EUR","GHS","GTQ","HNL","HKD","HUF","INR","IDR","ILS","JPY","KZT","KES","MYR","MXN","MAD","TWD","NZD","NOK","PEN","PHP","PLN","GBP","QAR","RON","RUB","SAR","SGD","ZAR","KRW","SEK","CHF","THB","TRY","UGX","UAH","UYU","VND"],"type":"string","default":"USD","description":"Currency code for pricing. Defaults to USD on airbnb.com; country-specific domains use their own local currency unless this parameter is set."},"amenities":{"type":"string","description":"Comma-separated list of amenity keys (e.g., \"wifi,pool,kitchen\"). Supports hundreds of amenities including wifi, pool, kitchen, air_conditioning, heating, washer, dryer, parking, pets_allowed, wheelchair_accessible, gym, hot_tub, ev_charger, and many more. Also supports special filters: guest_favorite, instant_book, luxe."},"bathrooms":{"type":"integer","maximum":8,"minimum":0,"description":"Minimum number of bathrooms"},"price_max":{"type":"integer","minimum":0,"description":"Maximum price filter per night"},"price_min":{"type":"integer","minimum":0,"description":"Minimum price filter per night"},"time_period":{"enum":["weekend_trip","one_week","one_month"],"type":"string","default":"one_week","description":"Flexible trip length for searches without specific dates. Cannot be used together with check_in_date."},"bounding_box":{"type":"string","description":"Geographic bounding box coordinates for map-based search. Format: [[ne_lat,ne_lng],[sw_lat,sw_lng]]. Either q or bounding_box is required."},"airbnb_domain":{"type":"string","default":"airbnb.com","description":"Airbnb domain to search (affects language and regional results)"},"check_in_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Check-in date in YYYY-MM-DD format. Must be a future date. Cannot be used together with time_period."},"include_taxes":{"enum":["true","false"],"type":"string","default":"false","description":"When `true`, returns tax-inclusive search-card pricing. Each property's `price` then carries `total_with_taxes` and itemizes its tax lines in `breakdown`, without any extra per-property call. Applies to airbnb.com, where taxes normally appear only at checkout; other country-specific domains are unaffected (many, like EU domains, already show tax-inclusive totals by default). The nightly prices are the same as the default response; taxes are itemized on top."},"type_of_place":{"enum":["any","room","entire_home"],"type":"string","description":"Type of accommodation"},"check_out_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Check-out date in YYYY-MM-DD format. Must be after check-in date. Requires check_in_date to be set."},"property_types":{"type":"string","description":"Comma-separated list of property type keys"},"next_page_token":{"type":"string","description":"Token for pagination to retrieve subsequent pages of results"}}},"responseSchema":{"type":"object","properties":{"error":{"type":"string","description":"Error message when no results are found"},"pagination":{"type":"object","properties":{"next_page_token":{"type":"string","description":"Token to retrieve the next page of results"}}},"properties":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Unique property listing ID"},"link":{"type":"string","description":"URL to property details page"},"price":{"type":"object","properties":{"discount":{"type":"string","description":"Discount amount display text"},"breakdown":{"type":"array","items":{"$ref":"#/components/schemas/youtube_5e7b3be832ec__ResponseBfde03595B3D_PriceBreakdownItem"},"description":"Every itemized price line: the stay subtotal, any discount lines, any tax or fee lines, and the total. The lines sum to the total, so a listing's taxes are read from here rather than from a single field, since a card can carry several tax lines. Line descriptions are localized to the airbnb_domain."},"qualifier":{"type":"string","description":"Price qualifier text (e.g., per night, per week)"},"total_price":{"type":"string","description":"Total price display text"},"original_price":{"type":"string","description":"Original price before discount"},"total_with_taxes":{"type":"string","description":"Formatted all-in total including taxes and fees. Exact, where `total_price` is Airbnb's rounded display figure. Present only when Airbnb provides an all-in figure, so its absence means no tax-inclusive price was available."},"extracted_discount":{"type":"number","description":"Numeric discount value"},"extracted_qualifier":{"type":"integer","description":"Numeric qualifier value"},"price_per_qualifier":{"type":"string","description":"Price breakdown per qualifier"},"extracted_total_price":{"type":"number","description":"Numeric total price value"},"extracted_original_price":{"type":"number","description":"Numeric original price value"},"extracted_total_with_taxes":{"type":"number","description":"Numeric all-in total extracted from `total_with_taxes`"},"extracted_price_per_qualifier":{"type":"number","description":"Numeric price per qualifier value"}}},"title":{"type":"string","description":"Property title"},"badges":{"type":"array","items":{"type":"string"},"description":"Property badges (e.g., Guest favorite, Superhost)"},"images":{"type":"array","items":{"type":"string"},"description":"Property image URLs"},"rating":{"type":"number","description":"Average rating score"},"reviews":{"type":"integer","description":"Number of reviews"},"distance":{"type":"string","description":"Distance from search location"},"position":{"type":"integer","description":"Position in search results"},"description":{"type":"string","description":"Property description"},"time_period":{"type":"string","description":"Date range display text"},"booking_link":{"type":"string","description":"Direct booking URL with dates and guest parameters"},"check_in_date":{"type":"string","description":"Check-in date for this property"},"accommodations":{"type":"array","items":{"type":"string"},"description":"Accommodation details (bedrooms, beds, bathrooms)"},"check_out_date":{"type":"string","description":"Check-out date for this property"},"gps_coordinates":{"type":"object","properties":{"latitude":{"type":"number","description":"Latitude coordinate"},"longitude":{"type":"number","description":"Longitude coordinate"}}},"extracted_distance":{"type":"number","description":"Numeric distance value"},"has_free_cancellation":{"type":"boolean","description":"Present and true when the card shows a \"Free cancellation\" highlight. Omitted otherwise."}}},"description":"List of property results"},"search_metadata":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the search request"},"status":{"type":"string","description":"Status of the search request"},"html_url":{"type":"string","description":"URL to view HTML results"},"json_url":{"type":"string","description":"URL to view JSON results"},"created_at":{"type":"string","format":"date-time","description":"Timestamp when the search was created"},"request_url":{"type":"string","description":"Airbnb URL for this search"},"total_time_taken":{"type":"number","description":"Total time taken for the search in seconds"},"parsing_time_taken":{"type":"number","description":"Time taken to parse the results in seconds"},"request_time_taken":{"type":"number","description":"Time taken to make the request in seconds"}}},"search_parameters":{"type":"object","properties":{"q":{"type":"string","description":"Search query location"},"beds":{"type":"integer","description":"Minimum beds"},"pets":{"type":"integer","description":"Number of pets"},"adults":{"type":"integer","description":"Number of adults"},"engine":{"type":"string","description":"Search engine used"},"infants":{"type":"integer","description":"Number of infants"},"bedrooms":{"type":"integer","description":"Minimum bedrooms"},"children":{"type":"integer","description":"Number of children"},"currency":{"type":"string","description":"Currency code for pricing"},"amenities":{"type":"string","description":"Amenities filter"},"bathrooms":{"type":"integer","description":"Minimum bathrooms"},"price_max":{"type":"integer","description":"Maximum price filter"},"price_min":{"type":"integer","description":"Minimum price filter"},"time_period":{"type":"string","description":"Flexible trip length"},"bounding_box":{"type":"string","description":"Geographic bounding box coordinates"},"airbnb_domain":{"type":"string","description":"Airbnb domain searched"},"check_in_date":{"type":"string","description":"Check-in date"},"include_taxes":{"type":"string","description":"Whether tax-inclusive pricing was requested"},"type_of_place":{"type":"string","description":"Type of accommodation"},"check_out_date":{"type":"string","description":"Check-out date"},"property_types":{"type":"string","description":"Property types filter"},"next_page_token":{"type":"string","description":"Pagination token"}}},"search_information":{"type":"object","properties":{"pets":{"type":"integer","description":"Number of pets"},"adults":{"type":"integer","description":"Number of adult guests"},"guests":{"type":"string","description":"Guest count display text"},"infants":{"type":"integer","description":"Number of infant guests"},"results":{"type":"string","description":"Results summary text"},"children":{"type":"integer","description":"Number of child guests"},"time_period":{"type":"string","description":"Time period display text"},"check_in_date":{"type":"string","description":"Check-in date from search"},"check_out_date":{"type":"string","description":"Check-out date from search"},"query_displayed":{"type":"string","description":"Location query as displayed by Airbnb"}}}}},"example":null,"exampleRequest":null,"tags":["web-search","financial-data","prediction-markets","weather","travel","data","search"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_74Mkx2Qpir2yFosPdZ6xw","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"AIsa MPP Data APIs","brandSlug":"aisa-mpp-data-apis-mpp","brandBaseUrl":"https://aisa.one","brandDocsUrl":null,"whatItDoes":"Searches Airbnb listings by location, dates, guest count, amenities, and price filters, returning matching properties with pricing details.","exampleAgentPrompt":"Search Airbnb for listings in Barcelona for 2 adults and 1 child checking in on June 15 and checking out June 22, with at least 2 bedrooms, a pool, and wifi, priced under $250 per night in USD.","exampleUseCases":[{"title":"Family vacation rental search","prompt":"Find me Airbnb rentals in Orlando for 2 adults and 3 children from July 4th to July 11th — I need at least 3 bedrooms, a pool, and it has to be pet-friendly. Show prices in USD."},{"title":"Budget city trip accommodation","prompt":"I'm traveling solo to Amsterdam from September 10 to September 14, can you search Airbnb for guest-favorite listings under $100 per night with wifi and kitchen included?"},{"title":"Remote work-friendly long stay","prompt":"Search Airbnb in Lisbon for 2 adults for the whole month of October, minimum 1 bedroom, must have wifi and a dedicated workspace, and filter for instant book listings priced between $50 and $120 per night."}],"resultDescription":"Returns an array of Airbnb property listings matching the filters, each with a unique listing ID, a direct URL to the property page, pricing details (per-night price, original price, discount, total price, and all-in total with taxes broken down by line item), and a pagination token for retrieving additional results. If no listings match, an error message is returned instead.","failureModes":["No results found for the given location or filters — error message returned","Invalid or past check-in/check-out dates cause a validation error","Conflicting parameters (e.g. both time_period and check_in_date) cause a request error","Unsupported currency code returns a validation error","Missing required 'engine' parameter causes a 400-level error","Bounding box format incorrect or both q and bounding_box omitted causes error"],"whenToPreferThis":"Use this endpoint when you need to programmatically search Airbnb short-term rental listings with flexible filtering by location, dates, guests, amenities, and price. It is the right choice when a user wants to discover vacation rentals or short-term accommodation on Airbnb specifically, as opposed to hotels (use a hotel search API) or long-term apartment rentals (use a real estate API). Prefer this over generic web search when structured, filterable Airbnb listing data with pricing is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:55:30.350Z","isFirstParty":false,"canonicalSlug":"aisa-mpp-data-apis-airbnb-listing-search-6518e170"}