GET /prestataires
Rechercher des prestataires
Identifiant d'opération : searchPrestataires
Les entreprises titulaires de marchés publics (données essentielles de la commande publique). Un prestataire est un SIREN, représenté par son établissement le plus actif : siret et slug sont les siens, nb_etablissements compte les établissements du SIREN. Les fiches non diffusibles sont exclues. Aucun filtre n'est obligatoire : sans q, la liste est triée par nombre de contrats. departement est le département principal d'activité. montant_median est le montant médian des marchés, cpv_principal le code CPV le plus fréquent, liens.fiche la fiche publique du site. Résultats limités à 1000 par recherche (page × per_page ≤ 1000, sinon 400 page_too_deep ; meta.total_exact vaut false au-delà). Jamais gardé en mémoire. taille et cpv_principal valent null quand ils sont inconnus. Le détail d'un prestataire est GET /prestataires/{slug}. Périmètre requis : prestataires:read (403 si la clé ne le porte pas). Quota : réserve per_page enregistrements (1 pour un détail) de la famille general ; 429 quota_exceeded une fois la limite journalière atteinte.
Clé requise, périmètre prestataires:read.
Paramètres
| Nom | Emplacement | Obligatoire | Type | Description |
|---|---|---|---|---|
q | query | non | string | Mots recherchés dans le nom du prestataire (2 à 100 caractères après suppression des espaces de bord). |
departement | query | non | string | Un seul code de département (01 à 95, 2A, 2B, 971 à 978, 986 à 988). C'est le département PRINCIPAL d'activité du prestataire (celui où il a le plus de marchés), pas son siège. |
cpv | query | non | string | Division CPV, exactement 2 chiffres (45 : travaux de bâtiment et de génie civil), appliquée au CPV principal du prestataire. |
taille | query | non | PME, ETI, GE | Taille de l'entreprise : PME, ETI ou GE. |
tri | query | non | pertinence, contrats, montant | pertinence (noms qui commencent par q d'abord, puis nombre de contrats), contrats (nombre de marchés) ou montant (montant médian). pertinence par défaut avec q, contrats sans ; pertinence sans q donne 400. |
page | query | non | string | Numéro de page, à partir de 1 (1 par défaut). page × per_page ne peut pas dépasser 1000. |
per_page | query | non | string | Résultats par page : 20 par défaut, 100 au plus. |
Réponses
| Code | Description |
|---|---|
| 200 | Succès. |
| 400 | invalid_parameter : Paramètre invalide. ; page_too_deep : Page trop profonde : affinez votre recherche. |
| 401 | unauthorized : Clé d'API manquante ou invalide. |
| 403 | forbidden : Accès refusé : compte non Pro ou périmètre de la clé insuffisant. |
| 429 | quota_exceeded : Quota journalier atteint. Il se renouvelle à minuit UTC. ; rate_limited : Trop de requêtes. Réessayez plus tard. |
| 503 | unavailable : Service momentanément indisponible. |
Exemple
curl -H "X-API-Key: pk_live_VOTRE_CLE" "https://publikconnect.fr/api/v1/prestataires"GET /prestataires/{slug}
Fiche d'un prestataire
Identifiant d'opération : getPrestataire
Statistiques publiques d'un titulaire de marchés (données essentielles de la commande publique) et ses derniers marchés (derniers_marches), au plus 20. Mêmes données que la page publique /prestataires/{slug} du site, sans le contenu réservé aux abonnés, plus principaux_acheteurs (10 au plus : SIRET, nom, nombre de contrats, montant total) et contrats_a_echeance (50 au plus, la fin la plus proche d'abord). Ces marchés sont une ESTIMATION : l'acheteur ne publie pas la fin, elle est calculée à partir de la date de notification et de la durée annoncée (fin_estimee = date_notification + duree_mois, estimation toujours true), et seuls ceux dont la fin tombe dans les 12 prochains mois sont rendus. acheteur.siret vaut null quand il n'est pas connu. Deux listes vides si la fiche n'a pas de SIRET ou pas de marché. statistiques vaut null si la fiche n'a pas de SIRET exploitable ; croissance_12m est la variation en pourcentage du montant sur 12 mois, null si elle n'est pas calculable. type vaut revendiquee (entreprise inscrite) ou decp (titulaire connu par les données essentielles de la commande publique). Les fiches non diffusibles répondent 404. Périmètre requis : prestataires:read (403 si la clé ne le porte pas). Quota : réserve per_page enregistrements (1 pour un détail) de la famille general ; 429 quota_exceeded une fois la limite journalière atteinte.
Clé requise, périmètre prestataires:read.
Paramètres
| Nom | Emplacement | Obligatoire | Type | Description |
|---|---|---|---|---|
slug | path | oui | string | Identifiant de la fiche tel qu'il apparaît dans l'adresse /prestataires/{slug} de sa page publique ; il s'obtient aussi dans GET /prestataires. |
Réponses
| Code | Description |
|---|---|
| 200 | Succès. |
| 400 | invalid_parameter : Paramètre invalide. |
| 401 | unauthorized : Clé d'API manquante ou invalide. |
| 403 | forbidden : Accès refusé : compte non Pro ou périmètre de la clé insuffisant. |
| 404 | not_found : Ressource introuvable. |
| 429 | quota_exceeded : Quota journalier atteint. Il se renouvelle à minuit UTC. ; rate_limited : Trop de requêtes. Réessayez plus tard. |
| 503 | unavailable : Service momentanément indisponible. |
Exemple
curl -H "X-API-Key: pk_live_VOTRE_CLE" "https://publikconnect.fr/api/v1/prestataires/VOTRE_SLUG"Demander une clé
Avoir un compte Pro
La clé est réservée aux comptes au plan Pro.
Écrire au support
Nous vérifions votre compte Pro puis vous répondons par e-mail avec votre clé.