API Documentation
Clients' login
Direct Event Data Serving
Event Data Fetching and Storage
Client Data
Get events
Get events according to your filters. You can use it to serve a map or event stream.
curl --request POST \
--url https://www.wander-service.fr/api/clients/v2/get/events \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"categories": [
"spectacle"
],
"sources": [
"fnac"
],
"locationFilter": {
"circle": {
"lng": 2.333333,
"lat": 48.866667,
"maxDistance": 500
}
},
"datesFilter": {
"minDate": "2024-09-12T12:00:06.138Z",
"maxDate": "2024-12-12T12:00:06.138Z"
},
"pricesFilter": {
"lowestPrice": 123,
"highestPrice": 200,
"hasKnownPrice": false
},
"limit": 5,
"pageNumber": 1,
"orderBy": "distance",
"orderByDistance": {
"lng": 2.333333,
"lat": 48.866667
},
"getCommentaries": false,
"getPerformers": false
}'
{
"data": [
{
"id": 100000,
"wanderId": 100000,
"wanderLink": "https://wander-app.fr/event/100000-plk-en-concert-accor-arena",
"name": "PLK en concert",
"startDate": "2024-03-03 06:08:23.222 +0100",
"endDate": "2024-03-04 06:08:23.222 +0100",
"hasEndDateNotReliable": true,
"lowestPrice": 0,
"highestPrice": 200,
"description": "Un super concert de PLK à l'accor arena !",
"hasGoodDeal": true,
"image": "<string>",
"imageHeight": 123,
"imageWidth": 123,
"squareImage": "<string>",
"rectangleImage": "<string>",
"webImage": "<string>",
"notAvailableAt": "2024-09-12T12:00:06.138Z",
"cancelledAt": "2024-09-12T12:00:06.138Z",
"createdAt": "2024-09-12T12:00:06.138Z",
"updatedAt": "2024-09-12T12:00:06.138Z",
"googlePlace": {
"id": "ChIJi4rRh5jVEEgRm5kJBs9ZLSY",
"name": "Accor Arena",
"address": "8 Bd de Bercy, 75012 Paris, France",
"lng": 2.3784703,
"lat": 48.8386038,
"averageGrade": 4.4,
"totalGrades": 33620,
"street": "8 Boulevard de Bercy",
"city": "Paris",
"postalCode": 75012,
"country": "FR",
"photoRef": "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S",
"website": "https://www.accorarena.com/fr",
"editorialSummary": "<string>",
"periods": [
{
"open": {
"day": 0,
"time": "0900"
},
"close": {
"day": 0,
"time": 1800
}
}
]
},
"place": {
"id": 10,
"googleId": "ChIJ9dfFtXYmVQ0RXL6FkWtY8lA",
"name": "Accor Arena",
"address": {
"lng": 2.123909,
"lat": 42.32981038,
"street": "Rue Saint-Jacques",
"city": "Paris",
"postalCode": 75005,
"country": "France"
},
"image": "<string>",
"squareImage": "<string>",
"rectangleImage": "<string>",
"averageGrade": 123,
"totalGrades": 123
},
"sources": [
{
"id": 45,
"partner": {
"name": "fnac",
"logo": "<string>",
"backColor": "<string>"
},
"startDate": "<string>",
"endDate": "<string>",
"lowestPrice": 0,
"highestPrice": 200,
"isGoodDeal": true,
"commissionFix": 1,
"commissionPerTicket": 1,
"commissionPerCart": 1,
"commissionRate": 0.05,
"link": "<string>",
"isBookable": true,
"availableDates": [
{
"startDate": "<string>",
"endDate": "<string>",
"hasEndDateNotReliable": true,
"hasUnknownAvailability": true
}
],
"averageGrade": 5,
"totalGrades": 1,
"cantRetrieveAvailableDates": true,
"notAvailableAt": "<string>"
}
],
"categories": [
{
"id": 1,
"mainCategory": "expo",
"subCategory": "painting",
"traductionFR": "peinture",
"traductionEN": "painting",
"icon": "<string>"
}
],
"commentaries": [
{
"grade": 5,
"content": "Amazing concert !",
"username": "Wander bot",
"date": "<string>"
}
],
"averageGrade": 5,
"totalGrades": 1,
"trendingScore": 10,
"performers": [
{
"id": 45,
"name": "PLK",
"description": "<string>",
"image": "<string>",
"webImage": "<string>"
}
]
}
],
"pagination": {
"totalItems": 1000,
"totalPages": 20,
"perPage": 50,
"currentPage": 5,
"nextPageParams": {
"pageNumber": 6,
"limit": 50
},
"previousPageParams": {
"pageNumber": 4,
"limit": 50
}
}
}
Authorizations
It is the "access_token" returned after login
Body
It is a filter. By default, you get all the event categories.
atelier
, brocante
, cinema
, conference
, enfants
, expo
, festival
, gastronomie
, livres
, loisirs
, meeting
, musique
, nature
, pro
, salon
, sciences
, soiree
, solidarite
, spectacle
, sport
, visite
, none
It is a filter. By default, you get all sources. Check the back office for possible values.
You can define a location filter corresponding to a circle or a rectangle.
You can set the date after which you want your events to take place. By defaut the events you get take place after now. Warning, date must be in ISO format.
"2024-09-12T12:00:06.138Z"
You can set the date before which you want your events to take place. By defaut the events you get take place before next week. If you set the date too far in the future, this may affect the performance of the query. Warning, date must be in ISO format.
"2024-12-12T12:00:06.138Z"
1 <= x <= 500
5
1
You can order the events you get by dates or by prices or by distance to a place definied with 'orderByDistance' or by last update dates to update your records. By default it's by ascendant endDates.
startDate
, endDate
, updatedAt
, lowestPrice
, highestPrice
, distance
"distance"
Set it to true if you want to retrieve commentaries on events you get. Warning, this reduces the performance of the request, so only use it if you want to use this data.
false
Set it to true if you want to retrieve performers on events you get. Warning, this reduces the performance of the request, so only use it if you want to use this data.
false
Response
100000
100000
Link to the event in the Wander app
"https://wander-app.fr/event/100000-plk-en-concert-accor-arena"
"PLK en concert"
"2024-03-03 06:08:23.222 +0100"
"2024-03-04 06:08:23.222 +0100"
The lowest price for the event in euros. If it's null, we don't know the price.
0
The highest price for the event in euros. If it's null, we don't know the price.
200
"Un super concert de PLK à l'accor arena !"
This attribute is a boolean which is set to ‘true’ when a good deal on the event is identified during integration (discount, early bird ticket, preferential rate, etc.). One of the sources has 'isGoodDeal' set to true.
This is the image compressed.
This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability.
"2024-09-12T12:00:06.138Z"
This is the date on which the event was cancelled.
"2024-09-12T12:00:06.138Z"
"2024-09-12T12:00:06.138Z"
"2024-09-12T12:00:06.138Z"
Contains enriched place information retrieved from the Google Places API.
"ChIJi4rRh5jVEEgRm5kJBs9ZLSY"
"Accor Arena"
The formatted address of the place.
"8 Bd de Bercy, 75012 Paris, France"
2.3784703
48.8386038
4.4
33620
"8 Boulevard de Bercy"
"Paris"
75012
"FR"
"AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S"
"https://www.accorarena.com/fr"
Represents the original place information as provided by ticketing partners.
10
The unique identifier of the place in the Google Places API.
"ChIJ9dfFtXYmVQ0RXL6FkWtY8lA"
"Accor Arena"
2.123909
42.32981038
"Rue Saint-Jacques"
"Paris"
75005
"France"
Deprecated, look at the ‘averageGrade’ of ‘googlePlace’.
Deprecated, look at the ‘totalGrades’ of ‘googlePlace’.
This is one of the sources of information about the event
45
The lowest price for the event in euros. If it's null, we don't know the price
0
The highest price for the event in euros. If it's null, we don't know the price
200
This attribute is a boolean which is set to ‘true’ when a good deal on this event source is identified during integration (discount, early bird ticket, preferential rate, etc.).
Deprecated, use "commissionPerTicket" and "commissionPerCart" instead.
1
1
1
0.05
The affiliate link to buy tickets.
5
1
For some events, ‘availableDates’ is incomplete, and to indicate that information about the event's availability is missing, we set 'cantRetrieveAvailableDates' to true.
This is the date on which the event became unavailable. Either because all the places have been sold or because there is no more availability.
It's an array of all the categories of the event. Some of these objects are ‘sub-categories’ and others are 'main categories'. For a main category, 'subCategory' is null, while for a sub-category, ‘subCategory’ is not null and ‘mainCategory’ has the same value as the main category.
1
"expo"
If it's null, it's a main category, otherwise it's a sub-category of the main category.
"painting"
"peinture"
"painting"
During integration, we also retrieve all the comments/grades made about the event. ‘AverageGrade’ is simply the average of these ratings.
5
During integration, we also retrieve all the comments/grades made about the event. 'totalGrades' is simply the number of these ratings.
1
10
1000
20
50
5
curl --request POST \
--url https://www.wander-service.fr/api/clients/v2/get/events \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"categories": [
"spectacle"
],
"sources": [
"fnac"
],
"locationFilter": {
"circle": {
"lng": 2.333333,
"lat": 48.866667,
"maxDistance": 500
}
},
"datesFilter": {
"minDate": "2024-09-12T12:00:06.138Z",
"maxDate": "2024-12-12T12:00:06.138Z"
},
"pricesFilter": {
"lowestPrice": 123,
"highestPrice": 200,
"hasKnownPrice": false
},
"limit": 5,
"pageNumber": 1,
"orderBy": "distance",
"orderByDistance": {
"lng": 2.333333,
"lat": 48.866667
},
"getCommentaries": false,
"getPerformers": false
}'
{
"data": [
{
"id": 100000,
"wanderId": 100000,
"wanderLink": "https://wander-app.fr/event/100000-plk-en-concert-accor-arena",
"name": "PLK en concert",
"startDate": "2024-03-03 06:08:23.222 +0100",
"endDate": "2024-03-04 06:08:23.222 +0100",
"hasEndDateNotReliable": true,
"lowestPrice": 0,
"highestPrice": 200,
"description": "Un super concert de PLK à l'accor arena !",
"hasGoodDeal": true,
"image": "<string>",
"imageHeight": 123,
"imageWidth": 123,
"squareImage": "<string>",
"rectangleImage": "<string>",
"webImage": "<string>",
"notAvailableAt": "2024-09-12T12:00:06.138Z",
"cancelledAt": "2024-09-12T12:00:06.138Z",
"createdAt": "2024-09-12T12:00:06.138Z",
"updatedAt": "2024-09-12T12:00:06.138Z",
"googlePlace": {
"id": "ChIJi4rRh5jVEEgRm5kJBs9ZLSY",
"name": "Accor Arena",
"address": "8 Bd de Bercy, 75012 Paris, France",
"lng": 2.3784703,
"lat": 48.8386038,
"averageGrade": 4.4,
"totalGrades": 33620,
"street": "8 Boulevard de Bercy",
"city": "Paris",
"postalCode": 75012,
"country": "FR",
"photoRef": "AdDdOWrRr05l5ZtHh9p6qgAy72UgUAMVDWqI0sRbmbZ8hBWaQH8iVJy0iUz98D6MSGinOIcbvJE_92-N1spK4faWYi99crxOgPMgdF2Ua2XD6Wpg-Abka_7OCnATrn68OqbouJP6Lq5AhkKsCpOQwtizL0RgcTrT0W5M3Ib7S0YLY9hSXp4S",
"website": "https://www.accorarena.com/fr",
"editorialSummary": "<string>",
"periods": [
{
"open": {
"day": 0,
"time": "0900"
},
"close": {
"day": 0,
"time": 1800
}
}
]
},
"place": {
"id": 10,
"googleId": "ChIJ9dfFtXYmVQ0RXL6FkWtY8lA",
"name": "Accor Arena",
"address": {
"lng": 2.123909,
"lat": 42.32981038,
"street": "Rue Saint-Jacques",
"city": "Paris",
"postalCode": 75005,
"country": "France"
},
"image": "<string>",
"squareImage": "<string>",
"rectangleImage": "<string>",
"averageGrade": 123,
"totalGrades": 123
},
"sources": [
{
"id": 45,
"partner": {
"name": "fnac",
"logo": "<string>",
"backColor": "<string>"
},
"startDate": "<string>",
"endDate": "<string>",
"lowestPrice": 0,
"highestPrice": 200,
"isGoodDeal": true,
"commissionFix": 1,
"commissionPerTicket": 1,
"commissionPerCart": 1,
"commissionRate": 0.05,
"link": "<string>",
"isBookable": true,
"availableDates": [
{
"startDate": "<string>",
"endDate": "<string>",
"hasEndDateNotReliable": true,
"hasUnknownAvailability": true
}
],
"averageGrade": 5,
"totalGrades": 1,
"cantRetrieveAvailableDates": true,
"notAvailableAt": "<string>"
}
],
"categories": [
{
"id": 1,
"mainCategory": "expo",
"subCategory": "painting",
"traductionFR": "peinture",
"traductionEN": "painting",
"icon": "<string>"
}
],
"commentaries": [
{
"grade": 5,
"content": "Amazing concert !",
"username": "Wander bot",
"date": "<string>"
}
],
"averageGrade": 5,
"totalGrades": 1,
"trendingScore": 10,
"performers": [
{
"id": 45,
"name": "PLK",
"description": "<string>",
"image": "<string>",
"webImage": "<string>"
}
]
}
],
"pagination": {
"totalItems": 1000,
"totalPages": 20,
"perPage": 50,
"currentPage": 5,
"nextPageParams": {
"pageNumber": 6,
"limit": 50
},
"previousPageParams": {
"pageNumber": 4,
"limit": 50
}
}
}