# Booking Destination ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/booking/destination/info` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 3 credits per call | | **Documentation** | https://www.piloterr.com/library/booking-destination-info | ## Description Booking hub for a country, region, city, district, landmark or airport 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/destination/info' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Paris city hub ```json { "url": "https://www.booking.com/city/fr/paris.fr.html", "kind": "city", "name": "Recherchez des hôtels à Paris", "results": [ { "url": "https://www.booking.com/hotel/fr/elysee-montmartre.fr.html", "name": "Hotel Elysée Montmartre", "image": "https://cf.bstatic.com/xdata/images/hotel/270x200/727407309.jpg?k=e4975a801d56b4506ef15a36f03bfcbce355fd7fd7c1cd03295b9fddb54e1863&o=", "price": 313, "stars": 4, "address": "Hôtel à Paris (18e arr.)", "currency": "EUR", "hotel_id": "elysee-montmartre", "review_count": 495, "review_label": "Hotel", "review_score": 9.2, "price_display": "À partir de € 313 par nuit" }, { "url": "https://www.booking.com/hotel/fr/sax-paris-lxr-hotels-resorts.fr.html", "name": "Hotel SAX Paris, LXR Hotels & Resorts", "image": "https://cf.bstatic.com/xdata/images/hotel/270x200/930596391.jpg?k=59512ef602164732872dcc507134f1e6de8710a11ebdda9f329ba01c28402f34&o=", "price": 561, "stars": 5, "address": "Hôtel à Paris (7e arr.)", "currency": "EUR", "hotel_id": "sax-paris-lxr-hotels-resorts", "review_count": 360, "review_label": "Hotel", "review_score": 9.2, "price_display": "À partir de € 561 par nuit" } ], "children": [ { "url": "https://www.booking.com/country/fr.fr.html", "kind": "country", "name": "France", "hotels_count": null }, { "url": "https://www.booking.com/region/fr/ile-de-france.fr.html", "kind": "region", "name": "Île-de-France", "hotels_count": null } ], "pagination": { "next": "https://www.booking.com/city/fr/paris.fr.html?offset=25", "page": 1, "per_page": 25, "total_pages": null, "total_results": null }, "country_code": "fr", "hotels_count": 13135 } ``` ### Île-de-France region hub ```json { "url": "https://www.booking.com/region/fr/ile-de-france.fr.html", "kind": "region", "name": "Recherchez des hôtels en France, dans cette région : Île-de-France", "results": [ { "url": "https://www.booking.com/hotel/fr/ibis-paris-cdg-airport.fr.html", "name": "ibis Paris CDG Airport", "image": "https://q-xx.bstatic.com/xdata/images/hotel/270x270/934461447.jpg?k=5a35adb3011a30d7c3391403aac9b89bc9349a769d7dfd3e20eed0f4b49ae707&o=", "price": null, "stars": 3, "address": null, "currency": null, "hotel_id": "ibis-paris-cdg-airport", "review_count": 30615, "review_label": "Paris", "review_score": 7.6, "price_display": null }, { "url": "https://www.booking.com/hotel/fr/hotelf1-paris-porte-de-montmartre.fr.html", "name": "HotelF1 Paris Saint Ouen Marché Aux Puces", "image": "https://q-xx.bstatic.com/xdata/images/hotel/270x270/871791241.jpg?k=73aab7f38cc117e36bdb22d508ce2566ea19ce1405b0867ff904c7ede1b64730&o=", "price": null, "stars": 1, "address": null, "currency": null, "hotel_id": "hotelf1-paris-porte-de-montmartre", "review_count": 17539, "review_label": "HotelF1", "review_score": 5.9, "price_display": null } ], "children": [ { "url": "https://www.booking.com/country/fr.fr.html", "kind": "country", "name": "France", "hotels_count": null }, { "url": "https://www.booking.com/city/fr/paris.fr.html", "kind": "city", "name": "Paris", "hotels_count": null }, { "url": "https://www.booking.com/city/fr/roissy-en-france.fr.html", "kind": "city", "name": "Roissy-en-France", "hotels_count": null } ], "pagination": { "next": "https://www.booking.com/region/fr/ile-de-france.fr.html?offset=25", "page": 1, "per_page": 25, "total_pages": null, "total_results": null }, "country_code": "fr", "hotels_count": 26448 } ``` ## 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. The hub returns its title, kind, country code, child links (districts, airports, regions) and the property cards rendered on the page. ## Quickstart ``` https://api.piloterr.com/v2/booking/destination/info?query=https://www.booking.com/city/fr/paris.fr.html ``` ``` https://api.piloterr.com/v2/booking/destination/info?query=https://www.booking.com/region/fr/ile-de-france.fr.html&language=fr ``` ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `query` | string | yes | Hub URL: /country/, /region/, /city/, /district/, /landmark/ or /airport/. | | `language` | string | no | Booking locale: fr, en-gb, en-us, de, es, it, pt-pt, nl, … Aliases: en, uk, gb, pt, zh, br. | | `page` | integer | no | Page number. Listings use 25 items per page when the source is paginated. | ## Response fields | Field | Type | Description | | --- | --- | --- | | name | string | Hub title | | kind | string | country, region, city, district, landmark or airport | | country_code | string | Country code from the path | | children | object[] | Linked hubs: name, kind, url | | results | object[] | Property cards on the hub | | pagination | object | Paging for the card list | ## Use cases - Browse from a country down to a city. - List hotels shown on a region page. - Collect district and airport links for a city. ## 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. |