# Connect API Partner Connect API Service Version: 1.1 ## Servers Production URL ``` https://metasearch-connect-api.booking.com ``` ## Security ### BearerAuth Type: http Scheme: bearer Bearer Format: string ## Download OpenAPI description [Connect API](https://developers.booking.com/_bundle/metasearch/connect-api/open-api.yaml) ## reports ### List conversions - [POST /reports/conversions](https://developers.booking.com/metasearch/connect-api/open-api/reports/getconversions.md): This endpoint returns conversion data for bookings within a specified date range. Note: Conversions data is only provided for selected accounts based on contractual agreements. The booking_date_range parameter is required and must include both from and to dates in ISO-8601 format (YYYY-MM-DD). Results are paginated with a default page size of 100 and a maximum of 1000 records per page. Use the page_token from the response to retrieve subsequent pages. Example request: json { "booking_date_range": { "from": "2025-01-01", "to": "2025-01-31" }, "page_size": 100 } ## demand-api-v3-compatible ### List available accommodation - [POST /demand-api-v3-compatible/accommodations/search](https://developers.booking.com/metasearch/connect-api/open-api/demand-api-v3-compatible/search.md): This endpoint returns the cheapest available product for each hotel matching the search criteria. ### List accommodation details - [POST /demand-api-v3-compatible/accommodations/details](https://developers.booking.com/metasearch/connect-api/open-api/demand-api-v3-compatible/postdetails.md): This endpoint returns detailed information on all accommodation properties matching a given search criteria. By default, only basic information is returned. To receive extended information use the extras parameter. Is is mandatory to pass one of the input parameters: accommodations, airport, city, country or region. ### List accommodation constants - [POST /demand-api-v3-compatible/accommodations/constants](https://developers.booking.com/metasearch/connect-api/open-api/demand-api-v3-compatible/getaccommodationconstants.md): This endpoint enumerates the internal codes and names, in the selected languages, for relevant accommodation specific types. These accommodation specific types include the list of facilities that may be available at a property like "Elevator" or "Swimmingpool Outdoor". For example, the following parameters will return the full list in English (US) and French: {"languages":"en-us","fr"}. To get the full list call the endpoint passing an empty body. The codes returned are what is used as input and output for other endpoints in the accommodations namespace. ## demand-api-v2-compatible ### List accommodation reviews - [GET /demand-api-v2-compatible/reviews](https://developers.booking.com/metasearch/connect-api/open-api/demand-api-v2-compatible/gethotelsreviews.md): Returns reviews for specified hotel_ids and filters. Available filters are country, language of the review, lower and upper bound of the review score, and timestamp of the last change to the review. The 'last_change' output field will only be displayed if the last_change=... input parameter is set. ### List accommodation review scores - [GET /demand-api-v2-compatible/reviewScores](https://developers.booking.com/metasearch/connect-api/open-api/demand-api-v2-compatible/gethotelsreviewscores.md): Gives information about review scores for specified hotel_ids and filter. The information consists of score breakdown per reviewer_type and review questions, and overall score distribution per score value (1 - 10). The available filter is input parameter reviewer_type=... . It allows generating review score information for just one reviewer type. Language in which the response is rendered can be controlled with the input parameter language=... (default: 'en'). Setting the language will reflect on the output fields question and review_score_word. One additional output field can be requested with input parameter extras=review_score_word. ### Get details of accommodations - [GET /demand-api-v2-compatible/hotels](https://developers.booking.com/metasearch/connect-api/open-api/demand-api-v2-compatible/gethotels.md): This call returns the hotel and room data. By default, only hotel_id is returned in the output. One of the argument: hotel_ids, city_ids, country_ids, region_ids, district_ids, chain_ids is mandatory. Additional data needs to be requested via extras parameter. The data is returned in English by default. ### List hotel types - [GET /demand-api-v2-compatible/hotelTypes](https://developers.booking.com/metasearch/connect-api/open-api/demand-api-v2-compatible/gethoteltypes.md): This endpoint returns hotel types names and their translations. (EN is default) ### List hotel theme types - [GET /demand-api-v2-compatible/hotelThemeTypes](https://developers.booking.com/metasearch/connect-api/open-api/demand-api-v2-compatible/gethotelthemetypes.md): This endpoint returns a list of hotel theme types (in English). ### List facility room types - [GET /demand-api-v2-compatible/hotelFacilityTypes](https://developers.booking.com/metasearch/connect-api/open-api/demand-api-v2-compatible/getroomfacilitytypes.md): This endpoint returns room facility types names and their translations (EN is default). ### List available hotel rooms - [GET /demand-api-v2-compatible/hotelAvailability](https://developers.booking.com/metasearch/connect-api/open-api/demand-api-v2-compatible/gethotelavailability.md): This endpoint returns the cheapest available room for each hotel matching your check-in and check-out dates. You can search for hotels in a city, or for a specific list of (upto 300) hotels by hotel_ids. Here you will find whether the price included breakfast or other meals, as well as whether it is possible to cancel for free. It is possible to have a breakdown of the price returned by this endpoint and to filter by property types and/or hotel facilities. ### List all bookable rooms at a property - [GET /demand-api-v2-compatible/blockAvailability](https://developers.booking.com/metasearch/connect-api/open-api/demand-api-v2-compatible/getblockavailability.md): This endpoint is where you find a list of all bookable or available rooms at a property. A room can have multiple blocks, as a block is a combination of the meal, cancellation policy, occupancy and other things. You can find detailed information about one hotel per search (detail_level) which will return most of the information needed to replicate the booking.com property page. If you want to search multiple hotels, you can, but you get less detail. For searching multiple hotels, it is recommended to use hotelAvailability.