Aller au contenu principal
Piloterr
Retour à la bibliothèque

API North Data Company

Fiche entreprise North Data : registre, adresse, finances et historique (1 crédit).

Actif1 crédit = 1 requêteGET/v2/northdata/company

Vue d'ensemble de l'endpoint

Documentation détaillée, tarifs et exemples d'utilisation.

AperçuLink to Aperçu

Fiche entreprise North Data. 1 crédit par appel.

query accepte une URL de fiche, un identifiant North Data (10 chiffres ou plus), ou un nom. Un nom ouvre la première suggestion. countries oriente cette recherche.

L'objet contient la raison sociale, le statut, l'adresse, le registre, le capital, les codes d'activité, les derniers indicateurs financiers, les contacts publiés et l'historique.

DémarrageLink to Démarrage

GET https://api.piloterr.com/v2/northdata/company?query=https://www.northdata.com/Rolls-Royce%20plc,%20London/Companies%20House%2001003142
GET https://api.piloterr.com/v2/northdata/company?query=Maison%20Boinaud&countries=FR

queryLink to query

Exemple (nom) :

Maison Boinaud

Exemple (URL de fiche) :

https://www.northdata.com/Rolls-Royce%20plc,%20London/Companies%20House%2001003142

query est obligatoire. La première forme qui identifie la société est utilisée.

Forme Exemple Effet
URL de fiche https://www.northdata.com/Rolls-Royce%20plc,%20London/Companies%20House%2001003142 L'hôte vient de l'URL. Le chemin fournit le registre, l'id interne, ou le nom et la ville
Id North Data 5854348650 10 chiffres ou plus. Chargé sur l'hôte de domain
Nom Maison Boinaud La première suggestion de société est ouverte. countries et domain s'appliquent à cette recherche

Une URL suggest renvoie 400. Un autre hôte renvoie 400. Une valeur vide renvoie 400. Si le nom correspond à une personne et pas à une société, l'appel renvoie 404.

countries ne sert que si query est un nom. Mêmes codes que la recherche : FR, FR,DE ou FR|DE. Un code invalide renvoie 400.

domain vaut fr (défaut), com / en, ou de. Il est ignoré si query est une URL.

ParamètresLink to Paramètres

Paramètre Type Requis Description
query string oui URL de fiche, id North Data (10 chiffres ou plus), ou nom
countries string non ISO alpha-2. Utilisé seulement si query est un nom
domain string non fr, com ou de. Ignoré si query est une URL. Défaut fr

Champs de la réponseLink to Champs de la réponse

Field Type Description
company_id string | null North Data id
name string | null Legal name
legal_form string | null Legal form (SAS, plc, …)
status string | null active, liquidation or terminated
url string | null Canonical profile URL
subject string | null Activity, in the site language
original_subject string | null Activity in the source language
original_subject_language string | null Language of original_subject
risk_level string | null North Data risk flag
lei / eu_id / elf_code string | null Identifiers when published
last_update_time string | null ISO timestamp
address object Street, postal code, city, state, country, formatted line, latitude, longitude
register object id, city, country, unique_key
capital object | null Latest capital: value, display, unit, date
segment_codes object nace, naf, isic, naics, uksic and the 2025 variants
financials[] array Latest period only: id, name, value, display, unit, date
extras[] array Published contacts (phone, url, email, vatId)
events[] array Timeline: date, category, description, url
persons[] array Timeline rows whose category is 9
former_names[] array Previous names
other_registers[] array Other register numbers
filings[] array LEI, SIRET and similar filings

NotesLink to Notes

  • Hôtes acceptés : www.northdata.fr, www.northdata.com, www.northdata.de. Tout autre hôte renvoie 400.
  • Une entreprise inconnue renvoie 404.
  • financials ne garde que le dernier exercice publié.
  • persons reprend les lignes d'historique de catégorie 9.

Codes d'erreurLink to Codes d'erreur

Code Signification
400 Requête vide ou hôte hors North Data
403 Accès bloqué
404 Entreprise introuvable
500 Échec du fetch

Endpoints liésLink to Endpoints liés

API associées

Étendez vos capacités data avec ces outils complémentaires.

Prêt à commencer ?

Votre API de scraping web est à un clic. Commencez avec +500 crédits, sans infrastructure à gérer, sans proxies à configurer, et sans carte bancaire.

  • +500 crédits
  • Aucune carte bancaire requise
  • Tous les endpoints inclus