Piloterr

Booking Car Search

GET
/v2/booking/car/search

Car rental city rates and suppliers from Booking.com cars pages.

Credit cost: 3 credits per call

Autorisierung

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Abfrageparameter

query*string

Required. City name or a Booking cars URL. The value sent is the city or the page URL.

Paris
https://www.booking.com/cars/index.fr.html?ss=Paris
pick_up?string

Optional. Send only together with drop_off.

drop_off?string

Optional. Required only when pick_up is set, and it must be after pick_up.

language?string

Optional. Default en-gb.

currency?string

Optional. Default USD.

page?number

Optional. Default 1.

Default"1"
country?string

Optional. Two-letter market code. The value sent is the code, for example ar. It does not change the proxy. Booking sets the cookie explicit_language_preference and the Accept-Language header. If language is empty, this also sets the page language. A URL in query is not rewritten. Any other code returns 400.

ar
fr

Accepted codes: ar, at, be, br, ca, ch, cl, cn, co, cz, de, dk, es, fi, fr, gb, hu, ie, it, jp, mx, nl, no, pe, pl, pt, ro, se, tw, uk, us, uy.

return_page_source?boolean

Optional. Default false. true returns {"result": html} instead of JSON. A Chrome, Brave, or Internet Explorer proxy error is still HTTP 500, and that error page is not returned.

false
Defaultfalse
fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Antworttext

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/booking/car/search?query=string'
Example Response
{  "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  }}