Busca empresas y personas en North Data (northdata.fr, northdata.com, northdata.de). 1 crédito por llamada.
query es un nombre o una URL suggest.json. countries es opcional (FR o FR,DE). domain elige el host de una palabra clave: fr (por defecto), com o de.
La respuesta es { results, pagination }. Las sugerencias ocupan una página de 15 filas como máximo: total_results queda null. page mayor que 1 devuelve 404.
GET https://api.piloterr.com/v2/northdata/search?query=BMW&countries=FR
GET https://api.piloterr.com/v2/northdata/search?query=Siemens&domain=de&countries=DE
Ejemplo (palabra clave):
BMW
Ejemplo (URL suggest):
https://www.northdata.fr/suggest.json?query=BMW&countries=FR
query es obligatorio.
| Forma |
Ejemplo |
Efecto |
| Nombre |
BMW |
Sugerencias en el host de domain (por defecto www.northdata.fr) |
| URL suggest |
https://www.northdata.de/suggest.json?query=Siemens&countries=DE |
El host, la palabra y countries se leen de la URL |
Una URL de ficha (cualquier ruta distinta de / o /suggest.json) devuelve 400. Pásela a North Data Company. Otro host devuelve 400. Un valor vacío devuelve 400.
countries filtra la búsqueda por nombre. Códigos ISO alpha-2 separados por coma, barra o espacio: FR, FR,DE, FR|DE. Vacío: todos los países. Un código que no tenga dos letras devuelve 400. Si la URL ya trae countries, gana ese valor.
domain elige el host de un nombre: fr (por defecto, www.northdata.fr), com o en (www.northdata.com), de (www.northdata.de). Se ignora si query es una URL. Un valor desconocido devuelve 400.
page solo acepta 1. Por debajo de 1: 400. Por encima: 404. Una página tiene como máximo 15 filas. total_results, total_pages y next quedan vacíos.
| Parámetro |
Tipo |
Obligatorio |
Descripción |
query |
string |
sí |
Nombre, o URL suggest.json en northdata.fr, .com o .de |
countries |
string |
no |
Códigos ISO alpha-2 (FR o FR,DE). Vacío: todos los países |
domain |
string |
no |
fr, com o de. Se ignora si query es una URL. Por defecto fr |
page |
integer |
no |
Solo 1 |
| Field |
Type |
Description |
results[] |
array |
Suggestion cards |
results[].position |
integer |
Position on the page, from 1 |
results[].name |
string |
Company or person name |
results[].type |
string | null |
company or person |
results[].location |
string | null |
City, sometimes with the country |
results[].url |
string |
Profile URL. Pass it to the company endpoint |
pagination.page |
integer |
Always 1 |
pagination.per_page |
integer |
Suggestion page size (15) |
pagination.total_results |
null |
North Data does not return a total |
pagination.total_pages |
null |
Single page |
pagination.next |
null |
No next page |
- Una URL de ficha aquí devuelve
400. Use North Data Company.
- Sin sugerencias devuelve
404, no un 200 vacío.
- Pase
results[].url al endpoint de ficha.
| Código |
Significado |
400 |
Consulta vacía, host desconocido, país inválido o URL de ficha |
403 |
Bloqueado |
404 |
Ninguna sugerencia, o page mayor que 1 |
500 |
Fallo de la petición |
