Documentation API

Introduction

L’API Pôle Sociétés est une API REST qui renvoie du JSON. Toutes les requêtes se font en HTTPS sur l’URL de base ci-dessous. Chaque appel doit être authentifié avec une clé API.

https://api.polesocietes.com/api/v1

Authentification

L’authentification se fait par clé API (préfixe ps_live_). Transmettez-la dans l’en-tête Authorization en Bearer, ou via l’en-tête X-API-Key. La clé n’est affichée qu’une seule fois à sa création : conservez-la en lieu sûr et ne l’exposez jamais côté client.

Authorization: Bearer ps_live_VOTRE_CLE

X-API-Key: ps_live_VOTRE_CLE

Pas encore de clé ? Obtenez une clé gratuite en quelques secondes : 100 appels par mois, sans carte bancaire.

Quotas & limites de débit

L’offre gratuite donne droit à 100 appels par mois calendaire sur la recherche d’entreprises, à raison de 10 requêtes par minute. Les forfaits payants augmentent ces deux limites et ouvrent les autres endpoints. Les réponses exposent l’état de votre quota dans les en-têtes suivants :

Une fois le quota mensuel atteint, l’API répond 429 avec l’erreur quota_exceeded jusqu’au renouvellement. Les appels terminant en erreur (4xx/5xx) ne sont pas décomptés de votre quota.

HTTP/1.1 200 OK
X-Quota-Limit: 5000
X-Quota-Remaining: 4997
X-Quota-Reset: 1783522570

Codes d’erreur

Les erreurs renvoient un code HTTP standard et un corps JSON { "error": "…", "message": "…" }.

Recherche d’entreprises

Recherche des entreprises françaises par raison sociale, SIREN ou SIRET, avec filtres optionnels. Les résultats sont paginés.

Paramètres

curl "https://api.polesocietes.com/api/v1/companies/search?q=la%20poste" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer ps_live_VOTRE_CLE"

{
  "data": [
    {
      "siren": "356000000",
      "siret": "35600000000048",
      "name": "LA POSTE",
      "active_since": "1991-01-01",
      "state": "active",
      "legal_form": {
        "code": "5710",
        "label": "Société par actions simplifiée (SAS)",
        "short": "SAS"
      },
      "ape_code": {
        "code": "53.10Z",
        "label": "Activités de poste dans le cadre d’une obligation de service universel"
      },
      "employees": 150000,
      "share_capital": null,
      "vat_number": "FR39356000000",
      "rcs_number": "356 000 000 RCS PARIS",
      "address": "9 RUE DU COLONEL PIERRE AVIA, 75015 PARIS",
      "location": "PARIS",
      "is_kbis_available": true
    }
  ],
  "links": { "first": "…", "last": "…", "prev": null, "next": "…" },
  "meta": { "current_page": 1, "per_page": 50, "total": 124 }
}

Données financières

Chiffres clés et ratios financiers par exercice (chiffre d’affaires, résultat, EBITDA, marges, délais de paiement…) pour une entreprise, à partir de son SIREN. Répond 404 si aucune donnée n’est disponible.

Paramètres

curl "https://api.polesocietes.com/api/v1/companies/356000000/financials" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer ps_live_VOTRE_CLE"

{
  "data": {
    "siren": "356000000",
    "years": [
      {
        "year": "2023",
        "turnover": 34073000000,
        "profit": 1287000000,
        "EBITDA": 2456000000,
        "gross_margin": 41.2,
        "operating_margin": 7.2,
        "financial_autonomy": 32.5,
        "solvency": 48.1,
        "liquidity": 1.4,
        "client_payment_delay": 38,
        "supplier_payment_delay": 52,
        "total_assets": 51200000000
      }
    ]
  }
}

Tarifs

Commencez gratuitement, puis choisissez l’offre adaptée à votre volume d’appels. Le quota se renouvelle chaque mois.

L’offre gratuite couvre la recherche d’entreprises. Les données financières et le suivi d’entreprises nécessitent un forfait payant.