API : coordonnées d’entreprise par SIRET

Appel

GET /api/v1/entreprise?q=… où q est un SIRET (14 chiffres), un SIREN (9 chiffres) ou un nom. Avec un nom, la réponse est la liste des entreprises correspondantes ("type": "liste") ; avec un numéro, la fiche complète ("type": "fiche"). La clé se passe dans l’en-tête Authorization: Bearer (ou X-API-Key).

curl "https://www.adminclic.fr/api/v1/entreprise?q=93003010100024" \
  -H "Authorization: Bearer VOTRE_CLÉ"

const res = await fetch("https://www.adminclic.fr/api/v1/entreprise?q=93003010100024", {
  headers: { Authorization: "Bearer VOTRE_CLÉ" },
});
const fiche = await res.json();
// Les e-mails les plus fiables d'abord :
const meilleur = fiche.emails.find((e) => e.score >= 85);

Une fiche complète prend 2 à 25 secondes : prévoyez un délai d’attente d’au moins 30 secondes.

Réponse (extrait)

{
  "type": "fiche",
  "entreprise": {
    "siren": "930030101",
    "siret": "93003010100024",
    "nom": "AS REPARATION",
    "adresse": "65 RUE DE LA GOUTTE D'OR 75018 PARIS",
    "active": true,
    "naf": "47.42Z",
    "dirigeants": [{ "nom": "…", "prenoms": "…", "qualite": "Président de SAS" }]
  },
  "site": {
    "url": "https://www.as-reparation.fr/",
    "status": "verifie",
    "proofUrl": "https://www.as-reparation.fr/mentions-legales"
  },
  "emails": [{
    "email": "infoasreparation@gmail.com",
    "type": "messagerie_perso",
    "score": 98,
    "mx": true,
    "reasons": ["Publié sur le site officiel de l’entreprise (SIREN vérifié sur le site)", "…"],
    "sources": [{ "kind": "site_officiel", "label": "Site officiel · Mentions légales",
                  "url": "https://www.as-reparation.fr/mentions-legales", "nearSiren": true }]
  }],
  "telephones": [{ "number": "01 42 51 23 28", "type": "fixe", "score": 95, "sources": ["…"] }],
  "domainesMail": [{ "domain": "gmail.com", "mx": true, "spf": true, "dmarc": true }],
  "quota": { "limite": 100, "restant": 99, "periode": "mois" }
}

• • site.status : verifie (SIREN lu sur le site) ou probable.
• • score : 0 à 98, jamais 100. Le détail est dans reasons.
• • type d’e-mail : generique, nominatif ou messagerie_perso.
• • mx : le domaine peut recevoir des e-mails (ne prouve pas qu’une boîte précise existe).

Codes d’erreur