Get events catalogue

POST

get

catalogue

curl --request POST \
  --url https://www.wander-service.fr/api/clients/v2/get/catalogue \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "locationFilter": {
    "circle": {
      "lng": 2.333333,
      "lat": 48.866667,
      "maxDistance": 5000
    }
  },
  "lastUpdatedAt": "2024-10-10T12:00:06.138Z",
  "trackAvailabilities": false,
  "limit": 5,
  "pageNumber": 1
}'

{
  "data": {
    "events": [
      {
        "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>"
          }
        ]
      }
    ],
    "eventIdsCancelled": [
      123
    ],
    "eventIdsNotAvailable": [
      123
    ],
    "eventIdsPassed": [
      123
    ],
    "eventIdsDeleted": [
      123
    ]
  },
  "pagination": {
    "totalItems": 1000,
    "totalPages": 20,
    "perPage": 50,
    "currentPage": 5,
    "nextPageParams": {
      "pageNumber": 6,
      "limit": 50
    },
    "previousPageParams": {
      "pageNumber": 4,
      "limit": 50
    }
  }
}

Authorizations

Authorization

string

header

required

It is the "access_token" returned after login

Body

application/json

locationFilter

object

You can define a location filter corresponding to a circle or a rectangle.

lastUpdatedAt

string

You can only get the events updated after this date. Use it to keep your own database up to date.

Example:

"2024-10-10T12:00:06.138Z"

trackAvailabilities

boolean

Set it to true if you want to retrieve events whose availabilities have been modified.

Example:

false

limit

number

Required range: 1 <= x <= 500

Example:

5

pageNumber

number

Example:

1

Response

201

application/json

Successful operation

data

object

data.events

object[]

data.events.id

integer

Example:

100000

data.events.wanderId

integer

Example:

100000

data.events.wanderLink

string

Link to the event in the Wander app

Example:

"https://wander-app.fr/event/100000-plk-en-concert-accor-arena"

data.events.name

string

Example:

"PLK en concert"

data.events.startDate

string

Example:

"2024-03-03 06:08:23.222 +0100"

data.events.endDate

string

Example:

"2024-03-04 06:08:23.222 +0100"

data.events.hasEndDateNotReliable

boolean

data.events.lowestPrice

number | null

The lowest price for the event in euros. If it's null, we don't know the price.

Example:

0

data.events.highestPrice

number | null

The highest price for the event in euros. If it's null, we don't know the price.

Example:

200

data.events.description

string

Example:

"Un super concert de PLK à l'accor arena !"

data.events.hasGoodDeal

boolean

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.

data.events.image

string | null

data.events.imageHeight

number | null

data.events.imageWidth

number | null

data.events.squareImage

string | null

data.events.rectangleImage

string | null

data.events.webImage

string | null

This is the image compressed.

data.events.notAvailableAt

string | null

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.

Example:

"2024-09-12T12:00:06.138Z"

data.events.cancelledAt

string | null

This is the date on which the event was cancelled.

Example:

"2024-09-12T12:00:06.138Z"

data.events.createdAt

string

Example:

"2024-09-12T12:00:06.138Z"

data.events.updatedAt

string

Example:

"2024-09-12T12:00:06.138Z"

data.events.googlePlace

object | null

Contains enriched place information retrieved from the Google Places API.

data.events.place

object

Represents the original place information as provided by ticketing partners.

data.events.sources

object[]

This is one of the sources of information about the event

data.events.sources.id

integer

Example:

45

data.events.sources.partner

object

data.events.sources.startDate

string

data.events.sources.endDate

string

data.events.sources.lowestPrice

number | null

The lowest price for the event in euros. If it's null, we don't know the price

Example:

0

data.events.sources.highestPrice

number | null

The highest price for the event in euros. If it's null, we don't know the price

Example:

200

data.events.sources.isGoodDeal

boolean

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.).

data.events.sources.commissionFix

number

Deprecated, use "commissionPerTicket" and "commissionPerCart" instead.

Example:

1

data.events.sources.commissionPerTicket

number

Example:

1

data.events.sources.commissionPerCart

number

Example:

1

data.events.sources.commissionRate

number

Example:

0.05

data.events.sources.link

string

The affiliate link to buy tickets.

data.events.sources.isBookable

boolean

data.events.sources.availableDates

object[]

This corresponds to all the dates available for this event and for this particular source.

data.events.sources.averageGrade

number | null

Example:

5

data.events.sources.totalGrades

number

Example:

1

data.events.sources.cantRetrieveAvailableDates

boolean

For some events, ‘availableDates’ is incomplete, and to indicate that information about the event's availability is missing, we set 'cantRetrieveAvailableDates' to true.

data.events.sources.notAvailableAt

string | null

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.

data.events.categories

object[]

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.

data.events.commentaries

object[]

During integration, we retrieve all the comments/grades made about the event.

data.events.averageGrade

number | null

During integration, we also retrieve all the comments/grades made about the event. ‘AverageGrade’ is simply the average of these ratings.

Example:

5

data.events.totalGrades

number

During integration, we also retrieve all the comments/grades made about the event. 'totalGrades' is simply the number of these ratings.

Example:

1

Example:

10

data.events.performers

object[]

data.eventIdsCancelled

number[]

It's the event ids of events cancelled between "getEventsUpdatedAfterDate" and now.

data.eventIdsNotAvailable

number[]

It's the event ids of the events made unavailable between "getEventsUpdatedAfterDate" and now.

data.eventIdsPassed

number[]

It's the event ids of events whose end date has passed between "getEventsUpdatedAfterDate" and now.

data.eventIdsDeleted

number[]

It's the event ids of the events deleted between "getEventsUpdatedAfterDate" and now.

pagination

object

Was this page helpful?

Search performer events Get clicks

curl --request POST \
  --url https://www.wander-service.fr/api/clients/v2/get/catalogue \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "locationFilter": {
    "circle": {
      "lng": 2.333333,
      "lat": 48.866667,
      "maxDistance": 5000
    }
  },
  "lastUpdatedAt": "2024-10-10T12:00:06.138Z",
  "trackAvailabilities": false,
  "limit": 5,
  "pageNumber": 1
}'

{
  "data": {
    "events": [
      {
        "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>"
          }
        ]
      }
    ],
    "eventIdsCancelled": [
      123
    ],
    "eventIdsNotAvailable": [
      123
    ],
    "eventIdsPassed": [
      123
    ],
    "eventIdsDeleted": [
      123
    ]
  },
  "pagination": {
    "totalItems": 1000,
    "totalPages": 20,
    "perPage": 50,
    "currentPage": 5,
    "nextPageParams": {
      "pageNumber": 6,
      "limit": 50
    },
    "previousPageParams": {
      "pageNumber": 4,
      "limit": 50
    }
  }
}

API Documentation

Clients' login

Direct Event Data Serving

Event Data Fetching and Storage

Client Data

Get events catalogue

Authorizations

Body

Response