Documentation de l'API : Événements

Base URL : https://api.tild.com/api/events

GET /api/events

Récupère une liste d'événements avec options de filtrage, recherche textuelle, géolocalisation et pagination.

Paramètres de requête (Query Params)

Paramètre Type Description Exemple
limitintegerNombre maximum de résultats (défaut : 100)?limit=20
offsetintegerDécalage de départ des résultats (pagination)?offset=40
venueDepartmentstringFiltrer par département du lieu?venueDepartment=75
venueRegionstringFiltrer par région du lieu?venueRegion=Bretagne
venueZipCodestringFiltrer par code postal du lieu?venueZipCode=35000
eventNamestringRecherche partielle sur le nom de l'événement?eventName=Jazz
latitudefloatLatitude pour filtrer par distance (utilisé avec longitude)?latitude=48.8566
longitudefloatLongitude pour filtrer par distance (utilisé avec latitude)?longitude=2.3522
distancefloatRayon en kilomètres (défaut : 50 km)?distance=10
Exemple : pour trouver des événements dans un rayon de 5 km autour de Rennes.
http://domaine.tld/api/events?latitude=48.083328&longitude=-1.68333&distance=5
dateStartstring (YYYY-MM-DD)Date de début minimale?dateStart=2025-06-01
dateEndstring (YYYY-MM-DD)Date de fin maximale?dateEnd=2025-06-30
categoryNamestringFiltrer par catégorie d'événement?categoryName=Concert

Catégories disponibles

Réponse

Retourne un tableau JSON d'événements triés par date de début décroissante.

[
  {
    "eventId": 11111111,
    "eventDateCreation": "2025-02-26T10:05:07.000Z",
    "eventLastUpdate": "2025-02-27T09:11:23.000Z",
    "eventName": "KLANGPHONICS",
    "eventShortName": null,
    "eventUrl": "https://www.seetickets.com/fr/tg/tour/klangphonics/43344",
    "eventPresentation": "La techno singulière de Klangphonics, mélange d'instruments live et de musique électronique, est de retour à Paris.\nAprès leur rencontre en 2017, Maxl, Ben et Markus redéfinissent peu à peu le son et l'apparence de la musique électronique live. Initialement un groupe live, Klangphonics est en train de devenir un projet où les frontières traditionnelles entre groupe, DJ et producteur s'effacent.\n2024 a marqué le début d'un nouveau chapitre avec la sortie de leur premier album Perfect Opposure. Le single In Between (Memories and Dreams) donne un avant-goût de leur son unique alliant éléments électroniques modernes à une sensibilité d'écriture traditionnelle. Ce morceau ouvre la voie à une nouvelle tonalité musicale, alliant une production pop plus délicate tout en conservant les influences techno et house qui rendent leur prestation live si captivante.\n\nAvec une tournée en tête d'affiche prévue en Europe et pour la première fois en Amérique du Nord début 2025, ainsi qu'un nouveau spectacle audio-visuel soigneusement élaboré, il y a fort à parier que nous entendrons (et verrons) encore beaucoup de ce groupe dans les mois à venir.",
    "eventState": "Vente en cours",
    "venueId": 31,
    "venueName": "La Cigale",
    "venueTown": "Paris",
    "venueAdress": "120, boulevard Rochechouart",
    "venueZipCode": "75018",
    "venueDepartment": "75",
    "venueRegion": "Ile-de-France",
    "venueCodePays": "FR",
    "venueLatitude": 48.8822053,
    "venueLongitude": 2.3401272,
    "venueUrl": "https://www.seetickets.com/fr/venue/la-cigale/9852",
    "dateStart": "2025-05-30T17:30:00.000Z",
    "dateEnd": "2025-05-30T21:55:00.000Z",
    "dateSalesStart": "2025-02-26T11:00:00.000Z",
    "minTarif": 31.2,
    "maxTarif": 31.2,
    "margeMoyenne": 2.7,
    "numberOfDates": 1,
    "categoryName": "Concert",
    "subCategoryName": "Electro",
    "pictureUrl": "https://statics.digitick.com/commun/images/upload/events/47/3b/KLANG1200x1200SQUAREKPADMAT01may30_110.jpg",
    "posterUrl": "https://statics.digitick.com/commun/images/upload/events/8e/b4/aff_KLANG1200x1200SQUAREKPADMAT01may30_640.jpg",
    "keyWords": null,
    "createdAt": "2025-05-28T10:13:51.676Z",
    "updatedAt": "2025-05-28T10:13:51.676Z"
  },
  ...
]