API Light v1

L'API complète des données
d'entreprises françaises

Identité, INPI, dirigeants, bénéficiaires effectifs, finances, aides publiques, conformité, documents PDF. Tout en un seul appel.

curl
# Toutes les données d'une entreprise en un appel
curl https://light.struk.tech/api/v1/entreprise/952418325

# Uniquement identité + dirigeants (plus rapide)
curl https://light.struk.tech/api/v1/entreprise/952418325?sections=identite,dirigeants

# Recherche multi-critères
curl https://light.struk.tech/api/v1/recherche?q=mistral+ai&per_page=5

Tout ce que l'API retourne

Un seul endpoint pour récupérer l'intégralité des données d'une entreprise. Choisissez les sections dont vous avez besoin.

Identité

  • SIREN / SIRET / TVA / LEI
  • Forme juridique, date création
  • Capital social, devise
  • Code NAF, objet social
  • Effectif, catégorie
  • Labels (ESS, Qualiopi, RGE, Bio...)
sections=identite

Dirigeants

  • Nom, prénom, qualité
  • Personnes physiques & morales
  • SIREN de la personne morale
  • Historique via INPI
sections=dirigeants

INPI (RNE)

  • Bénéficiaires effectifs
  • Tous les établissements
  • Représentants légaux
  • Détention %, droits de vote
sections=inpi

Finances

  • CA, résultat net, EBE, EBIT
  • Marges, CAF, liquidité
  • Taux d'endettement, BFR
  • Historique multi-années
sections=finances

Aides publiques

  • Aides nationales (de minimis)
  • Aides européennes (TAM, > 500k€)
  • Montants, dates, autorités
  • Totaux agrégés
sections=aides

Conformité

  • Procédures collectives (BODACC)
  • Sanctions / registre des gels
  • Drapeau d'alerte global
  • Détails par procédure
sections=conformite

Documents PDF

  • Statuts, PV d'AG, fusions
  • Comptes annuels, bilans
  • Téléchargement direct (PDF)
  • Extraction réseau (SIREN cités)
sections=documents

Réseau

  • Entreprises citées dans les actes
  • Filiales, associés, partenaires
  • Nombre de citations
  • Documents sources
/api/cited-companies/{siren}

Comment ça fonctionne

Light agrège 8 sources de données officielles. Le token INPI est géré côté serveur — vous n'avez rien à configurer.

INSEE
recherche-entreprises.api.gouv.fr Identité, siège, NAF, effectif, dirigeants, labels — Cache 24h
INPI
API INPI (RNE) — Token géré par Light Capital, objet social, bénéficiaires effectifs, établissements, documents — Cache 7j
DGFiP
data.economie.gouv.fr Ratios financiers (CA, résultat, EBE, marges, endettement, BFR) — Cache 30j
EU
Commission européenne (TAM) Aides d'État > 500 000 € (GBER, recherche, régional) — Cache 30j
DILA
BODACC (bodacc-datadila.opendatasoft.com) Procédures collectives, liquidations, sauvegardes — Cache 24h
DG Trésor
Registre national des gels Sanctions, gel d'avoirs (personnes morales) — Cache mémoire 24h
Minimis
Registre des aides de minimis Aides publiques nationales (subventions, avances, garanties) — Cache 7j
GLEIF
Global LEI Foundation Legal Entity Identifier (LEI) — Identifiant international
À propos du token INPI

L'API INPI nécessite un couple identifiant/mot de passe pour obtenir un token JWT (valide 55 min). Light gère ce cycle automatiquement côté serveur. Quand vous appelez /api/v1/entreprise/{siren}?sections=inpi ou /api/inpi/company/{siren}, le token est renouvelé automatiquement. Vous n'avez pas besoin de vos propres identifiants INPI.

Testez l'API en direct

Envoyez une vraie requête et visualisez la réponse JSON complète.

GET /api/v1/entreprise/{siren}

URL /api/v1/entreprise/952418325?sections=identite,dirigeants
Exemples :
Réponse
Cliquez sur « Envoyer la requête » pour voir la réponse de l'API

Authentification & limites

L'API est ouverte sans clé, avec une limite de 100 requêtes/jour. Pour un usage intensif, demandez une clé API.

Sans clé API Par défaut
100 req/jour
  • Aucune inscription requise
  • Tous les endpoints accessibles
  • Limitation par adresse IP
  • Idéal pour tester et prototyper
curl /api/v1/entreprise/952418325
Avec clé API Sur demande
10 000 req/jour
  • Connectez-vous pour générer une clé
  • Activation manuelle par l'admin
  • Pas de limitation IP
  • Pour intégrations CRM, prod, bulk
curl /api/v1/entreprise/952418325?api_token=lk_...

ou Authorization: Bearer lk_...

Headers de réponse

X-RateLimit-LimitQuota total (100 ou 10000)
X-RateLimit-RemainingRequêtes restantes
X-RateLimit-Authenticatedtrue si clé API valide

Référence des endpoints

6 endpoints pour couvrir tous les besoins : fiche complète, recherche, INPI, documents et réseau.

Cas d'usage

Exemples concrets d'intégration avec du code prêt à copier-coller.

Enrichissement CRM

Tapez un SIREN, récupérez forme juridique, effectif, CA, dirigeants, capital social. Pré-remplissez vos fiches clients automatiquement.

JavaScript
// Enrichir un contact CRM
const res = await fetch(
  '/api/v1/entreprise/952418325?sections=identite,dirigeants'
);
const data = await res.json();

crm.updateContact({
  company: data.identite.nom,
  legal_form: data.identite.forme_juridique,
  revenue: data.identite.chiffre_affaires,
  employees: data.identite.effectif,
  ceo: data.dirigeants[0]?.prenom + ' ' + data.dirigeants[0]?.nom,
  vat: data.identite.tva_intracommunautaire
});

Scoring & conformité

Vérifiez en temps réel les procédures collectives, sanctions, aides reçues. Automatisez votre KYB (Know Your Business).

JavaScript
// Vérifier la conformité d'un fournisseur
const res = await fetch(
  '/api/v1/entreprise/443061841?sections=conformite,aides'
);
const { conformite, aides } = await res.json();

if (conformite.alerte) {
  console.warn('⚠️ Alertes détectées :');
  if (conformite.sanctions_gel)
    console.warn('  → Registre des gels DG Trésor');
  if (conformite.nb_procedures > 0)
    console.warn(`  → ${conformite.nb_procedures} procédure(s) collective(s)`);
}

console.log('Aides EU reçues :', aides.total_europeen_eur, '€');

Téléchargement de documents

Récupérez tous les documents officiels : statuts, PV d'AG, comptes annuels, bilans. Archivez-les automatiquement.

JavaScript
// Télécharger tous les bilans d'une entreprise
const docs = await fetch('/api/inpi/attachments/952418325');
const documents = await docs.json();

const bilans = documents.filter(d => d.type === 'bilan');

for (const bilan of bilans) {
  const pdf = await fetch(
    `/api/inpi/download/bilans/${bilan.id}`
  );
  const buffer = await pdf.arrayBuffer();

  // Sauvegarder le PDF
  fs.writeFileSync(
    `./bilans/${bilan.date_cloture}_${bilan.nom}.pdf`,
    Buffer.from(buffer)
  );
}

Analyse financière

Accédez à l'historique complet des ratios financiers : CA, résultat, EBE, taux d'endettement, BFR, liquidité.

JavaScript
// Analyser l'évolution financière
const res = await fetch(
  '/api/v1/entreprise/952418325?sections=finances'
);
const { finances } = await res.json();

finances.ratios.forEach(year => {
  console.log(`📊 ${year.date_cloture}`);
  console.log(`   CA: ${(year.chiffre_affaires / 1e6).toFixed(1)}M€`);
  console.log(`   Résultat: ${(year.resultat_net / 1e6).toFixed(1)}M€`);
  console.log(`   Marge EBE: ${(year.marge_ebe * 100).toFixed(1)}%`);
  console.log(`   Endettement: ${(year.taux_endettement * 100).toFixed(0)}%`);
});

Prêt à intégrer ?

100 requêtes/jour sans inscription. Clé API sur demande pour un usage intensif.