API Propecto

L'API donne un accès en lecture seule aux données publiques agrégées par Propecto : sociétés (France et Belgique), dirigeants, comptes déposés, documents officiels, marchés publics, aides et marques. Elle ne crée, ne modifie et ne supprime rien, et ne renvoie aucune date ni année de naissance de dirigeant.

Obtenir une clé → — depuis votre espace Compte, section « API et MCP ». Sans compte, la page vous propose de vous connecter.

Authentification

Chaque appel présente une clé d'API (préfixe ppo_) dans l'en-tête :

curl -H "x-api-cle: ppo_votre_cle" https://api.propecto.eu/v1/moi

La même clé est acceptée en Authorization: Bearer ppo_votre_cle. La valeur en clair n'est affichée qu'une fois, à la création : Propecto n'en conserve que l'empreinte.

Quota journalier par clé

Le quota est remis à zéro chaque jour à minuit UTC. Chaque appel coûte une unité, sauf POST /societes/lot (une unité par identifiant valide et distinct). Les en-têtes X-Quota-Jour et X-Quota-Restant accompagnent chaque réponse ; au-delà du quota, l'API répond 429.

Badges d'une société (nouveau, v1.3)

GET /societes/{identifiant}/badges rend les badges en coursd'une société (certifications, labels, agréments, enregistrements officiels, marchés publics) : code, libelle, categorie, preuve(verifie ou declare), source, url_verification, since, valid_until et computed_at. Lecture du cache calculé par Propecto, sans appel tiers ; un badge échu n'est jamais rendu ; une société cessée n'a aucun badge. Une unité par appel, mêmes erreurs que les autres routes.

curl -H "x-api-cle: ppo_votre_cle" https://api.propecto.eu/v1/societes/483199576/badges

Les mêmes badges s'affichent sur le site d'une entreprise avec le widget « Vérifié par Propecto ».

Documents officiels (nouveau, v1.2)

Les pièces officielles que Propecto conserve sur ses propres serveurs sont listées et téléchargeables par l'API : comptes annuels et actes des sociétés, avis et pièces des marchés publics, documents des marques et des aides. Chaque pièce porte sa date de mise à jour et son lien de consultation.

• GET /documents?siren=… (ou numero_entreprise + pays, marche_id, marque, aide_id), filtres type_doc et millesime
• GET /documents/{id} : métadonnées et texte extrait (OCR des pièces anciennes) quand il existe
• GET /documents/{id}/fichier : le fichier, par une adresse signée valable dix minutes
• GET /marches/{id}/documents : avis, dossier de consultation, annexes, questions-réponses quand ils sont connus

Quand la licence de la source n'autorise que le lien, ou que l'éditeur n'a pas encore donné son accord, l'API le dit (409, statut lien_seul) et rend le lien officiel, sans rien décompter du quota mensuel. Les comptes déposés sous déclaration de confidentialité et les pièces des entrepreneurs individuels ne sont jamais servis ; dans le texte extrait, dates de naissance, domiciles, adresses électroniques et numéros de téléphone sont masqués.

Documents et marchés inclus dans l'abonnement

En plus du quota journalier de la clé, chaque offre inclut un quota mensuelde documents et de marchés, partagé par les clés d'un même compte. Une unité correspond à un appel (liste, détail ou fichier remis).

Offre équipe (3 membres) : quotas × 3. Le compteur repart de zéro le premier jour de chaque mois (UTC). Les en-têtes X-Quota-Mois, X-Quota-Mois-Restant et X-Quota-Mois-Remise accompagnent chaque réponse concernée, et GET /moi donne l'état complet. Au-delà, l'API répond 429 avec le motif, la date de remise à zéro et l'en-tête Retry-After.

Spécification

• OpenAPI 3.0.3 : /api/openapi.json
• Swagger 2.0 (connecteur personnalisé Power Platform) : /api/openapi-v2.json
• Adresse de base : https://api.propecto.eu/v1
• Pour un assistant conversationnel (Claude, ChatGPT…) : le connecteur IA (MCP).
• Les outils où brancher ces données : connecteurs et intégrations.