Piloterr

Booking Hotel Info

GET
/v2/booking/hotel/info

Property page: description, facilities, coordinates and photos for a Booking hotel URL.

Credit cost: 3 credits per call

Autorisierung

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Abfrageparameter

query*string

Required. Full https://www.booking.com/hotel/{country}/{slug} URL.

https://www.booking.com/hotel/fr/elysee-montmartre.fr.html
https://www.booking.com/hotel/fr/sax-paris-lxr-hotels-resorts.fr.html
country?string

Optional. Two-letter market code. The value sent is the code, for example ar. It does not change the proxy. Booking sets the cookie explicit_language_preference and the Accept-Language header. If language is empty, this also sets the page language. A URL in query is not rewritten. Any other code returns 400.

ar
fr

Accepted codes: ar, at, be, br, ca, ch, cl, cn, co, cz, de, dk, es, fi, fr, gb, hu, ie, it, jp, mx, nl, no, pe, pl, pt, ro, se, tw, uk, us, uy.

return_page_source?boolean

Optional. Default false. true returns {"result": html} instead of JSON. A Chrome, Brave, or Internet Explorer proxy error is still HTTP 500, and that error page is not returned.

false
Defaultfalse
check_in?string

Optional. Send only together with check_out.

check_out?string

Optional. Required only when check_in is set.

adults?number

Optional. Default 2.

Default"2"
children?number

Optional. Default 0.

Default"0"
children_ages?string

Optional.

rooms?number

Optional. Default 1.

Default"1"
language?string

Optional. Default en-gb.

currency?string

Optional. Default USD.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Antworttext

Successful response

application/json
  1. response
url?string
name?string
rooms?array<unknown>
images?array<string>
address?unknown
results?array<unknown>
check_in?unknown
currency?string
hotel_id?string
latitude?string
check_out?unknown
longitude?string
facilities?array<string>
description?string
review_count?unknown
review_label?string
review_score?number
Example Request
curl -X GET 'https://api.piloterr.com/v2/booking/hotel/info?query=string'
Example Response
{  "url": "https://www.booking.com/hotel/fr/elysee-montmartre.fr.html",  "name": "Hotel Elysée Montmartre",  "rooms": [],  "images": [    "https://cf.bstatic.com/xdata/images/hotel/max1024x768/727407309.jpg?k=e4975a801d56b4506ef15a36f03bfcbce355fd7fd7c1cd03295b9fddb54e1863&o=",    "https://cf.bstatic.com/xdata/images/hotel/max500/631101901.jpg?k=595529e00ec2f2728cebc83bc5eea707742c355d43c846a6b413502cb2c2ab77&o=",    "https://cf.bstatic.com/xdata/images/hotel/max500/670051386.jpg?k=b543168f77417669f3fe8b32681624f3c98c05c9e1de573c99d5910c70c45969&o=",    "https://cf.bstatic.com/xdata/images/hotel/max300/726867716.jpg?k=c18eb23efd21b3dec7b5a607d44bec8e48292c56800975fe4dd92bccc88cbcd6&o="  ],  "address": null,  "results": [],  "check_in": null,  "currency": "EUR",  "hotel_id": "elysee-montmartre",  "latitude": "48.8830527",  "check_out": null,  "longitude": "2.3435835",  "facilities": [    "Parking",    "Connexion Wi-Fi gratuite",    "Chambres familiales",    "Chambres non-fumeurs",    "Réception ouverte 24h/24",    "Équipements pour les personnes handicapées",    "Service d'étage",    "Ascenseur"  ],  "description": "L’établissement Hotel Elysée Montmartre se situe à Paris, à 1,1 km de ce lieu d’intérêt : Gare du Nord. Il possède un service de concierge, un salon commun, un bar, des hébergements non-fumeurs, ainsi qu'une connexion Wi-Fi gratuite dans l’ensemble de ses locaux. Cet hôtel 4 étoiles propose un service d'étage et une réception ouverte 24h/24. Le personnel sur place peut organiser un service de navette.\n\nLa salle de ba",  "review_count": null,  "review_label": "note",  "review_score": 9.3}