API Tiers-Lieux

Recherche et acces aux donnees des tiers-lieux francais

Cette API expose les fiches des tiers-lieux recenses dans la base nationale, alimentee par Grist et indexee dans Meilisearch pour une recherche rapide et pertinente.

Elle permet de chercher des tiers-lieux par mots-cles, de filtrer par localisation geographique, famille, label, reconnaissance, type de structure, activite, surface, date d'ouverture, et d'acceder a chaque fiche individuellement avec les details des labels et reconnaissances.

Endpoints publics

GET /search

Recherche plein-texte avec filtres combinables.

qTerme de recherche

limitNombre de resultats (1-5000, defaut : 5) optionnel

lat / lng / rayonRecherche geographique (latitude, longitude, rayon en km) optionnel

regionFiltrer par region optionnel

departementFiltrer par departement optionnel

villeFiltrer par ville optionnel

familleFiltrer par famille de tiers-lieu optionnel

labelsFiltrer par label(s), filtre AND optionnel

reconnaissancesFiltrer par reconnaissance(s), filtre AND optionnel

type_structureFiltrer par type de structure gestionnaire optionnel

etat_projetFiltrer par etat du projet optionnel

activiteFiltrer par activite (principales + secondaires) optionnel

ouverture_apresOuvert a partir de cette annee (inclus) optionnel

ouverture_avantOuvert avant cette annee (exclus) optionnel

surface_minSurface totale minimale en m2 optionnel

surface_maxSurface totale maximale en m2 optionnel

GET /search?q=coworking&region=Bretagne&limit=10
GET /search?q=*&lat=48.85&lng=2.35&rayon=20
GET /search?q=fablab&labels=FabLab&labels=Repair+Cafe
GET /search?q=*&type_structure=Association&activite=Mediation+numerique
GET /search?q=*&ouverture_apres=2020&surface_min=100

GET /tiers-lieux/{id}

Fiche complete d'un tiers-lieu. Le parametre {id} accepte l'identifiant numerique ou l'Identifiant_national (UUID public). Inclut les details des labels et reconnaissances (titre, description, URL, logo).

GET /tiers-lieux/3692
GET /tiers-lieux/15ecb291-e759-4cfe-b9b0-55dbf2923640

GET /tiers-lieux/{id}/logo

Logo du tiers-lieu (proxy vers Grist). Accepte l'id numerique ou l'Identifiant_national.

GET /tiers-lieux/{id}/live

Fiche en temps reel depuis Grist, hors cache. Accepte l'id numerique ou l'Identifiant_national.

GET /labels/{id}/logo

Logo d'un label (proxy vers Grist).

GET /reconnaissances/{id}/logo

Logo d'une reconnaissance (proxy vers Grist).

POST /tiers-lieux/{id}/signalement

Signaler un tiers-lieu (ex : potentiellement ferme). Accepte l'id numerique ou l'Identifiant_national. Rate limite a 5/h par IP.

{"motif": "Ce lieu semble ferme definitivement"}

GET /health

Etat du service.

Endpoints proteges

POST /webhook/grist

Webhook appele par Grist lors d'un ajout ou d'une modification dans Tiers_Lieux.

Authorization: Bearer <SYNC_SECRET>

POST /sync

Declenche une reindexation complete en arriere-plan depuis Grist.

Authorization: Bearer <SYNC_SECRET>

Exemple : GET /search?q=raffinerie&limit=1

{
  "query": "raffinerie",
  "limit": 1,
  "processingTimeMs": 1,
  "hits": [
    {
      "id": 3692,
      "Identifiant_national": "15ecb291-e759-4cfe-b9b0-55dbf2923640",
      "nom_tiers_lieu": "La Raffinerie",
      "nom_structure_gestionnaire": " La Raffinerie",
      "adresse_nationale_ville": "Saint-Paul",
      "adresse_nationale_region": "La Reunion",
      "adresse_nationale_dept": "La Reunion",
      "adresse_nationale_cp": "97434",
      "adresse_nationale_autre": "",
      "description_courte": "La Raffinerie est tiers lieu multidisciplinaire...",
      "type_structure_gestionnaire": "Association",
      "site_internet": "https://www.laraffinerie.re/",
      "email_contact_public": "contact@laraffinerie.re",
      "telephone_contact_public": "+262693453393",
      "Derniere_mise_a_jour": 1775729855.159846,
      "adresse_nationale": "Avenue de Bourbon 97434 Saint-Paul",
      "adresse_nationale_lat": -21.065862,
      "adresse_nationale_lon": 55.222177,
      "labels": ["Manufacture de Territoires", "Deffinov"],
      "reconnaissances": ["Reconnu par le reseau regional...", "Adherent de l'ANTL"],
      "etat_du_projet": null,
      "Recensement_2026_statut_lieu": ["en activite"],
      "Recensement_2026_activites_principales": ["Bar / cafe", "Jardinage / Bricolage / Chantier participatif", "..."],
      "Recensement_2026_activites_secondaires": ["Bureau / Coworking", "Mediation numerique / inclusion numerique", "..."],
      "activites_principales": ["Bar / cafe", "Jardinage / Bricolage / Chantier participatif", "..."],
      "activites_secondaires": ["Bureau / Coworking", "Mediation numerique / inclusion numerique", "..."],
      "familles": ["Cafes associatifs", "Fablabs / Makerspaces / ...", "Tiers-lieux culturels / ..."]
    }
  ]
}

Exemple : GET /tiers-lieux/3692

{
  "id": 3692,
  "Identifiant_national": "15ecb291-e759-4cfe-b9b0-55dbf2923640",
  "nom_tiers_lieu": "La Raffinerie",
  "nom_structure_gestionnaire": " La Raffinerie",
  "adresse_nationale_ville": "Saint-Paul",
  "adresse_nationale_region": "La Reunion",
  "adresse_nationale_dept": "La Reunion",
  "adresse_nationale_cp": "97434",
  "adresse_nationale_autre": "",
  "description_courte": "La Raffinerie est tiers lieu multidisciplinaire...",
  "ID_TL": 3944,
  "ID_UNIQUE": "895",
  "date_ouverture": 1561939200,
  "type_structure_gestionnaire": "Association",
  "surface_bati_m2": "200",
  "surface_terrain_m2": "2500",
  "site_internet": "https://www.laraffinerie.re/",
  "email_contact_public": "contact@laraffinerie.re",
  "telephone_contact_public": "+262693453393",
  "DESCRI_LONG": "Notre tiers-lieux est denomme La Raffinerie en hommage a l'ancienne sucrerie...",
  "LIEN_PAGE_FTL": "https://cartographie.francetierslieux.fr/#@laRaffinerie3",
  "type_structure_gestionnaire_autre": "",
  "logo": ["L", 1858],
  "logo_url": "/tiers-lieux/3692/logo",
  "rs_facebook": "https://www.facebook.com/La.Raffinerie.Hermitage",
  "rs_x": "",
  "rs_instagram": "https://www.instagram.com/laraffineriehermitage/",
  "rs_linkedin": "",
  "rs_mastodon": "",
  "rs_movilab": "",
  "lien_osm_google": "https://www.openstreetmap.org/?mlat=-21.072705&mlon=55.223358...",
  "Cree_a": null,
  "Derniere_mise_a_jour": 1775729855.159846,
  "Cree_par": "",
  "Derniere_mise_a_jour_par": "Guillaume Lung Tung",
  "Formulaire_complete": true,
  "adresse_nationale": "Avenue de Bourbon 97434 Saint-Paul",
  "Rejet_de_la_donnee": "",
  "adresse_nationale_lat": -21.065862,
  "adresse_nationale_lon": 55.222177,
  "import_initial": true,
  "labels": ["Manufacture de Territoires", "Deffinov"],
  "reconnaissances": ["Reconnu par le reseau regional de La Reunion...", "Adherent de l'ANTL"],
  "etat_du_projet": null,
  "adresse_nationale_insee": "97415",
  "fiche_valide": true,
  "Recensement_2026_statut_lieu": ["en activite"],
  "Recensement_2026_familles_tiers_lieux": ["Cafes associatifs", "Ressourceries / Recycleries / ...", "..."],
  "Recensement_Avancement": "Termine",
  "Recensement_2026_activites_principales": ["Bar / cafe", "Jardinage / Bricolage / ...", "..."],
  "Recensement_2026_activites_secondaires": ["Bureau / Coworking", "Mediation numerique / ...", "..."],
  "_geo": {"lat": -21.065862, "lng": 55.222177},
  "familles": ["Cafes associatifs", "Ressourceries / Recycleries / ...", "..."],
  "activites_principales": ["Bar / cafe", "Jardinage / Bricolage / ...", "..."],
  "activites_secondaires": ["Bureau / Coworking", "Mediation numerique / ...", "..."],
  "activites": ["Bar / cafe", "Jardinage / Bricolage / ...", "Bureau / Coworking", "..."],
  "surface_totale": 2700.0,
  "labels_details": [
    {
      "id": 2,
      "titre": "Manufacture de Territoires",
      "description": "Les tiers-lieux laureats du programme Manufactures de Proximite...",
      "url": "https://francetierslieux.fr/programme/manufactures-de-proximite/",
      "logo": "/labels/2/logo"
    },
    {"id": 3, "titre": "Deffinov", "description": "...", "url": "...", "logo": "/labels/3/logo"}
  ],
  "reconnaissances_details": [
    {
      "id": 4,
      "titre": "Reconnu par le reseau regional de La Reunion des tiers-lieux",
      "description": "Reseau regional de La Reunion...",
      "url": "https://www.tierslieux.re/",
      "logo": "/reconnaissances/4/logo"
    },
    {"id": 2, "titre": "Adherent de l'ANTL", "description": "...", "url": "...", "logo": "/reconnaissances/2/logo"}
  ]
}