Question 1

Are the rates live or cached?

Accepted Answer

Live. Every call reads Booking.com at request time; nothing is served from a cache.

Question 2

What happens when a hotel is sold out or the name does not match?

Accepted Answer

You still get a 200 in the same shape as a hit, with available false and null price fields, so a parser never branches on an error format. matched_name shows which property the name resolved to.

Question 3

What does proxy_country do?

Accepted Answer

It sends the request through a residential connection in that country (two-letter code), so you see the rate a guest browsing from that market is shown. Gaps between markets depend on the property; sample each country more than once before drawing a conclusion.

Booking.com Live Hotel Rates

Frequently Asked Questions