API Trucs à faire

Présentation

Plus de 40 000 sorties (brocantes, fêtes, concerts, expos, sport, sorties en famille) et des milliers de lieux à visiter et d’offices de tourisme, partout en France, mis à jour chaque nuit.

Obtenir une clé Essayer sans clé

Démarrage rapide

1. Obtenez une clé. Elle commence par dlc_ et est réglée pour votre usage : sites autorisés, zone, types d’événements.
2. Ajoutez le script avec votre clé dans l’adresse, comme pour Google Maps.
3. Appelez l’API dans la fonction de rappel, ou posez directement un widget.

<div id="agenda"></div>

<script>
  function initTrucs() {
    new TrucsAFaire.Liste("#agenda", {
      autour: { lat: 46.566, lon: 3.333 },  // Moulins
      rayon: 25,                            // en km
      periode: "weekend",
      limite: 6
    });
  }
</script>
<script src="https://VOTRE-SERVEUR/v1/dlc.js?key=VOTRE_CLE&callback=initTrucs" async></script>

<!-- Aucun code à écrire : les réglages se lisent sur l’élément -->
<div data-dlc="liste" data-lat="46.566" data-lon="3.333" data-rayon="25"
     data-periode="weekend" data-limite="6"></div>

<div data-dlc="carte" data-lat="46.566" data-lon="3.333" data-rayon="25"
     style="height:420px"></div>

<script src="https://VOTRE-SERVEUR/v1/dlc.js?key=VOTRE_CLE" async></script>

// Après le chargement du script
await TrucsAFaire.pret;

const { total, resultats } = await TrucsAFaire.sorties({
  dep: "03",
  types: ["brocante", "fete"],
  periode: "semaine"
});

console.log(total + " sorties cette semaine dans l’Allier");
for (const s of resultats) {
  console.log(s.debut, s.titre, s.commune);
}

Clés et restrictions

Chaque appel exige une clé. Comme une clé Google Maps, une clé utilisée dans une page web est visible par les visiteurs : c’est la restriction par site qui la protège. Chaque clé est réglée à sa création :

Pour vérifier les réglages d’une clé : TrucsAFaire.cle() ou GET /v1/cle.

Bibliothèque JavaScript

Charger la bibliothèque

<script src="https://VOTRE-SERVEUR/v1/dlc.js?key=VOTRE_CLE&callback=initTrucs" async></script>

Méthodes

Gérer les erreurs

try {
  const r = await TrucsAFaire.sorties({ commune: "Nevers", dep: "58" });
} catch (e) {
  if (e instanceof TrucsAFaire.Erreur) {
    console.warn(e.code, e.statut, e.message);  // ex. "quota_atteint", 429
  }
}

Widgets

Deux composants prêts à l’emploi, qui suivent la couleur du texte de votre page et s’adaptent à toutes les largeurs.

TrucsAFaire.Liste

TrucsAFaire.Carte

Fond Plan IGN ou photo satellite, points regroupés, fiche au clic. La carte (MapLibre) n’est chargée que si vous l’utilisez.

Options des widgets

Toutes les options de recherche s’appliquent aussi. Pour changer les critères : widget.actualiser({ periode: "mois" }).

API REST

Pour un serveur, une application mobile ou une borne : des requêtes GET qui renvoient du JSON.

Clé dans l’en-tête X-API-Key (recommandé côté serveur) ou dans le paramètre key.

curl -H "X-API-Key: VOTRE_CLE" \
  "https://VOTRE-SERVEUR/v1/sorties?lat=46.566&lon=3.333&rayon=25&type=brocante&tri=distance"

const url = new URL("https://VOTRE-SERVEUR/v1/sorties");
url.search = new URLSearchParams({ dep: "03", type: "brocante,fete", limite: 20 });

const r = await fetch(url, { headers: { "X-API-Key": process.env.DLC_CLE } });
const { total, resultats } = await r.json();

<?php
$url = "https://VOTRE-SERVEUR/v1/sorties?" . http_build_query([
  "dep" => "03", "type" => "brocante,fete", "limite" => 20,
]);
$ctx = stream_context_create(["http" => ["header" => "X-API-Key: " . getenv("DLC_CLE")]]);
$data = json_decode(file_get_contents($url, false, $ctx), true);

foreach ($data["resultats"] as $s) {
  echo $s["debut"] . " · " . $s["titre"] . " · " . $s["commune"] . "\n";
}

import os, requests

r = requests.get(
    "https://VOTRE-SERVEUR/v1/sorties",
    params={"dep": "03", "type": "brocante,fete", "limite": 20},
    headers={"X-API-Key": os.environ["DLC_CLE"]},
    timeout=10,
)
r.raise_for_status()
for s in r.json()["resultats"]:
    print(s["debut"], s["titre"], s["commune"])

Réponse

{
  "total": 37,
  "page": 1,
  "limite": 20,
  "du": "2026-10-14",
  "au": "9999-12-31",
  "resultats": [
    {
      "id": "dt-3f9a…",
      "titre": "Vide-greniers d’automne",
      "type": "brocante",
      "debut": "2026-10-18",
      "fin": "2026-10-18",
      "heure": "07:00",
      "commune": "Yzeure",
      "departement": "03",
      "latitude": 46.565,
      "longitude": 3.356,
      "distance_km": 1.8,
      "gratuit": true,
      "lien": "https://…",
      "billetterie": "https://…",
      "source": "DATAtourisme"
    }
  ],
  "licence": "Données agrégées par Trucs à faire…"
}

Paramètres

Mêmes noms dans la bibliothèque (objet d’options) et dans l’API REST (paramètres d’adresse), sauf mention.

Objets renvoyés

Chaque réponse contient total, page, limite, resultats et licence.

Sortie

Lieu

Erreurs et quotas

Chaque réponse porte l’en-tête X-Quota-Restant. Les réponses sont mises en cache 10 minutes : inutile d’appeler plus souvent.

Essayer l’API

Composez une requête et lancez-la. Sans clé, la console interroge les données publiques en mode démonstration, avec le même format de réponse.

Conditions

• Données mises à jour chaque nuit ; les horaires des lieux viennent d’OpenStreetMap (ODbL).
• Affichez « Trucs à faire » et la source de chaque fiche (les widgets le font pour vous). Les données restent sous la licence de leurs producteurs : voir les mentions légales.
• Une clé peut être suspendue en cas d’usage abusif ou de revente des données.
• Questions, demande de clé ou de quota plus élevé : clementer@gmail.com.