Skip to content

Instantly share code, notes, and snippets.

@akhilbhadrangirija
Last active July 3, 2022 16:19
Show Gist options
  • Save akhilbhadrangirija/558a0d82e09053c5078db278189fb2dc to your computer and use it in GitHub Desktop.
Save akhilbhadrangirija/558a0d82e09053c5078db278189fb2dc to your computer and use it in GitHub Desktop.
Booking.com api reference guide

Booking.com api Guide

Sample URLs

Syntax:

https://[domain]/[version]</[xml or json]>/[endpoint]?[parameters]

Endpoint Types

The API consists of three general endpoint classes:

Availability: Real-time pricing and availability, both of which are constantly changing. This should not be cached, you must request the data each time it is needed.

Static Data: Property descriptions, facility information, city names, hotel types, and other items that change much less frequently than availability.

Booking Endpoints: Endpoints related to processing bookings via the API.

Booking via api

Partners who need to use the API for bookings must be PCI DSS-compliant and have the appropriate contracts in place.

Destination Endpoints

Destination information can be obtained from the following endpoints:

  • /countries
  • /cities
  • /districts
  • /regions

Reference Endpoints

Reference endpoints such as /hotelFacilityTypes, /hotelTypes, /chainTypes, and /paymentTypes allow you to obtain supporting data for use in conjunction with other endpoints.

Availability Endpoints

The /hotelAvailability endpoint should generally be used to return the least expensive rooms available that match the provided guest configuration and search parameters.

After a property is selected, /blockAvailability can be used to return all available rooms for a specific property.

Datas provided by the api

Charge types, Locality fee types, Property fee types, Facility fee types, customer_type (reviews), Room Facilities, Property Type, Property Facilities, Languages (language codes), IATA Codes (airports), Key collection info: how to collect (/hotels endpoint)

Possible values are listed on https://developers.booking.com/api/commercial/index.html?version=2.9&page_url=possible-values

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment