Ficha de empresa de North Data. 1 crédito por llamada.
query acepta una URL de ficha, un id numérico de North Data (10 dígitos o más) o un nombre. Un nombre abre el primer resultado. countries orienta esa búsqueda.
El objeto incluye razón social, estado, dirección, registro, capital, códigos de actividad, los últimos indicadores, contactos publicados e historial.
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
Ejemplo (nombre):
Maison Boinaud
Ejemplo (URL de ficha):
https://www.northdata.com/Rolls-Royce%20plc,%20London/Companies%20House%2001003142
query es obligatorio. Se usa la primera forma que identifica la empresa.
| Forma |
Ejemplo |
Efecto |
| URL de ficha |
https://www.northdata.com/Rolls-Royce%20plc,%20London/Companies%20House%2001003142 |
El host sale de la URL. La ruta aporta el registro, el id interno, o el nombre y la ciudad |
| Id North Data |
5854348650 |
10 dígitos o más. Se carga en el host de domain |
| Nombre |
Maison Boinaud |
Se abre la primera sugerencia de empresa. countries y domain se aplican a esa búsqueda |
Una URL suggest devuelve 400. Otro host devuelve 400. Un valor vacío devuelve 400. Si el nombre corresponde a una persona y no a una empresa, la llamada devuelve 404.
countries solo se usa si query es un nombre. Los mismos códigos que en la búsqueda: FR, FR,DE o FR|DE. Un código inválido devuelve 400.
domain vale fr (por defecto), com / en o de. Se ignora si query es una URL.
| Parámetro |
Tipo |
Obligatorio |
Descripción |
query |
string |
sí |
URL de ficha, id North Data (10 dígitos o más), o nombre |
countries |
string |
no |
ISO alpha-2. Solo si query es un nombre |
domain |
string |
no |
fr, com o de. Se ignora si query es una URL. Por defecto fr |
| 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 |
- Hosts aceptados:
www.northdata.fr, www.northdata.com, www.northdata.de. Cualquier otro host devuelve 400.
- Una empresa desconocida devuelve
404.
financials conserva solo el último ejercicio publicado.persons repite las filas del historial de categoría 9.
| Código |
Significado |
400 |
Consulta vacía o host fuera de North Data |
403 |
Bloqueado |
404 |
Empresa no encontrada |
500 |
Fallo de la petición |
