B2B · Intégration

Documentation API B2B

L’API Nogogo permet de récupérer des données de fiabilité, des signaux légaux, des éléments de dirigeance et des enrichissements entreprise selon le plan souscrit. L’analyse fournie reste indicative et fondée sur des données publiques.

Voir les offres CGV API Licence API

Accès rapide

Base URL: https://nogogo.fr/api/v1
Authentification: x-api-key

Connexion

Base URL et authentification

Toutes les routes B2B sont exposées sous la base suivante :

Base URL

https://nogogo.fr/api/v1

L’authentification se fait par clé API dans l’en-tête x-api-key. Chaque appel consomme une ou plusieurs unités API selon l’endpoint utilisé.

Authentification

curl -X GET "https://nogogo.fr/api/v1/companies/search?q=entreprise" \
  -H "x-api-key: ngg_live_xxxxxxxxxxxxx"

Démarrer vite

Quickstart

Créer une clé API

Depuis l’espace compte Nogogo, récupérez votre clé API.

Rechercher

Recherchez une entreprise par nom, sigle ou SIREN.

Consommer la fiche

Récupérez la fiche entreprise via son SIREN.

Recherche entreprise

curl -G "https://nogogo.fr/api/v1/companies/search" \
  -H "x-api-key: ngg_live_xxxxxxxxxxxxx" \
  --data-urlencode "q=entreprise" \
  --data-urlencode "limit=10"

Fiche entreprise

curl "https://nogogo.fr/api/v1/companies/123456789" \
  -H "x-api-key: ngg_live_xxxxxxxxxxxxx"

Des exemples d’intégration sont disponibles sur GitHub : curl, Python, JavaScript, TypeScript et enrichissement CSV.

Pour une intégration serveur, conservez toujours la clé API côté backend. Elle ne doit jamais être exposée dans un navigateur ou une application front publique.

Quotas

Plans et périmètre d’accès

Fonctionnalité

Free

Starter

Pro

Scale

Unités API / mois

2 500

20 000

100 000

Payload profil

company_basic

company_starter

company_full

Recherche entreprise

Oui

Fiche entreprise

Oui

Historique score

Non

Oui

Baromètre Nogogo

Public uniquement

Limité

Complet

Complet + exports

Indice de Risque Nogogo (IRN)

Non

National

Secteurs + régions

API + export

Données financières détaillées

Non

Oui

Événements légaux

Non

Oui

Dirigeants

Non

Oui

Fiche dirigeant

Non

Oui

Bulk entreprises

Non

Oui

Limite de recherche

100

Bulk max / appel

100

Affichage à des clients finaux

Usage OEM / partenaire

Les offres API standards sont réservées à un usage interne.

L’affichage du score, d’un badge ou de signaux Nogogo dans le logiciel d’un éditeur tiers nécessite une licence OEM / partenaire séparée. Cette licence est étudiée sur devis selon le contexte d’intégration et la diffusion prévue.

Demander une licence OEM Lire la licence API

Baromètre

Indice de Risque Nogogo (IRN)

L’IRN est un indicateur propriétaire Nogogo qui synthétise le niveau de risque d’un marché, d’un secteur ou d’une région à partir des données publiques et des signaux agrégés du baromètre.

Plan

Accès IRN

Usage recommandé

Profondeur

Free

Non inclus

Consultation du baromètre public uniquement

Aucun accès IRN API

Starter

IRN national

Situer rapidement le risque du marché français

Vue agrégée

Pro

IRN secteur + région

Comparer les marchés et prioriser les segments

Détails complets

Scale

IRN API + export

Alimenter vos benchmarks, modèles et outils internes

Profondeur maximale

Le plan Free ne donne pas accès à l’IRN via l’API. Le baromètre public reste consultable librement, mais il ne doit pas être confondu avec l’accès IRN B2B.

Company API

Endpoints entreprises

GET/companies/search?q=entreprise&limit=10

Recherche une entreprise par nom, sigle ou SIREN et retourne une liste courte de résultats prêts à afficher. Le nombre de résultats réellement retournés dépend du plan.

Free / Starter / Pro / Scale

Paramètres

Oui

Nom, sigle ou SIREN recherché.

limit

Non

Nombre maximal de résultats. Plafonné selon le plan.

Exemple de réponse

{
  "items": [
    {
      "siren": "123456789",
      "display_name": "ENTREPRISE",
      "legal_name": "ENTREPRISE EXEMPLE",
      "sigle": null,
      "activite_principale_libelle": "Autres assurances",
      "siege_commune": "Paris",
      "is_active": true,
      "score_global": 72,
      "note": "B",
      "badge_label": "Risque modéré",
      "legal_status": "active"
    }
  ],
  "count": 1,
  "limit": 10,
  "applied_limit": 10
}

Exemple de requête

curl -G "https://nogogo.fr/api/v1/companies/search" \
  -H "x-api-key: ngg_live_xxxxxxxxxxxxx" \
  --data-urlencode "q=entreprise" \
  --data-urlencode "limit=10"

Exemple de réponse

{
  "items": [
    {
      "siren": "123456789",
      "display_name": "ENTREPRISE",
      "legal_name": "ENTREPRISE EXEMPLE",
      "sigle": null,
      "activite_principale_libelle": "Autres assurances",
      "siege_commune": "Paris",
      "is_active": true,
      "score_global": 72,
      "note": "B",
      "badge_label": "Risque modéré",
      "legal_status": "active"
    }
  ],
  "count": 1,
  "limit": 10,
  "applied_limit": 10
}

GET/companies/{siren}

Retourne la fiche synthétique d’une entreprise : identité, statut, score, note, signaux et champs complémentaires selon le payload autorisé par le plan.

Free / Starter / Pro / Scale

Paramètres

siren

Oui

SIREN à 9 chiffres de l’entreprise.

Exemple de réponse

{
  "siren": "123456789",
  "display_name": "ENTREPRISE",
  "legal_name": "ENTREPRISE EXEMPLE",
  "code_ape": "65.12Z",
  "activite_principale_libelle": "Autres assurances",
  "date_creation": "2021-12-15",
  "categorie_juridique_libelle": "SAS, société par actions simplifiée",
  "is_active": true,
  "legal_status": "active",
  "siege_commune": "Paris",
  "siege_code_postal": "75008",
  "score_global": 72,
  "note": "B",
  "couleur": "amber",
  "score_confidence": 78,
  "confidence_label": "Bonne confiance",
  "badge_label": "Risque modéré",
  "badge_reason": "Signalement modéré",
  "positive_reasons": ["Entreprise active", "Structure cohérente"],
  "negative_reasons": ["Résultat net négatif"]
}

Exemple de requête

curl "https://nogogo.fr/api/v1/companies/123456789" \
  -H "x-api-key: ngg_live_xxxxxxxxxxxxx"

Exemple de réponse

{
  "siren": "123456789",
  "display_name": "ENTREPRISE",
  "legal_name": "ENTREPRISE EXEMPLE",
  "code_ape": "65.12Z",
  "activite_principale_libelle": "Autres assurances",
  "date_creation": "2021-12-15",
  "categorie_juridique_libelle": "SAS, société par actions simplifiée",
  "is_active": true,
  "legal_status": "active",
  "siege_commune": "Paris",
  "siege_code_postal": "75008",
  "score_global": 72,
  "note": "B",
  "couleur": "amber",
  "score_confidence": 78,
  "confidence_label": "Bonne confiance",
  "badge_label": "Risque modéré",
  "badge_reason": "Signalement modéré",
  "positive_reasons": ["Entreprise active", "Structure cohérente"],
  "negative_reasons": ["Résultat net négatif"]
}

GET/companies/{siren}/history

Retourne les snapshots disponibles du score dans le temps pour suivre l’évolution de la note, du score global et des composantes principales.

Pro / Scale

Paramètres

siren

Oui

SIREN à 9 chiffres de l’entreprise.

Exemple de requête

curl "https://nogogo.fr/api/v1/companies/123456789/history" \
  -H "x-api-key: ngg_live_xxxxxxxxxxxxx"

GET/companies/{siren}/financials

Retourne les éléments financiers disponibles pour l’entreprise : exercices, chiffre d’affaires, résultat, effectifs et indicateurs exploités par Nogogo selon les données disponibles.

Pro / Scale

Paramètres

siren

Oui

SIREN à 9 chiffres de l’entreprise.

Exemple de requête

curl "https://nogogo.fr/api/v1/companies/123456789/financials" \
  -H "x-api-key: ngg_live_xxxxxxxxxxxxx"

GET/companies/{siren}/legal-events

Retourne les événements légaux normalisés connus pour l’entreprise : procédures, liquidations, redressements, clôtures, sanctions ou événements significatifs selon les données disponibles.

Pro / Scale

Paramètres

siren

Oui

SIREN à 9 chiffres de l’entreprise.

Exemple de requête

curl "https://nogogo.fr/api/v1/companies/123456789/legal-events" \
  -H "x-api-key: ngg_live_xxxxxxxxxxxxx"

GET/companies/{siren}/directors

Retourne les dirigeants liés à l’entreprise et leurs mandats visibles, avec les informations utiles pour relier une fiche entreprise à une fiche dirigeant.

Pro / Scale

Paramètres

siren

Oui

SIREN à 9 chiffres de l’entreprise.

Exemple de requête

curl "https://nogogo.fr/api/v1/companies/123456789/directors" \
  -H "x-api-key: ngg_live_xxxxxxxxxxxxx"

GET/directors/{hash_identite}

Retourne la fiche publique d’un dirigeant identifié par son hash, avec les mandats et entreprises associées visibles selon le plan.

Pro / Scale

Paramètres

hash_identite

Oui

Identifiant public du dirigeant retourné par les endpoints dirigeants.

Exemple de requête

curl "https://nogogo.fr/api/v1/directors/4aa0c3xxxxxxxxxxxxxxxx" \
  -H "x-api-key: ngg_live_xxxxxxxxxxxxx"

POST/companies/bulk

Retourne plusieurs fiches entreprise en une seule requête. Conçu pour l’enrichissement interne par lots, avec une limite de 100 SIREN exploitables par appel.

Scale

Paramètres

sirens

Oui

Tableau de SIREN. Maximum 100 éléments exploitables par requête.

Exemple de réponse

{
  "count": 3,
  "items": [
    {
      "siren": "123456789",
      "display_name": "ENTREPRISE",
      "score_global": 72,
      "note": "B",
      "legal_status": "active"
    }
  ]
}

Exemple de requête

curl -X POST "https://nogogo.fr/api/v1/companies/bulk" \
  -H "Content-Type: application/json" \
  -H "x-api-key: ngg_live_xxxxxxxxxxxxx" \
  -d '{
    "sirens": ["123456789", "910111213", "100101102"]
  }'

Exemple de réponse

{
  "count": 3,
  "items": [
    {
      "siren": "123456789",
      "display_name": "ENTREPRISE",
      "score_global": 72,
      "note": "B",
      "legal_status": "active"
    }
  ]
}

Market API

Baromètre Nogogo

Les endpoints baromètre exposent des indicateurs agrégés de risque marché. Les données disponibles dépendent du plan actif. Les périodes non publiées ne sont jamais exposées via l’API B2B ou publique.

GET/barometer/latest

Retourne la dernière période publiée du baromètre avec les indicateurs nationaux principaux : période, statut, volume analysé, défaillances et IRN global lorsque disponible.

Starter / Pro / Scale

Aucun paramètre obligatoire supplémentaire en dehors du SIREN ou de la route affichée.

Exemple de réponse

{
  "period": "2026-05",
  "status": "published",
  "scope": "national",
  "kpis": {
    "companies_count": 1245000,
    "failures_count": 3210,
    "irn": 37.4
  }
}

Exemple de requête

curl "https://nogogo.fr/api/v1/barometer/latest" \
  -H "x-api-key: ngg_live_xxxxxxxxxxxxx"

Exemple de réponse

{
  "period": "2026-05",
  "status": "published",
  "scope": "national",
  "kpis": {
    "companies_count": 1245000,
    "failures_count": 3210,
    "irn": 37.4
  }
}

GET/barometer/history?months=12

Retourne la série historique des périodes publiées du baromètre pour construire une courbe mensuelle ou suivre l’évolution de l’IRN. La profondeur dépend du plan.

Starter / Pro / Scale

Paramètres

months

Non

Nombre de mois demandés. La profondeur réellement retournée dépend du plan.

Exemple de requête

curl -G "https://nogogo.fr/api/v1/barometer/history" \
  -H "x-api-key: ngg_live_xxxxxxxxxxxxx" \
  --data-urlencode "months=12"

GET/barometer/{period}

Retourne les indicateurs principaux d’une période précise publiée : agrégats nationaux, score moyen, répartition des notes et volumes de procédures disponibles.

Pro / Scale

Paramètres

period

Oui

Période au format YYYY-MM, par exemple 2026-05.

Exemple de requête

curl "https://nogogo.fr/api/v1/barometer/2026-05" \
  -H "x-api-key: ngg_live_xxxxxxxxxxxxx"

GET/barometer/{period}/sectors?limit=50

Retourne le classement des secteurs pour une période publiée avec leurs indicateurs agrégés : IRN, score moyen, répartition des notes et rang de risque. La profondeur dépend du plan.

Starter / Pro / Scale

Paramètres

period

Oui

Période au format YYYY-MM.

limit

Non

Nombre de secteurs demandés. Plafonné selon le plan.

Exemple de requête

curl -G "https://nogogo.fr/api/v1/barometer/2026-05/sectors" \
  -H "x-api-key: ngg_live_xxxxxxxxxxxxx" \
  --data-urlencode "limit=50"

GET/barometer/{period}/regions?limit=50

Retourne le classement des régions pour une période publiée avec leurs indicateurs agrégés : IRN, score moyen, taux de défaillance et rang de risque. La profondeur dépend du plan.

Starter / Pro / Scale

Paramètres

period

Oui

Période au format YYYY-MM.

limit

Non

Nombre de régions demandées. Plafonné selon le plan.

Exemple de requête

curl -G "https://nogogo.fr/api/v1/barometer/2026-05/regions" \
  -H "x-api-key: ngg_live_xxxxxxxxxxxxx" \
  --data-urlencode "limit=50"

GET/barometer/{period}/failure-signals

Retourne les statistiques de signaux faibles observés avant défaillance sur la période publiée : part des entreprises avec au moins un signal, intensité moyenne et fenêtres d’observation disponibles.

Starter / Pro / Scale

Paramètres

period

Oui

Période au format YYYY-MM.

Exemple de requête

curl "https://nogogo.fr/api/v1/barometer/2026-05/failure-signals" \
  -H "x-api-key: ngg_live_xxxxxxxxxxxxx"

GET/barometer/{period}/insights

Retourne une synthèse éditoriale structurée du baromètre pour une période publiée : titres, résumés, métriques clés, portée nationale, sectorielle ou régionale, et points notables prêts à afficher dans un dashboard ou un rapport.

Pro / Scale

Paramètres

period

Oui

Période au format YYYY-MM.

Exemple de requête

curl "https://nogogo.fr/api/v1/barometer/2026-05/insights" \
  -H "x-api-key: ngg_live_xxxxxxxxxxxxx"

GET/barometer/{period}/pdf

Télécharge le PDF du baromètre pour une période publiée lorsque l’export est disponible dans le plan. Utile pour archiver ou partager le rapport mensuel en interne.

Scale

Paramètres

period

Oui

Période au format YYYY-MM.

Exemple de requête

curl "https://nogogo.fr/api/v1/barometer/2026-05/pdf" \
  -H "x-api-key: ngg_live_xxxxxxxxxxxxx" \
  --output barometre-nogogo-2026-05.pdf

Debug

Erreurs et codes de réponse

200

Requête traitée avec succès.

400

Paramètre invalide, body invalide ou bulk non exploitable.

401

Clé API absente ou invalide.

403

Fonctionnalité non incluse dans le plan actuel.

404

Ressource non trouvée.

429

Quota ou limite de débit atteinte.

Sécurité

Bonnes pratiques d’intégration

prévoir un cache applicatif côté client ou backend intégrateur ;

ne pas exposer une clé API B2B dans un front public ;

journaliser les appels pour faciliter le support et la traçabilité ;

ne pas prendre une décision métier critique sur le seul score Nogogo ;

respecter strictement les restrictions de licence et de republication.

Licence

Cadre contractuel

L’usage de l’API est soumis aux CGV API ainsi qu’aux conditions de licence et d’usage autorisé.

Dernière mise à jour : 5 mai 2026

Ressources API

API SIREN API SIRET API BODACC Procédures collectives Fiabilité entreprise Exemples GitHub