> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. # Search Airbnb Listings ## OpenAPI ````yaml openapi/youtube.json GET /apis/v1/airbnb/search openapi: 3.1.0 info: description: '' title: Youtube version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-configured-paths: - /apis/v1/airbnb/search - /apis/v1/ebay/search - /apis/v1/youtube/search x-aisa-document: facts_hash: df529dcbbf9a70811b81d0b620ce1a942d3091abf4ed1df564372df6851e1efd generator_version: '2' protocol_version: '1' schema_version: '1' composer_version: '13' response_pending: [] document_hash: sha256:dc4d34f7318a46cbafae311959cbd5746de2c7cdc24269e04393526f8fb517de x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: youtube x-aisa-catalogs: youtube: title: Youtube description: '' x-aisa-document: facts_hash: df529dcbbf9a70811b81d0b620ce1a942d3091abf4ed1df564372df6851e1efd generator_version: '2' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/airbnb/search: get: tags: - default summary: Search Airbnb Listings operationId: any_youtube_apis_v1_airbnb_search parameters: - name: adults in: query required: false description: Number of adult guests schema: type: integer minimum: 0 maximum: 16 - name: airbnb_domain in: query required: false description: Airbnb domain to search (affects language and regional results) schema: type: string default: airbnb.com - name: amenities in: query required: false 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. schema: type: string - name: bathrooms in: query required: false description: Minimum number of bathrooms schema: type: integer minimum: 0 maximum: 8 - name: bedrooms in: query required: false description: Minimum number of bedrooms schema: type: integer minimum: 0 maximum: 8 - name: beds in: query required: false description: Minimum number of beds schema: type: integer minimum: 0 maximum: 8 - name: bounding_box in: query required: false 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. schema: type: string - name: check_in_date in: query required: false description: >- Check-in date in YYYY-MM-DD format. Must be a future date. Cannot be used together with time_period. schema: type: string pattern: ^\d{4}-\d{2}-\d{2}$ - name: check_out_date in: query required: false description: >- Check-out date in YYYY-MM-DD format. Must be after check-in date. Requires check_in_date to be set. schema: type: string pattern: ^\d{4}-\d{2}-\d{2}$ - name: children in: query required: false description: Number of children guests schema: type: integer minimum: 0 maximum: 15 - name: currency in: query required: false description: >- Currency code for pricing. Defaults to USD on airbnb.com; country-specific domains use their own local currency unless this parameter is set. schema: type: string 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 default: USD - name: engine in: query required: true description: Search engine identifier schema: type: string enum: - airbnb example: airbnb - name: include_taxes in: query required: 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. schema: type: string enum: - 'true' - 'false' default: 'false' - name: infants in: query required: false description: Number of infant guests schema: type: integer minimum: 0 maximum: 5 - name: next_page_token in: query required: false description: Token for pagination to retrieve subsequent pages of results schema: type: string - name: pets in: query required: false description: Number of pets schema: type: integer minimum: 0 maximum: 5 - name: price_max in: query required: false description: Maximum price filter per night schema: type: integer minimum: 0 - name: price_min in: query required: false description: Minimum price filter per night schema: type: integer minimum: 0 - name: property_types in: query required: false description: Comma-separated list of property type keys schema: type: string - name: q in: query required: false description: >- Search query for location (e.g., "Barcelona", "Paris"). Either q or bounding_box is required. schema: type: string - name: time_period in: query required: false description: >- Flexible trip length for searches without specific dates. Cannot be used together with check_in_date. schema: type: string enum: - weekend_trip - one_week - one_month default: one_week - name: type_of_place in: query required: false description: Type of accommodation schema: type: string enum: - any - room - entire_home responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/ResponseBfde03595B3D_SearchResponse' default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: ResponseBfde03595B3D_SearchResponse: type: object properties: search_metadata: $ref: '#/components/schemas/ResponseBfde03595B3D_SearchMetadata' search_parameters: $ref: '#/components/schemas/ResponseBfde03595B3D_SearchParameters' search_information: $ref: '#/components/schemas/ResponseBfde03595B3D_SearchInformation' properties: type: array description: List of property results items: $ref: '#/components/schemas/ResponseBfde03595B3D_Property' pagination: $ref: '#/components/schemas/ResponseBfde03595B3D_Pagination' error: type: string description: Error message when no results are found ResponseBfde03595B3D_SearchMetadata: type: object properties: id: type: string description: Unique identifier for the search request status: type: string description: Status of the search request created_at: type: string format: date-time description: Timestamp when the search was created request_time_taken: type: number description: Time taken to make the request in seconds parsing_time_taken: type: number description: Time taken to parse the results in seconds total_time_taken: type: number description: Total time taken for the search in seconds request_url: type: string description: Airbnb URL for this search html_url: type: string description: URL to view HTML results json_url: type: string description: URL to view JSON results ResponseBfde03595B3D_SearchParameters: type: object properties: engine: type: string description: Search engine used airbnb_domain: type: string description: Airbnb domain searched currency: type: string description: Currency code for pricing include_taxes: type: string description: Whether tax-inclusive pricing was requested q: type: string description: Search query location bounding_box: type: string description: Geographic bounding box coordinates check_in_date: type: string description: Check-in date check_out_date: type: string description: Check-out date time_period: type: string description: Flexible trip length price_min: type: integer description: Minimum price filter price_max: type: integer description: Maximum price filter adults: type: integer description: Number of adults children: type: integer description: Number of children infants: type: integer description: Number of infants pets: type: integer description: Number of pets type_of_place: type: string description: Type of accommodation bedrooms: type: integer description: Minimum bedrooms beds: type: integer description: Minimum beds bathrooms: type: integer description: Minimum bathrooms amenities: type: string description: Amenities filter property_types: type: string description: Property types filter next_page_token: type: string description: Pagination token ResponseBfde03595B3D_SearchInformation: type: object properties: query_displayed: type: string description: Location query as displayed by Airbnb results: type: string description: Results summary text 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 guests: type: string description: Guest count display text adults: type: integer description: Number of adult guests children: type: integer description: Number of child guests infants: type: integer description: Number of infant guests pets: type: integer description: Number of pets ResponseBfde03595B3D_Property: type: object properties: position: type: integer description: Position in search results id: type: string description: Unique property listing ID title: type: string description: Property title description: type: string description: Property description link: type: string description: URL to property details page booking_link: type: string description: Direct booking URL with dates and guest parameters time_period: type: string description: Date range display text check_in_date: type: string description: Check-in date for this property check_out_date: type: string description: Check-out date for this property price: $ref: '#/components/schemas/ResponseBfde03595B3D_Price' accommodations: type: array description: Accommodation details (bedrooms, beds, bathrooms) items: type: string distance: type: string description: Distance from search location extracted_distance: type: number description: Numeric distance value gps_coordinates: $ref: '#/components/schemas/ResponseBfde03595B3D_GpsCoordinates' rating: type: number description: Average rating score reviews: type: integer description: Number of reviews has_free_cancellation: type: boolean description: >- Present and true when the card shows a "Free cancellation" highlight. Omitted otherwise. badges: type: array description: Property badges (e.g., Guest favorite, Superhost) items: type: string images: type: array description: Property image URLs items: type: string ResponseBfde03595B3D_Pagination: type: object properties: next_page_token: type: string description: Token to retrieve the next page of results ResponseBfde03595B3D_Price: type: object properties: total_price: type: string description: Total price display text extracted_total_price: type: number description: Numeric total price value qualifier: type: string description: Price qualifier text (e.g., per night, per week) extracted_qualifier: type: integer description: Numeric qualifier value original_price: type: string description: Original price before discount extracted_original_price: type: number description: Numeric original price value discount: type: string description: Discount amount display text extracted_discount: type: number description: Numeric discount value price_per_qualifier: type: string description: Price breakdown per qualifier extracted_price_per_qualifier: type: number description: Numeric price per qualifier value breakdown: type: array 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. items: $ref: '#/components/schemas/ResponseBfde03595B3D_PriceBreakdownItem' 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_total_with_taxes: type: number description: Numeric all-in total extracted from `total_with_taxes` ResponseBfde03595B3D_GpsCoordinates: type: object properties: latitude: type: number description: Latitude coordinate longitude: type: number description: Longitude coordinate ResponseBfde03595B3D_PriceBreakdownItem: type: object properties: description: type: string description: Breakdown item description price: type: string description: Breakdown item price display text extracted_price: type: number description: >- Numeric breakdown item price. Signed, so discount lines are negative and the lines sum to the total. securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.