# Booking Hotel Info ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/booking/hotel/info` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 3 credits per call | | **Documentation** | https://www.piloterr.com/library/booking-hotel-info | ## Description Property page: description, facilities, coordinates and photos for a Booking hotel URL. ## Authentication - **Key Name:** `x-api-key` - **Location:** HTTP Header - **Get an API key:** https://app.piloterr.com/register ## Example Request ```bash curl --location --request GET 'https://api.piloterr.com/v2/booking/hotel/info' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Hotel Elysée Montmartre, 15-18 June 2026 ```json { "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 } ``` ### Hotel SAX Paris, 15-18 June 2026 ```json { "url": "https://www.booking.com/hotel/fr/sax-paris-lxr-hotels-resorts.fr.html", "name": "Hotel SAX Paris, LXR Hotels & Resorts", "rooms": [], "images": [ "https://cf.bstatic.com/xdata/images/hotel/max1024x768/930596391.jpg?k=59512ef602164732872dcc507134f1e6de8710a11ebdda9f329ba01c28402f34&o=", "https://cf.bstatic.com/xdata/images/hotel/max500/930596387.jpg?k=1347ac33dfc7e57846f95dde9d14ba5f51e42f946c4ffd73a528105f3e7f2c45&o=", "https://cf.bstatic.com/xdata/images/hotel/max500/930596385.jpg?k=962e89cfa39f9efb89e8d182b86753f09aa6e0a8a47767ff87e324736cb7e9c3&o=", "https://cf.bstatic.com/xdata/images/hotel/max300/930596392.jpg?k=e4f6ca2c495812ebd84a99a1b4f2e570c15e492cfde0a4afc72de752d75e8af1&o=" ], "address": null, "check_in": null, "currency": "EUR", "hotel_id": "sax-paris-lxr-hotels-resorts", "latitude": "48.8467251", "check_out": null, "longitude": "2.313002421", "facilities": [ "Cuisine française • internationale", "Ouvert pour Petit-déjeuner • Brunch • Déjeuner • Dîner • Collations l'après-midi • Apéritif", "Ambiance Familiale • Moderne", "Cuisine française", "Ouvert pour Apéritif", "Ambiance Moderne", "Ouvert pour Déjeuner • Dîner • Collations l'après-midi • Apéritif", "Cuisine japonaise" ], "description": "Bénéficiez d'un traitement VIP grâce au service exclusif de l'établissement Hotel SAX Paris, LXR Hotels & Resorts L’établissement Hotel SAX Paris, LXR Hotels & Resorts bénéficie d’un emplacement idéal dans le centre de Paris. Il propose une connexion Wi-Fi gratuite, une piscine extérieure, un jardin et des hébergements dotés de la climatisation. Il comprend un restaurant, une terrasse, un sauna et un bain à remous. V", "review_count": null, "review_label": "note", "review_score": 9.2 } ``` ## Documentation ## Overview Queries Booking.com through an unlocked browser session and returns structured JSON. `language` is the Booking locale suffix (`fr`, `en-gb`, `de`, …), not a country domain. `currency` is an ISO 4217 code sent as `selected_currency`. One call returns one page. Dates and guests are forwarded to the property URL. Room rows are included when Booking renders the rate table in the unlocked HTML. Photos exclude flag sprites. ## Quickstart ``` https://api.piloterr.com/v2/booking/hotel/info?query=https://www.booking.com/hotel/fr/elysee-montmartre.fr.html&check_in=2026-06-15&check_out=2026-06-18&adults=2&language=fr¤cy=EUR ``` ``` https://api.piloterr.com/v2/booking/hotel/info?query=https://www.booking.com/hotel/fr/sax-paris-lxr-hotels-resorts.fr.html&check_in=2026-06-15&check_out=2026-06-18&adults=2&language=fr¤cy=EUR ``` ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `query` | string | yes | Full https://www.booking.com/hotel/{country}/{slug} URL. | | `check_in` | string | no | Check-in date, YYYY-MM-DD. Optional. Must be before check_out. | | `check_out` | string | no | Check-out date, YYYY-MM-DD. Required when check_in is set. | | `adults` | integer | no | Adults. Default 2. | | `children` | integer | no | Children. Default 0. Without children_ages, each child is treated as age 8. | | `children_ages` | string | no | Comma-separated ages, one per child, 0-17. | | `rooms` | integer | no | Rooms. Default 1. | | `language` | string | no | Booking locale: fr, en-gb, en-us, de, es, it, pt-pt, nl, … Aliases: en, uk, gb, pt, zh, br. | | `currency` | string | no | ISO 4217 code. Default USD. Example EUR. | ## Response fields | Field | Type | Description | | --- | --- | --- | | name | string | Property name | | url | string | Hotel URL without tracking query | | description | string|null | Property description | | facilities | string[] | Listed amenities | | images | string[] | Photo URLs | | latitude | string|null | Latitude | | longitude | string|null | Longitude | | rooms | object[] | Name and price when the rate table is present | | currency | string | Requested currency | ## Use cases - Show a property sheet after a search result click. - Collect amenities and the written description. - Attach coordinates to a map pin. ## Error codes | Code | Description | | --- | --- | | 400 | Missing query, unknown language, bad currency, or checkout not after check-in. | | 404 | The page was fetched but no matching records could be parsed. | | 500 | The unlocked fetch failed or the page was blocked. |