demand-api-v2-compatible

List accommodation review scores

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.

SecurityHTTP: BearerAuth

Request

query Parameters

required

object (ReviewScoresInputDto)

header Parameters

string

Value: "application/json, application/xml"

get

/demand-api-v2-compatible/reviewScores

Responses

200

Response Schema: application/json

	object (Meta)
	Array of objects (ReviewScoresOutputDto)

Response samples
200
application/json
{
"meta": {
"ruid": "string"
},
"result": [
{
"hotel_id": 0,
"hotel_url": "https://www.booking.com/hotel/nl/amsterdam-canal-hotel.html?tab=4&aid=338734&label=hotel-472820_reviewscore",
"score_breakdown": [
{
"average_score": 8.5,
"count": 0,
"question": [
{
"count": 0,
"question": "string",
"question_literal": "string",
"score": 8.5
}
],
"reviewer_type": "string"
}
],
"score_distribution": [
{
"count": 435,
"percent": 17.76,
"score": 10
}
]
}
]
}

Get details of accommodations

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.

SecurityHTTP: BearerAuth

Request

query Parameters

required

object (HotelsInputDto)

header Parameters

string

Value: "application/json, application/xml"

get

/demand-api-v2-compatible/hotels

Responses

200

Response Schema: application/json

	object (Meta)
	Array of objects (HotelsOutputDto)

Response samples
200
application/json
{
"meta": {
"ruid": "string"
},
"result": [
{
"hotel_data": {
"address": "string",
"city_id": 0,
"country": "string",
"location": {
"latitude": 52.375859,
"longitude": 4.886006
},
"zip": "string",
"currency": "string",
"checkin_checkout_times": {
"checkin_from": {
"hour": 0,
"minute": 0,
"second": 0,
"nano": 0
},
"checkin_to": {
"hour": 0,
"minute": 0,
"second": 0,
"nano": 0
},
"checkout_from": {
"hour": 0,
"minute": 0,
"second": 0,
"nano": 0
},
"checkout_to": {
"hour": 0,
"minute": 0,
"second": 0,
"nano": 0
}
},
"hotel_photos": [
{
"main_photo": true,
"url_original": "string"
}
],
"hotel_description": "string",
"url": "string",
"deep_link_url": "booking://hotel/10004?affiliate_id=956509",
"region_ids": [
0
],
"number_of_reviews": 0,
"review_score": 7.1,
"spoken_languages": [
"string"
]
},
"hotel_id": 0,
"room_data": [
{
"room_id": 0,
"room_info": {
"bathroom_count": 0.1,
"bedroom_count": 0.1,
"bedrooms": [
{
"bed_configurations": [ ]
}
],
"occupancy": {
"allow_cribs_and_extra_beds": true,
"max_adults": 0,
"max_children": 0,
"max_cribs": 0,
"max_extra_beds": 0,
"max_occupancy": 0
},
"room_size": {
"metre_square": 0.1
},
"room_type_id": 0
}
}
]
}
]
}

List hotel types

This endpoint returns hotel types names and their translations. (EN is default)

SecurityHTTP: BearerAuth

Request

query Parameters

required

object (HotelTypeInputDTO)

header Parameters

string

Value: "application/json"

get

/demand-api-v2-compatible/hotelTypes

Responses

200

Response Schema: application/json

	object (Meta)
	Array of objects (HotelTypesOutputDto)

Response samples
200
application/json
{
"meta": {
"ruid": "string"
},
"result": [
{
"translations": [
{
"language": "string",
"name": "string"
}
],
"name": "string",
"hotel_type_id": 0
}
]
}

List hotel theme types

This endpoint returns a list of hotel theme types (in English).

SecurityHTTP: BearerAuth

Request

query Parameters

required

object (HotelThemeTypeInputDTO)

header Parameters

string

Value: "application/json"

get

/demand-api-v2-compatible/hotelThemeTypes

Responses

200

Response Schema: application/json

	object (Meta)
	Array of objects (HotelThemeTypesOutputDto)

Response samples
200
application/json
{
"meta": {
"ruid": "string"
},
"result": [
{
"theme_id": 0,
"name": "Beach/Seaside"
}
]
}

List facility room types

This endpoint returns room facility types names and their translations (EN is default).

SecurityHTTP: BearerAuth

Request

query Parameters

required

object (HotelFacilityInputDto)

header Parameters

string

Value: "application/json"

get

/demand-api-v2-compatible/hotelFacilityTypes

Responses

200

Response Schema: application/json

	object (Meta)
	Array of objects (HotelFacilityTypeOutputDto)

Response samples
200
application/json
{
"meta": {
"ruid": "string"
},
"result": [
{
"hotel_facility_type_id": 0,
"facility_type_id": 0,
"name": "Parking",
"translations": [
{
"language": "string",
"name": "string"
}
]
}
]
}

List available hotel rooms

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.

SecurityHTTP: BearerAuth

Request

query Parameters

required

object (HotelAvailabilityInputDto)

header Parameters

string

Value: "application/json"

get

/demand-api-v2-compatible/hotelAvailability

Responses

200

Response Schema: application/json

	object (Meta)
	Array of objects (HotelAvailabilityOutputDto)

Response samples
200
application/json
{
"meta": {
"ruid": "string"
},
"result": [
{
"hotel_id": 0,
"hotel_currency_code": "string",
"price": 100,
"net_price": 90
}
]
}

List all bookable rooms at a property

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.

SecurityHTTP: BearerAuth

Request

query Parameters

required

object (BlockAvailabilityInputDto)

header Parameters

string

Value: "application/json, application/xml"

get

/demand-api-v2-compatible/blockAvailability

Responses

200

Response Schema:
application/json

	object (Meta)
	Array of objects (BlockAvailabilityOutputDto)

Response samples
200
application/json
{
"meta": {
"ruid": "string"
},
"result": [
{
"block": [
{
"block_id": "string",
"breakfast_included": true
}
],
"can_pay_now": true,
"checkin": "string",
"checkout": "string",
"direct_payment": true,
"hotel_id": 0,
"hotel_url": "https://www.booking.com/hotel/nl/toren.html",
"flash_deal": true
}
]
}