Documentation API

Toutes les requêtes doivent inclure votre clé API dans le header X-API-Key. Créez et gérez vos clés depuis votre tableau de bord.

curl -X GET "https://sirene-explorer.fr/api/v1/search?q=plomberie" \
  -H "X-API-Key: sk_live_votre_cle_api"

GET/api/v1/search

Recherche dans la Base Sirene avec filtres. Renvoie les entreprises actives (etat_administratif = "A").

# Recherche "plomberie" dans le 75
curl "https://sirene-explorer.fr/api/v1/search?q=plomberie&departement=75&page=1" \
  -H "X-API-Key: sk_live_..."

# Entreprises NAF 4321A (travaux d'installation électrique) créées après 2025
curl "https://sirene-explorer.fr/api/v1/search?naf=4321A&page=1" \
  -H "X-API-Key: sk_live_..."

# Toutes les SAS (cj=5710) avec effectifs 10-19 salariés
curl "https://sirene-explorer.fr/api/v1/search?cj=5710&effectifs=21&page=1" \
  -H "X-API-Key: sk_live_..."

Paramètres

Réponse

Réponse JSON avec les champs hits, totalHits, page, totalPages et processingTimeMs.

{
  "hits": [
    {
      "siren": "123456789",
      "denomination": "DUPONT PLOMBERIE",
      "sigle": null,
      "activite_principale": "4322B",
      "libelle_activite": "Travaux d'installation d'équipements thermiques et de climatisation",
      "categorie_juridique": "5710",
      "libelle_categorie": "Société par actions simplifiée",
      "date_creation": "2024-03-15",
      "etat_administratif": "A",
      "tranche_effectifs": "11",
      "libelle_effectifs": "10 à 19 salariés",
      "code_postal": "75011",
      "commune": "75056",
      "libelle_commune": "PARIS 11",
      "departement": "75"
    }
    // ... 19 autres résultats
  ],
  "totalHits": 1842,
  "page": 1,
  "totalPages": 93,
  "processingTimeMs": 4
}

Le header X-RateLimit-Remainingindique le nombre d'appels restants ce mois.

Codes d'erreur