# Booking Attraction Info ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/booking/attraction/info` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 3 credits per call | | **Documentation** | https://www.piloterr.com/library/booking-attraction-info | ## Description One Booking.com attraction page. ## 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/attraction/info' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Seine sightseeing cruise ```json { "url": "https://www.booking.com/attractions/fr/pre4ksvwxdrd-seine-river-sightseeing-cruise.fr.html", "name": "Croisière touristique Paris Seine avec commentaires par Bateaux Parisiens", "image": "https://r-xx.bstatic.com/xdata/images/xphoto/216x216/134464492.webp?k=664cde36f2f9020434de24644142140f0866d6d0f77b907751762acf1a031d61&o=", "price": null, "rating": 8.6, "address": null, "currency": "EUR", "duration": null, "description": null, "review_count": 5962, "review_label": "Commentaires", "price_display": null } ``` ### Disneyland Paris one-day admission ```json { "url": "https://www.booking.com/attractions/fr/prjyfitkuhfz-one-day-admission-to-disneylandr-paris.fr.html", "name": "Billets d’entrée pour les parcs Disneyland® Paris", "image": "https://t-cf.bstatic.com/design-assets/assets/v3.202.0/images-flags/Fr@3x.png", "price": null, "rating": 9, "address": null, "currency": "EUR", "duration": null, "description": null, "review_count": 7408, "review_label": null, "price_display": null } ``` ## 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. Returns the attraction title, URL, rating and currency. Description, duration and address are filled when those blocks are present in the unlocked page. ## Quickstart ``` https://api.piloterr.com/v2/booking/attraction/info?query=https://www.booking.com/attractions/fr/pre4ksvwxdrd-seine-river-sightseeing-cruise.fr.html&language=fr¤cy=EUR ``` ``` https://api.piloterr.com/v2/booking/attraction/info?query=https://www.booking.com/attractions/fr/prjyfitkuhfz-one-day-admission-to-disneylandr-paris.fr.html&language=fr¤cy=EUR ``` ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `query` | string | yes | Attraction URL under /attractions/. Search-result URLs are rejected. | | `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 | Title | | url | string | Canonical URL | | rating | number|null | Guest rating | | review_count | number|null | Review count | | price | number|null | Price | | description | string|null | Description | | currency | string | Requested currency | ## Use cases - Show one activity after search. - Display the guest rating next to the title. - Keep the canonical URL for a deep link. ## 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. |