📰 API documentation

  • Updated

The API gives access to carpool trips on BlaBlaCar. The results are identical to those obtained for a similar search on the associated website. Each trip result includes a "links" object to get more details on this specific trip and you should use them instead of trying to reconstruct them.

The base URL is:

https://public-api.blablacar.com

It's a REST API, available only with GET queries.
You can transmit you API KEY either with the `key` parameter, either as a query parameter or as an HTTP header: 

  • Using an API key: 
https://public-api.blablacar.com/api/v2/trips?key=XXX&fn=Paris
  •  Using an HTTP header: 
curl -H 'key: XXX' https://public-api.blablacar.com/api/v2/trips?fn=Paris

NB: for simplification, the following examples are given without authentication

Trip Search

Search for trips on BlaBlaCar’s database.

GET /api/v2/trips

Example: https://public-api.blablacar.com/api/v2/trips?fn=Paris

Query Parameters

Name Type Required Description Example
fn String Optional From Name: the departure place name Paris
tn String Optional To Name: the arrival place name London
locale String Required

Available locales and their possible currencies are detailed here

 en_GB
_format String Optional "json" json
cur String Required

Select the currency you want, depending on the requested locale. For example, with the "en_GB" locale, use GBP to get prices in British Pounds

 EUR
fc String Optional

From Coordinate, as: "float|float", will be prefered to the "fn" parameter if both are presents

 48.756%7C7.268
tc String Optional

To Coordinate, as: "float|float", will be prefered to the "tn" parameter if both are presents

 48.756%7C7.268
db String(date-time) Optional Date Begin, can mean one of the two following:
  • exact date of the requested search if no "de" parameter is present
  • begin of the period of the requested search, if there is also a "de" parameter

Format: "YYYY-MM-DD" or "YYYY-MM-DD HH:mm:ss"

 2019-09-05
de String(date) Optional Date End: end of the range of the requested search

Format: "YYYY-MM-DD" or "YYYY-MM-DD HH:mm:ss"

 2019-09-07
hb Integer Optional

Hour Begin: hour of the earliest departure time. must be >= 0 and < 24

 7
he Integer Optional

Hour End: hour of the latest departure time. must be > 0 and <= 24 and > hb

 14
page Integer Optional

Number of the requested page of result, if there is more than 1 page

 1
seats Integer Optional number of requested available seats 1
photo Boolean(integer) Optional Limit results to trips with or without driver pictures 1
fields String Optional

Limit the response to the mentioned fields of the return values

 links%2Cprice%2Cpermanent_id
sort String Optional Sorting parameter of the query. Possible values are:
  • “trip_date” or
  • ”trip_price”
 trip_price
order String Optional

Order of the sorting. Only used in combination with “sort”. Possible values are:

  • “asc” or
  • “desc”
 desc
limit Integer Optional

Maximum number of results requested. May results in slower and bigger queries. Must be < 100

 50
radius Integer Optional

Maximum radius of the search, in km Default is 10% of the length of the trip

 10
radius_from Integer Optional

Maximum radius of the search for the "from" element. If not specified and "radius" is set, it will use the "radius" value

 5
radius_to Integer Optional

Maximum radius of the search for the "to" element. If not specified and "radius" is set, it will use the "radius" value

 15
aa Boolean Optional

Automatic Approval booking mode only. When set to 1, it will only return trips in automatic approval

 1
blablalines Integer Optional

Include blablalines results (for short trips, in France only)

 1
pmin Integer Optional

Minimum price requested (pmax must also be set). This must be < pmax

 2
pmax Integer Optional

Maximum price requested (pmin must also be set). This must be > pmax

 142

 

Responses

Name Type Comment
links Object Links related to the query
pager Object Pagination detail on the number of results
trips Array of trip Detail of the trips found which match the query
top_trips Array of trip Selection of recommended trips
 facets Object Detail on the results set by properties
distance int Distance in km of the requested axis
duration int  Default duration of the requested axis,
recommended_price int Recommended price of the requested axis
 savings int Default savings possible on this axis

The format of each response object is detailed here.

in case of errors, look at this article.

Trip Details

Get the details of a specific trip

GET /api/v2/trips/{Trip_ID}

Example: https://public-api.blablacar.com/api/v2/trips/123456789-paris-angers

URL Parameters

Name Type Required Description Example
Trip_ID String Required Identifier of the requested trip 123456789-paris-angers

 

Query Parameters

Name Type Required Description Example
locale String Required

Available locales and their possible currencies are detailed here

 en_GB
_format String Required "json" or "xml" json

 

Responses

Name Type Comment
links Object Links to the corresponding trip
departure_date string

Locale Date of departure of the trip
(format: JJ/MM/YYYY HH:MM:SS)
example: 05/09/2019 11:20:00
departure_date_iso8601 string

Date of departure of the trip
(format: iso8601)
example: 2019-09-05T11:20:00+01:00
is_passed bool Has the trip already started
departure_place Place Object Place of departure of the trip
arrival_place Place Object Place of arrival of the trip
departure_meeting_point Place Object Related Meeting point for the departure
price Price Object Price of 1 seat
price_with_commission Price Object Full Price including the commission
price_without_commission Price Object Net Price asked by the driver
commission Price Object Value of the commission
seats_left int Number of available seats
seats int Number of seats on the trip
seats_count_origin int Initial number of seats on the trip
duration Value Object Value and unity of the trip duration
distance Value Object Value and unity of the trip distance
permanent_id string Permanent identifier of the trip
main_permanent_id string Identifier of the main trip, if this one is a subtrip 
comment string Comment of trip as published by the driver
car Car Object Associated car the trip
viaggio_rosa bool Is this a women only trip?
is_comfort bool Is this a "max 2 in the back seats" trip?
freeway bool Will the trip use an highway?
stop_overs Array of Places  Array of stopovers for the trip
bucketing_eligible bool Eligible to bucketing?
booking_mode string The booking approval mode, one of "auto", "manual"
booking_type string The payment type, one of "online", "onboard"
is_booking_allowed Object Is it possible to book on this trip?
view_count int Number of display of this trip
cross_border_alert true Is this trip crossing a border?
trip_plan Array of Places Itinerary planned for the trip
messaging_status string "public" or "private" 
passengers Array of Passengers Passengers already booked on the same trip
display_contact bool Is it possible to contact the driver?
vehicle_pictures Array of   
can_report bool Is it possible to report the driver? 

The format of each response object is detailed here.