# Booking Car Search ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/booking/car/search` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 3 credits per call | | **Documentation** | https://www.piloterr.com/library/booking-car-search | ## Description Car rental city rates and suppliers from Booking.com cars pages. ## 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/car/search' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Paris average daily rates, EUR ```json { "results": [ { "car": "Paris", "url": "https://www.booking.com/cars/city/fr/paris.fr.html", "price": 67.41, "currency": "EUR", "supplier": null, "price_display": "Paris 307 agences de location de voitures Tarif moyen par jour : € 67,41" }, { "car": "Aéroport de Paris - Roissy - Charles-de-Gaulle", "url": "https://www.booking.com/cars/airport/fr/cdg.fr.html", "price": 65.64, "currency": "EUR", "supplier": null, "price_display": "Aéroport de Paris - Roissy - Charles-de-Gaulle 99 agences de location de voitures Tarif moyen par jour : € 65,64" }, { "car": "Aéroport de Paris - Orly", "url": "https://www.booking.com/cars/airport/fr/ory.fr.html", "price": 59.98, "currency": "EUR", "supplier": null, "price_display": "Aéroport de Paris - Orly 49 agences de location de voitures Tarif moyen par jour : € 59,98" }, { "car": "Aéroport de Paris - Beauvais-Tillé", "url": "https://www.booking.com/cars/airport/fr/bva.fr.html", "price": 69.61, "currency": "EUR", "supplier": null, "price_display": "Aéroport de Paris - Beauvais-Tillé 30 agences de location de voitures Tarif moyen par jour : € 69,61" } ], "pagination": { "next": null, "page": 1, "per_page": 25, "total_pages": 1, "total_results": 4 } } ``` ### Lyon average daily rate, EUR ```json { "results": [ { "car": "Lyon", "url": "https://www.booking.com/cars/city/fr/lyon.fr.html", "price": 62.63, "currency": "EUR", "supplier": null, "price_display": "Lyon 95 agences de location de voitures Tarif moyen par jour : € 62,63" }, { "car": "Aéroport de Lyon - Saint-Exupéry", "url": "https://www.booking.com/cars/airport/fr/lys.fr.html", "price": 54.29, "currency": "EUR", "supplier": null, "price_display": "Aéroport de Lyon - Saint-Exupéry 53 agences de location de voitures Tarif moyen par jour : € 54,29" }, { "car": "Grand Lyon Agglomération", "url": "https://www.booking.com/cars/region/fr/grand-lyon-agglomeration.fr.html", "price": 61.5, "currency": "EUR", "supplier": null, "price_display": "Grand Lyon Agglomération 115 agences de location de voitures Tarif moyen par jour : € 61,50" } ], "pagination": { "next": null, "page": 1, "per_page": 25, "total_pages": 1, "total_results": 3 } } ``` ## 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. A city name reads the cars index and keeps rows whose label contains that city. `car` is the city or vehicle label, `price` is the average daily amount when Booking prints one, and `url` opens the city cars page. ## Quickstart ``` https://api.piloterr.com/v2/booking/car/search?query=Paris&language=fr¤cy=EUR ``` ``` https://api.piloterr.com/v2/booking/car/search?query=https://www.booking.com/cars/city/fr/paris.fr.html¤cy=EUR ``` ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `query` | string | yes | City name or a Booking cars URL. Example: Paris. | | `pick_up` | string | no | Pick-up date YYYY-MM-DD. Send with drop_off. | | `drop_off` | string | no | Drop-off date YYYY-MM-DD, after pick_up. | | `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[].car | string|null | City or vehicle label | | results[].supplier | string|null | Supplier when the card is a brand logo | | results[].price | number|null | Average daily price | | results[].price_display | string|null | Price line as printed | | results[].currency | string | Requested currency | | results[].url | string|null | Cars city or supplier URL | ## Use cases - Show the average daily car rate for a city. - Link to the Booking cars city page. - Compare a handful of cities from the index. ## 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. |