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 offresCGV APILicence et usages autorisés

Base URL et authentification

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

https://nogogo.fr/api/v1

L’authentification se fait par clé API dans l’en-tête x-api-key.

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

Chaque appel API consomme une ou plusieurs unités API selon l’endpoint utilisé. Le quota mensuel du plan actif est décompté en unités API.

Quickstart

Le point d’entrée le plus simple consiste à rechercher une entreprise, puis à récupérer sa fiche via son SIREN.

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

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.

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

Fonctionnalité
Free
Starter
Pro
Scale
Unités API / mois
100
2 500
20 000
100 000
Payload profil
company_basic
company_starter
company_full
company_full
Recherche entreprise
Oui
Oui
Oui
Oui
Fiche entreprise
Oui
Oui
Oui
Oui
Historique score
Non
Non
Oui
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
Non
Oui
Oui
Événements légaux
Non
Non
Oui
Oui
Dirigeants
Non
Non
Oui
Oui
Fiche dirigeant
Non
Non
Oui
Oui
Bulk entreprises
Non
Non
Non
Oui
Limite de recherche
5
20
50
100
Bulk max / appel
0
0
0
100

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.

Endpoints disponibles

GET/companies/search?q=entreprise&limit=10
Free / Starter / Pro / Scale

Recherche entreprise par nom, sigle ou SIREN. Le nombre de résultats réellement retournés dépend du plan.

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}
Free / Starter / Pro / Scale

Retourne la fiche entreprise. Le contenu varie selon le payload autorisé par le plan.

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
Pro / Scale

Historique du score et de ses composantes sur les snapshots disponibles.

Exemple de requête

curl "https://nogogo.fr/api/v1/companies/123456789/history"   -H "x-api-key: ngg_live_xxxxxxxxxxxxx"
GET/companies/{siren}/financials
Pro / Scale

Bilans et synthèse financière disponibles pour 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
Pro / Scale

Événements légaux ou procédures normalisées disponibles pour 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
Pro / Scale

Résumé des dirigeants et mandats actifs liés à 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}
Pro / Scale

Retourne la fiche détaillée d’un dirigeant avec ses mandats.

Exemple de requête

curl "https://nogogo.fr/api/v1/directors/4aa0c3xxxxxxxxxxxxxxxx"   -H "x-api-key: ngg_live_xxxxxxxxxxxxx"
POST/companies/bulk
Scale

Bulk de fiches entreprise. Limité à 100 SIREN exploitables par requête.

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"
    }
  ]
}

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
Starter / Pro / Scale

Retourne la dernière période publiée disponible pour le baromètre Nogogo avec les principaux indicateurs nationaux.

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
Starter / Pro / Scale

Retourne l’historique publié du baromètre. Starter est limité à 12 mois ; Pro et Scale disposent d’une profondeur plus large selon configuration.

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}
Pro / Scale

Retourne les données principales d’une période publiée précise. Les périodes draft, ready ou archived sont inaccessibles par URL directe.

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
Starter / Pro / Scale

Classement des secteurs. Starter est limité au top 10 ; Pro et Scale peuvent accéder à la profondeur complète autorisée.

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
Starter / Pro / Scale

Classement régional. Starter est limité au top 10 ; Pro et Scale disposent d’un accès plus complet.

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
Starter / Pro / Scale

Signaux faibles agrégés. Starter reçoit une vue nationale agrégée ; Pro et Scale accèdent aux détails disponibles.

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
Pro / Scale

Insights d’analyse baromètre pour une période publiée : tendances, points notables et comparaisons disponibles.

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
Scale

Export PDF ou rapport baromètre lorsque l’export est disponible pour la période publiée.

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

Gestion du compte et facturation

La gestion du compte, des clés API, du quota et de la facturation est disponible depuis l’espace client Nogogo. Ces routes sont réservées aux utilisateurs connectés et ne sont pas nécessaires pour consommer l’API métier.

Pour une intégration client, utilisez uniquement la clé API fournie dans votre espace client et les endpoints métier documentés sur cette page.

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.

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.

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