SEsearchapi

Booking.com Property

get/search

Request

  • Base URL
    https://www.searchapi.io/api/v1
  • Auth
    • API key in header Authorization
    • or API key in query parameter api_key

Query parameters

engine'booking_property' required

Search engine to use

urlstring required

The Booking.com property page URL, obtained from the link field of a Booking.com API result. Must be a booking.com /hotel/{country}/{property}.html page, with or without a locale infix; anything else is rejected with a 400.

check_in_datestring

The check-in date, format YYYY-MM-DD. Rejected with a 400 unless it is sent together with check_out_date, is a real calendar date, and is not already past in Etc/GMT+12, the last zone on earth to roll a date over. Booking prices a stay rather than a date, so the rooms array is returned only when both dates are supplied, and is omitted when the property has no availability for the requested stay.

check_out_datestring

The check-out date, format YYYY-MM-DD. Rejected with a 400 unless it is sent together with check_in_date, is a real calendar date that is not already past in Etc/GMT+12, falls strictly later than check_in_date, and leaves a stay of no more than 90 nights.

adultsinteger

The number of adult guests. Room rates are quoted per occupancy, so this is always sent: left unset, Booking picks its own and the same request can return different prices.

children_agesstring

A comma-separated list of the children's ages, each between 0 and 17. The number of values sets the number of children; an age outside that range is a 400.

roomsinteger

The number of rooms to search for. Always sent, for the same reason as adults.

currency'AED' | 'ARS' | 'AUD' | 'AZN' | 'BHD' | 'BRL' | 'BGN' | 'CAD' | 'XOF' | 'CLP' | 'CNY' | 'COP' | 'CZK' | 'DKK' | 'EGP' | 'EUR' | 'FJD' | 'GEL' | 'HKD' | 'HUF' | 'INR' | 'IDR' | 'ILS' | 'JPY' | 'JOD' | 'KZT' | 'KRW' | 'KWD' | 'KGS' | 'LAK' | 'MYR' | 'MXN' | 'MDL' | 'NAD' | 'TWD' | 'NZD' | 'NOK' | 'OMR' | 'PLN' | 'GBP' | 'QAR' | 'RON' | 'RUB' | 'SAR' | 'RSD' | 'SGD' | 'ZAR' | 'SEK' | 'CHF' | 'THB' | 'TRY' | 'UAH' | 'USD' | 'UZS' | 'VND'

The ISO currency code the room prices are returned in. When omitted, Booking prices the page in its own default for the request, which is not guaranteed to be stable between calls.

language'en-gb' | 'en-us' | 'de' | 'nl' | 'fr' | 'es' | 'es-ar' | 'ca' | 'it' | 'pt-pt' | 'pt-br' | 'no' | 'fi' | 'sv' | 'da' | 'cs' | 'hu' | 'ro' | 'ja' | 'zh-cn' | 'zh-tw' | 'pl' | 'el' | 'ru' | 'tr' | 'bg' | 'ar' | 'ko' | 'he' | 'lv' | 'uk' | 'id' | 'ms' | 'th' | 'et' | 'hr' | 'sk' | 'sr' | 'sl' | 'vi' | 'tl' | 'is' | 'lt' | 'en'

The language of the returned property content: room names, amenities, house rules and review categories. Defaults to en-us, Booking's own default English, rather than being left to Booking, so the same request returns the same language every time. en is accepted as an alias for en-us.

api_keystring

Pass API key as query parameter

Response

Successful response

review_topicsstring[]

The topics guests can filter reviews by.

fine_printstring

Booking's "fine print" block: ID and credit-card requirements, minor check-in rules and special-request caveats. Rendered-page only, and genuinely absent on some properties.

Changes

No recorded changes to this operation across all 1 revision of this API.