Développeurs
Branchez vos outils sur les données de Clarion.
Une API en lecture seule et un serveur MCP, sans clé pour commencer.
Commencez par une requête.
Les appels sans clé fonctionnent depuis n’importe quel site et sont mis en cache en périphérie pendant une heure.
curl "https://app.withclarion.com/api/v1/bills?jurisdiction=ca-on&q=housing"{
"count": 2,
"bills": [
{
"slug": "ca-on-bill-64",
"number": "Bill 64",
"titleEn": "Housing Equity and Rental Transparency Act, 2025",
"jurisdictionCode": "ca-on",
"status": "First Reading Ordered for Second Reading",
"lastEventAt": "2025-10-28"
},
{
"slug": "ca-on-bill-28",
"number": "Bill 28",
"titleEn": "Homelessness Ends with Housing Act, 2025",
"jurisdictionCode": "ca-on",
"status": "Second Reading Vote",
"lastEventAt": "2025-10-23"
}
]
}Réponse abrégée. La réponse complète contient aussi titleFr, jurisdictionNameEn, jurisdictionNameFr et level.
Sept points d’accès en lecture seule.
Projets de loi, juridictions, responsables publics et calendrier, en JSON simple.
- GET/api/v1/calendar
- Réunions de comités, échéances de consultation, dates de clôture des appels d’offres et du financement, et jours de séance, du plus proche au plus lointain.
- GET/api/v1/bills
- Les projets de loi fédéraux, provinciaux et territoriaux suivis, les plus récemment actifs en premier. Filtrez avec les paramètres jurisdiction, status et q.
- GET/api/v1/bills/{slug}
- Un projet de loi : ses étapes dans le temps et sa perspective d’adoption.
- GET/api/v1/jurisdictions
- Les juridictions qui ont des projets de loi suivis, avec leur nombre.
- GET/api/v1/jurisdictions/{code}
- Le nombre de projets de loi d’une juridiction et ses projets de loi les plus récents.
- GET/api/v1/people
- Les responsables publics suivis, élus ou nommés.
- GET/api/v1/people/{id}
- Un responsable public : fonction, parti, juridiction, coordonnées, et ses projets de loi, interventions et rencontres récents.
Clés API
Le forfait Firm inclut des clés API.
Créez jusqu’à 5 clés dans Paramètres, sous Clés API ; chacune sert à l’API comme au serveur MCP.
curl https://app.withclarion.com/api/v1/bills \
-H "Authorization: Bearer clr_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"Chaque clé a droit à 10 000 requêtes par jour, remises à zéro à minuit UTC. Au-delà, vous recevez une réponse 429 avec un en-tête Retry-After. Les réponses avec clé portent l’en-tête X-RateLimit-Remaining.
Ce qu’une clé ajoute
- Trois listes passent à 200 lignes : les étapes d’un projet de loi (au lieu de 20), les projets de loi récents d’une juridiction (au lieu de 25) et les interventions d’un responsable public (au lieu de 10).
- Les réponses avec clé contournent le cache partagé et lisent la base de données à chaque appel.
- Les noms de champs et les filtres restent les mêmes. Une clé change la quantité de données et leur récence, jamais leur forme.
Serveur MCP
Les mêmes données, en trois outils MCP.
Pointez n’importe quel client MCP vers un seul point d’accès sans état, avec votre clé si vous en avez une.
{
"mcpServers": {
"clarion": {
"url": "https://app.withclarion.com/api/mcp",
"headers": {
"Authorization": "Bearer clr_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}Le bloc headers est facultatif. Sans lui, le serveur répond sans clé.
Outils
upcoming_calendar
Aucun argument. Les mêmes données que GET /api/v1/calendar.
search_bills(jurisdiction?, status?, q?)
GET /api/v1/bills avec les trois mêmes filtres.
get_passage_outlook(slug)
Seulement la perspective, avec sa tranche et ses raisons, tirée de GET /api/v1/bills/{slug}.
Point d’accèsPOST https://app.withclarion.com/api/mcp
Ce qui n’est pas dans l’API
L’analyse reste dans l’application.
L’API sert ce qui est déjà public : le statut et les étapes des projets de loi, le calendrier des séances, la liste des responsables publics et la même perspective d’adoption que sur les fiches des projets de loi. La dynamique des dossiers, les changements d’accès, les cartes de positions et les regroupements de co-lobbyisme viennent de la lecture de ces dossiers à la lumière de vos dossiers clients, alors ils restent dans Clarion.
Questions fréquentes
- Faut-il une clé pour commencer ?
- Non. Les points d’accès /api/v1 et le serveur MCP répondent tous deux sans en-tête Authorization. Les réponses de l’API sans clé sont mises en cache en périphérie pendant une heure.
- Que se passe-t-il si une clé dépasse sa limite ?
- Vous recevez une réponse 429 avec un en-tête Retry-After qui compte jusqu’à minuit UTC, et le même corps d’erreur JSON à chaque fois. Aucune requête n’est rejetée sans réponse.
- La version v1 va-t-elle changer ?
- Non. La v1 est stable. Un changement incompatible sortirait dans une nouvelle version, jamais dans la v1.
- Existe-t-il une bibliothèque cliente ?
- Non. C’est du JSON sur HTTP et un serveur MCP standard, alors le client HTTP ou MCP que vous utilisez déjà fonctionne.
Les clés API viennent avec le forfait Firm.
Firm coûte 1 200 $ par mois en dollars canadiens, jusqu’à quinze personnes.