{"openapi":"3.2.0","info":{"title":"Airbnb API","description":"Unofficial REST API for Airbnb data retrieval. This API provides endpoints for searching listings, retrieving listing details, reviews, calendar availability, host profiles, and more. **Multi-Region Support**: Use the `region` query parameter to specify the country (e.g. US, DE, FR). Each region uses the appropriate Airbnb domain and currency.","version":"1.0.0"},"servers":[{"url":"https://airbnb-api.jojapi.net"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/autocomplete":{"get":{"operationId":"get_autocomplete","summary":"Location Autocomplete","description":"Search for locations by name. Returns matching places with their IDs.","parameters":[{"name":"query","in":"query","description":"Search query for location name","required":false,"schema":{"type":"string","title":"query","example":"Istanbul"}},{"name":"limit","in":"query","description":"Maximum number of results to return","required":false,"schema":{"type":"string","title":"limit"}}]}},"/hosts/{id}":{"get":{"operationId":"get_hosts_id","summary":"Get Host Profile","description":"Retrieve profile information for a specific host.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/hosts/{id}/listings":{"get":{"operationId":"get_hosts_id_listings","summary":"Get Host Listings","description":"Retrieve all listings owned by a specific host.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Maximum number of listings to return","required":false,"schema":{"type":"string","title":"limit"}},{"name":"offset","in":"query","description":"Pagination offset","required":false,"schema":{"type":"string","title":"offset"}}]}},"/listings/{id}":{"get":{"operationId":"get_listings_id","summary":"Get Listing Details","description":"Retrieve detailed information about a specific listing.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"checkin","in":"query","description":"Check-in date for price calculation","required":false,"schema":{"type":"string","title":"checkin"}},{"name":"checkout","in":"query","description":"Check-out date for price calculation","required":false,"schema":{"type":"string","title":"checkout"}},{"name":"adults","in":"query","description":"Number of adults for price calculation","required":false,"schema":{"type":"string","title":"adults"}},{"name":"children","in":"query","description":"Number of children for price calculation","required":false,"schema":{"type":"string","title":"children"}}]}},"/listings/{id}/calendar":{"get":{"operationId":"get_listings_id_calendar","summary":"Get Listing Calendar","description":"Retrieve availability calendar for a specific listing.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"months","in":"query","description":"Number of months to fetch","required":false,"schema":{"type":"string","title":"months"}},{"name":"year","in":"query","description":"Starting year (defaults to current year)","required":false,"schema":{"type":"string","title":"year"}},{"name":"month","in":"query","description":"Starting month (1-12, defaults to current month)","required":false,"schema":{"type":"string","title":"month"}}]}},"/listings/{id}/reviews":{"get":{"operationId":"get_listings_id_reviews","summary":"Get Listing Reviews","description":"Retrieve reviews for a specific listing with pagination support.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Number of reviews to return","required":false,"schema":{"type":"string","title":"limit"}},{"name":"offset","in":"query","description":"Pagination offset","required":false,"schema":{"type":"string","title":"offset"}},{"name":"sort","in":"query","description":"Sort order","required":false,"schema":{"type":"string","title":"sort"}},{"name":"all","in":"query","description":"Set to 'true' to fetch all reviews (paginated automatically)","required":false,"schema":{"type":"string","title":"all"}},{"name":"max_pages","in":"query","description":"Maximum pages to fetch when all=true","required":false,"schema":{"type":"string","title":"max_pages"}}]}},"/search":{"get":{"operationId":"get_search","summary":"Search Listings","description":"Search for Airbnb listings by location name with various filters.","parameters":[{"name":"query","in":"query","description":"Location name to search","required":false,"schema":{"type":"string","title":"query","example":"Istanbul, Turkey"}},{"name":"checkin","in":"query","description":"Check-in date (YYYY-MM-DD)","required":false,"schema":{"type":"string","title":"checkin","example":"2025-01-15"}},{"name":"checkout","in":"query","description":"Check-out date (YYYY-MM-DD)","required":false,"schema":{"type":"string","title":"checkout","example":"2025-01-20"}},{"name":"adults","in":"query","description":"Number of adults","required":false,"schema":{"type":"string","title":"adults"}},{"name":"children","in":"query","description":"Number of children","required":false,"schema":{"type":"string","title":"children"}},{"name":"infants","in":"query","description":"Number of infants","required":false,"schema":{"type":"string","title":"infants"}},{"name":"pets","in":"query","description":"Number of pets","required":false,"schema":{"type":"string","title":"pets"}},{"name":"min_price","in":"query","description":"Minimum price per night","required":false,"schema":{"type":"string","title":"min_price"}},{"name":"max_price","in":"query","description":"Maximum price per night","required":false,"schema":{"type":"string","title":"max_price"}},{"name":"min_bedrooms","in":"query","description":"Minimum number of bedrooms","required":false,"schema":{"type":"string","title":"min_bedrooms"}},{"name":"min_beds","in":"query","description":"Minimum number of beds","required":false,"schema":{"type":"string","title":"min_beds"}},{"name":"min_bathrooms","in":"query","description":"Minimum number of bathrooms","required":false,"schema":{"type":"string","title":"min_bathrooms"}},{"name":"superhost","in":"query","description":"Filter by superhost status","required":false,"schema":{"type":"string","title":"superhost"}},{"name":"instant_book","in":"query","description":"Filter by instant book availability","required":false,"schema":{"type":"string","title":"instant_book"}},{"name":"self_checkin","in":"query","description":"Filter by self check-in availability","required":false,"schema":{"type":"string","title":"self_checkin"}},{"name":"pets_allowed","in":"query","description":"Filter by pets allowed","required":false,"schema":{"type":"string","title":"pets_allowed"}},{"name":"amenities","in":"query","description":"Comma-separated list of amenity IDs","required":false,"schema":{"type":"string","title":"amenities","example":"4,8,30"}},{"name":"property_types","in":"query","description":"Comma-separated list of property type IDs","required":false,"schema":{"type":"string","title":"property_types"}},{"name":"sort","in":"query","description":"Sort order for results","required":false,"schema":{"type":"string","title":"sort"}},{"name":"limit","in":"query","description":"Maximum number of results","required":false,"schema":{"type":"string","title":"limit"}},{"name":"offset","in":"query","description":"Pagination offset","required":false,"schema":{"type":"string","title":"offset"}}]}},"/search/coordinates":{"get":{"operationId":"get_search_coordinates","summary":"Search by Coordinates","description":"Search for Airbnb listings within a bounding box defined by coordinates."}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-JoJAPI-Key","description":"Your JoJ API key."}}}}