BlaBlaCar Daily Public Third Party API v2
This page describes the BlaBlaCar Daily Public Third Party API v2.
This API is strictly reserved for BlaBlaCar Daily partners, and its access must be authenticated using an access_token
Resource Group ¶
Search ¶
Search for rides
GEThttps://partners.blablacardaily.com/2/third_party/public/search{?access_token,departure_latitude,departure_longitude,arrival_latitude,arrival_longitude,departure_epoch,departure_timedelta}
Example URI
GET https://partners.blablacardaily.com/2/third_party/public/search?access_token=53bc0231-2e29-43f8-b894-96ef28f756db&departure_latitude=48.8698273&departure_longitude=2.3357733&arrival_latitude=48.8030819&arrival_longitude=2.1251975&departure_epoch=1512543600&departure_timedelta=3600
URI Parameters
- access_token
string(required) Example: 53bc0231-2e29-43f8-b894-96ef28f756dbAccess token for partner making the request
- departure_latitude
number(required) Example: 48.8698273Passenger departure’s latitude
- departure_longitude
number(required) Example: 2.3357733Passenger departure’s longitude
- arrival_latitude
number(required) Example: 48.8030819Passenger arrival’s latitude
- arrival_longitude
number(required) Example: 2.1251975Passenger arrival’s longitude
- departure_epoch
number(required) Example: 1512543600Requested passenger departure’s time (unix time in seconds) - It should be between 15 minutes to 1 week from now
- departure_timedelta
number(optional) Example: 3600The timedelta around passenger departure’s time (in seconds, defaults to 3600) - The resulting rides will start in the time range [departure_epoch - departure_timedelta, departure_epoch + departure_timedelta]
Response
200
Headers
Content-Type: application/jsonBody
{
"id": "fhsdftsdchd",
"duration": 617,
"distance": 5580,
"pickup_latitude": 48.15,
"pickup_longitude": 2.45,
"pickup_datetime": "1994-11-05T08:15:30-05:00",
"dropoff_latitude": 48.27,
"dropoff_longitude": 2.65,
"web_url": "http://www.blablalines.com/",
"departure_to_pickup_walking_time": 334,
"dropoff_to_arrival_walking_time": 237,
"journey_polyline": "Hello, world!",
"price": {
"amount": 3.5,
"currency": "'EUR'"
},
"available_seats": 2
}Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "id of the ride"
},
"duration": {
"type": "number",
"description": "duration of the ride, in seconds"
},
"distance": {
"type": "number",
"description": "distance of the ride, in meters"
},
"pickup_latitude": {
"type": "number",
"description": "latitude of the pickup point"
},
"pickup_longitude": {
"type": "number",
"description": "longitude of the pickup point"
},
"pickup_datetime": {
"type": "string",
"description": "The ISO8601 date and time of departure from the pickup meeting point. tz is the one corresponding to pickup location."
},
"dropoff_latitude": {
"type": "number",
"description": "latitude of the dropoff point"
},
"dropoff_longitude": {
"type": "number",
"description": "longitude of the dropoff point"
},
"web_url": {
"type": "string",
"description": "the deeplink for this search in the mobile app"
},
"departure_to_pickup_walking_time": {
"type": "number",
"description": "the walking time from the departure to the pickup point, in seconds"
},
"dropoff_to_arrival_walking_time": {
"type": "number",
"description": "the walking time from the dropoff point to the arrival, in seconds"
},
"journey_polyline": {
"type": "string",
"description": "the encoded polyline for the ride. Encoding is done using Google Encoded Polyline Algorithm [https://developers.google.com/maps/documentation/utilities/polylinealgorithm]"
},
"price": {
"type": "object",
"properties": {
"amount": {
"type": "number",
"description": "The price that the passenger agreed to pay for this order"
},
"currency": {
"type": "string",
"description": "The ISO 4217 code for the currency of the amount"
}
},
"required": [
"amount",
"currency"
],
"description": "Price of the ride"
},
"available_seats": {
"type": "number",
"description": "the number of available seats for this ride"
}
},
"required": [
"pickup_datetime"
]
}