API publique

L'API publique de PublikConnect est en version bêta. Elle est ouverte en production aux comptes Pro, avec une clé d'API que l'équipe PublikConnect émet sur demande (voir Obtenir une clé).

Pour aller plus loin :

• le guide de première synchronisation des avis ;
• le journal des changements, qui décrit aussi la règle de dépréciation (préavis de 90 jours) ;
• la collection d'exemples Postman, qui attend deux variables : base_url et api_key.

À quoi sert l'API

L'API donne accès, en lecture seule et en JSON, aux données suivantes :

• les avis de marché : la liste des avis de toutes les sources servies (/avis, 18 sources), et le fil d'opportunités qui correspond au profil du compte (/opportunites) ;
• les prestataires : la recherche des titulaires de marchés (/prestataires) et leur fiche (/prestataires/{slug}) : statistiques publiques, derniers marchés, principaux acheteurs et marchés qui arrivent à échéance ;
• les acheteurs : la fiche d'un acheteur public à partir de son SIRET (/acheteurs/{siret}) : identité, statistiques de son historique de marchés, principaux titulaires et avis ouverts ;
• les avis d'attribution (/attributions) tels que les sources les publient, et les contrats DECP (/contrats) : qui a signé quoi, avec quel acheteur, pour quel montant ;
• les départements : la liste complète et le nombre d'avis ouverts dans chacun ;
• les sources d'avis : le registre (licence, mention, état) avec, pour chacune, ses avis ouverts, sa dernière ingestion et sa complétude moyenne (/sources) ;
• le compte de la clé : son plan et son quota du jour (/moi) ;
• l'état de santé de l'API, sans clé (/sante).

Elle sert à brancher PublikConnect à un outil interne (tableur, CRM, veille) ou à un agent d'IA. Pour un agent d'IA, le serveur MCP est plus direct : il utilise la même clé et les mêmes données.

Le document OpenAPI 3.1 de l'API est servi sans clé à /api/v1/openapi.json. Il est généré à partir de la définition des routes de l'API et fait foi pour les paramètres et les formats de réponse. Chaque route (paramètres, réponses, comportement) est décrite dans la référence de l'API, générée depuis ce document ; les réponses JSON d'exemple et les tableaux de champs sont dans les exemples de réponses.

URL de base

L'adresse de base de l'API est https://publikconnect.fr/api/v1. Toutes les routes décrites dans cette documentation s'appellent à partir de cette adresse, et les exemples l'utilisent.

Statut bêta

Le contrat de l'API est en bêta : des champs peuvent être ajoutés sans préavis, mais aucun champ n'est renommé ni retiré dans /api/v1. Votre client doit donc ignorer les champs qu'il ne connaît pas. Un changement incompatible passerait par une nouvelle version d'adresse (/api/v2). Les limites de débit, les plafonds et les messages d'erreur peuvent être ajustés après les premiers usages : ces ajustements sont annoncés dans le journal des changements.