📰 Search V3 - API Documentation

The API gives access to carpool trips on BlaBlaCar.

The base URL of the API is:

https://public-api.blablacar.com

The path to search for trips is:

GET /api/v3/trips

Your API key must be provided as a query parameter in all your requests, like below:

curl https://public-api.blablacar.com/api/v3/trips?key=YOUR_API_KEY&from_coordinate=48.864716%2C2.349014&from_country=FR&to_coordinate=51.509865%2C-0.118092&to_country=GB&locale=fr-FR&currency=EUR&from_cursor=cGFnZT0xOA%3D%3D&start_date_local=2019-01-10%2008%3A55%3A00

Each trip result includes a link to get more details on this specific trip on BlaBlaCar's platform.

How to redirect to Blablacar website?

You should not try to rewrite the redirection link. You should use the one returned in the trip result and concatenate your marketing/campaign code.

?comuto_cmkt=MARKETING_CODE&utm_campaign=CAMPAIGN&utm_medium=API&utm_source=SOURCE&utm_content=WHATYOUWANT

This page is deep-linked and the website will detect if it's a mobile device and if the BlaBlaCar's app is on the device. In such a case, the user will be redirected to the app.

Query Parameters

Name Type Required Description Example
from_coordinate String Required The departure coordinate.

Format: "latitude,longitude" url encoded.

48.864716,2.349014
to_coordinate String Required

The arrival coordinate.

Format: "latitude,longitude" url encoded.

48.864716,2.349014
from_country String Required The ISO_3166_1 departure country. FR
to_country String Required The ISO_3166_1 arrival country. GB
locale String Required The locale in which the result will be displayed. Available locales and their possible currencies are detailed here fr-FR
currency String Required The ISO_4217 currency in which the price will be returned. EUR
from_cursor String Optional Results are returned using pagination. The cursor is a reference to the current page. The results for the next page, if any, can be fetched using the next_cursor attribute. If a request is made without specifying a from_cursor, the results of the first page will be returned. cGFnZT0xOA==
count Integer Optional

The number of trips to return per page, up to a maximum of 100. Default value is 10.

20
start_date_local String(date-time) Required Search for trips starting after this date. The time is supposed to be in the timezone of the departure point.

Format: "yyyy-M-dTHH:mm:ss".

Default value is current DateTime.
2020-01-10T08:55:00
end_date_local String(date-time) Optional Search for trips ending before this date. The time is supposed to be in the timezone of the arrival point.

Format: "yyyy-M-dTHH:mm:ss"

2020-01-12T08:55:00
requested_seats Integer Optional The minimum number of seats requested. Default value is 1. 1
radius_in_meters Integer Optional Determines the radius of the circle around the given search coordinates in which trips will be searched from (in meters). 5000
sort String Optional

Determines the field (departure_datetime or price) and order (ascending or descending) trip results are sorted by. By default, results are sorted by departure datetime in ascending order.

Allowed values: "departure_datetime:asc", "departure_datetime:desc", "price:asc", "price:desc"

price:asc

 

Response

Name Type Comment
link String The URL to redirect to the search results page on the BlaBlaCar website. 
search_info Object Information about the search
trips Array of trips Detail of the trips found which match the query
next_cursor String The reference to the next page. This parameter will be null for the last page of results returned.

Click here to see a Json example

The format of each response object is detailed here.

In case of errors, look at this article.

Was this article helpful?
4 out of 4 found this helpful
Didn't find what you're looking for? Contact us.