Pesquisa empresas e pessoas na North Data (northdata.fr, northdata.com, northdata.de). 1 crédito por chamada.
query é um nome ou um URL suggest.json. countries é opcional (FR ou FR,DE). domain escolhe o host de uma palavra-chave: fr (predefinição), com ou de.
A resposta é { results, pagination }. As sugestões cabem numa página de 15 linhas no máximo: total_results fica null. page maior que 1 devolve 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
Exemplo (palavra-chave):
BMW
Exemplo (URL suggest):
https://www.northdata.fr/suggest.json?query=BMW&countries=FR
query é obrigatório.
| Forma |
Exemplo |
Efeito |
| Nome |
BMW |
Sugestões no host de domain (predefinição www.northdata.fr) |
| URL suggest |
https://www.northdata.de/suggest.json?query=Siemens&countries=DE |
O host, a palavra e countries leem-se no URL |
Um URL de ficha (qualquer caminho diferente de / ou /suggest.json) devolve 400. Passe-o a North Data Company. Outro host devolve 400. Um valor vazio devolve 400.
countries filtra a pesquisa por nome. Códigos ISO alpha-2 separados por vírgula, barra ou espaço: FR, FR,DE, FR|DE. Vazio: todos os países. Um código que não tenha duas letras devolve 400. Se o URL já tiver countries, esse valor ganha.
domain escolhe o host de um nome: fr (predefinição, www.northdata.fr), com ou en (www.northdata.com), de (www.northdata.de). Ignora-se se query for um URL. Um valor desconhecido devolve 400.
page só aceita 1. Abaixo de 1: 400. Acima: 404. Uma página tem no máximo 15 linhas. total_results, total_pages e next ficam vazios.
| Parâmetro |
Tipo |
Obrigatório |
Descrição |
query |
string |
sim |
Nome, ou URL suggest.json em northdata.fr, .com ou .de |
countries |
string |
não |
Códigos ISO alpha-2 (FR ou FR,DE). Vazio: todos os países |
domain |
string |
não |
fr, com ou de. Ignorado se query for um URL. Predefinição fr |
page |
integer |
não |
Apenas 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 |
- Um URL de ficha aqui devolve
400. Use North Data Company.
- Sem sugestões devolve
404, não um 200 vazio.
- Passe
results[].url ao endpoint de ficha.
| Código |
Significado |
400 |
Pedido vazio, host desconhecido, país inválido ou URL de ficha |
403 |
Bloqueado |
404 |
Nenhuma sugestão, ou page maior que 1 |
500 |
Falha do pedido |
