Données ouvertes & gratuites

L'API ouverte CLAIR

Accédez librement aux données politiques françaises. Députés, sénateurs, scrutins, lobbying, dossiers législatifs. Tout est documenté, structuré et gratuit.

Documentation SwaggerVoir sur data.gouv.fr

Pourquoi une API ouverte ?

Les données politiques sont publiques par nature. Elles proviennent de l'Assemblée nationale, du Sénat, de la HATVP et de la DILA. CLAIR les agrège, les structure et les enrichit pour les rendre réellement exploitables.

Notre API est gratuite, sans authentification et sans limite abusive. Que vous soyez journaliste, chercheur, développeur ou citoyen curieux, ces données vous appartiennent.

CLAIR est désormais référencé sur data.gouv.fr, la plateforme ouverte des données publiques françaises.

9

endpoints principaux

4

sources officielles

0 €

gratuit, sans clé API

Ce que vous pouvez récupérer

Chaque ressource est paginée, filtrable et documentée. Cliquez pour voir l'exemple en direct.

Députés

Fiche, groupe, votes, présence, loyauté, activité de chaque député

/api/v1/deputes

Sénateurs

Données complètes sur les sénateurs : groupe, commission, votes

/api/v1/senateurs

Groupes politiques

Composition, effectifs et votes de chaque groupe parlementaire

/api/v1/groupes

Scrutins

Tous les votes de l'Assemblée et du Sénat, avec le détail par parlementaire

/api/v1/scrutins

Lobbying

Représentants d'intérêts et leurs actions (données HATVP)

/api/v1/lobbying

Dossiers législatifs

Textes de loi, leur parcours parlementaire et les scrutins associés

/api/v1/dossiers

Sujets

Thématiques parlementaires et les dossiers qui s'y rapportent

/api/v1/sujets

Recherche

Recherche plein texte sur l'ensemble des données (Meilisearch)

/api/v1/search

Statistiques

Chiffres clés et statistiques agrégées de l'activité parlementaire

/api/v1/analytics

Prêt en une ligne

Pas de clé API, pas d'inscription. Un simple curl suffit.

Terminal
# Récupérer les 5 derniers scrutins
curl "https://clair-production.up.railway.app/api/v1/scrutins?limit=5&sort=date"

# Chercher un député
curl "https://clair-production.up.railway.app/api/v1/deputes?search=dupont"

# Détail d'un scrutin avec les votes individuels
curl "https://clair-production.up.railway.app/api/v1/scrutins/{id}"

# Données lobbying
curl "https://clair-production.up.railway.app/api/v1/lobbying?limit=10"

Les réponses sont en JSON. Pagination via limit et offset. Consultez la documentation Swagger pour le détail de chaque endpoint.

Conditions d'utilisation

  • Accès libre, sans authentification
  • Rate limiting raisonnable pour garantir la disponibilité
  • Données issues de sources publiques officielles
  • Merci de citer CLAIR si vous réutilisez les données
  • Code source ouvert sur GitHub

Sources des données

  • Assemblée nationale : députés, scrutins, amendements, interventions
  • Sénat : sénateurs, scrutins, dossiers législatifs
  • HATVP : représentants d'intérêts et actions de lobbying
  • DILA : comptes rendus intégraux des débats

Construisons ensemble la transparence

Vous avez un projet qui utilise nos données ? Une idée d'amélioration ? Contribuez au code ou contactez-nous.

Explorer la documentationSoutenir CLAIR