# Booking Attraction Search ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/booking/attraction/search` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 3 credits per call | | **Documentation** | https://www.piloterr.com/library/booking-attraction-search | ## Description Things to do on Booking.com for a city or an attractions search 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/attraction/search' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Paris attractions, first cards, EUR ```json { "results": [ { "url": "https://www.booking.com/attractions/fr/pre4ksvwxdrd-seine-river-sightseeing-cruise.fr.html", "city": null, "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": 18, "rating": 8.6, "currency": "EUR", "review_count": 5962, "review_label": "Commentaires", "price_display": "À partir de € 18 Tarif actuel : à partir de € 18." }, { "url": "https://www.booking.com/attractions/fr/prjyfitkuhfz-one-day-admission-to-disneylandr-paris.fr.html", "city": null, "name": "Billets d’entrée pour les parcs Disneyland® Paris", "image": "https://r-xx.bstatic.com/xdata/images/xphoto/216x216/322563497.webp?k=bfbb4511f27ba497091230f512094ad57b7615282a051ab85fa65423ed27bbb8&o=", "price": 54, "rating": 9, "currency": "EUR", "review_count": 7408, "review_label": "Commentaires", "price_display": "À partir de € 54 Tarif actuel : à partir de € 54." } ], "pagination": { "next": null, "page": 1, "per_page": 25, "total_pages": null, "total_results": null } } ``` ### Paris attractions, following cards, EUR ```json { "results": [ { "url": "https://www.booking.com/attractions/fr/prf8k7u6zclm-musee-dorsay-admission.fr.html", "city": null, "name": "Entrée au musée d'Orsay", "image": "https://q-xx.bstatic.com/xdata/images/xphoto/216x216/307020404.webp?k=d0d55d3f05906e0d94100873d4b2b629d4af81c6c5e941119ca91ea7543d13a7&o=", "price": 13, "rating": 9.2, "currency": "EUR", "review_count": 3899, "review_label": "Commentaires", "price_display": "À partir de € 13 Tarif actuel : à partir de € 13." }, { "url": "https://www.booking.com/attractions/fr/prvpg5s3r713-city-sightseeing-cruise.fr.html", "city": null, "name": "Croisière touristique au départ de la tour Eiffel", "image": "https://q-xx.bstatic.com/xdata/images/xphoto/216x216/653886863.webp?k=2c775cca7f660b163b116ebd06efa449088c3b2bf6b91bc2c03c54eaa336a8a5&o=", "price": 18, "rating": 8.8, "currency": "EUR", "review_count": 4985, "review_label": "Commentaires", "price_display": "À partir de € 18 Tarif actuel : à partir de € 18." } ], "pagination": { "next": null, "page": 1, "per_page": 25, "total_pages": null, "total_results": 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. Each card is an attraction with its public price, guest rating and image. The Paris Seine cruise below is the first card returned for that search URL. ## Quickstart ``` https://api.piloterr.com/v2/booking/attraction/search?query=https://www.booking.com/attractions/searchresults/fr/paris.fr.html&language=fr¤cy=EUR ``` ``` https://api.piloterr.com/v2/booking/attraction/search?query=Paris&language=fr¤cy=EUR&page=1 ``` ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `query` | string | yes | City name or an /attractions/searchresults/ URL. A city name is requested as /attractions/searchresults/fr/{slug}.{language}.html. | | `page` | integer | no | Page number. Listings use 25 items per page when the source is paginated. | | `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 | | --- | --- | --- | | results[].name | string | Attraction name | | results[].url | string | Attraction URL | | results[].price | number|null | Starting price | | results[].price_display | string|null | Price as printed | | results[].rating | number|null | Guest rating | | results[].review_count | number|null | Review count | | results[].image | string|null | Card image | ## Use cases - Add tours to a Paris itinerary. - Compare starting prices for activities. - Hand the attraction URL to the info endpoint. ## 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. |