Recherche d'entreprises et de personnes sur North Data (northdata.fr, northdata.com, northdata.de). 1 crédit par appel.
query est un nom, ou une URL suggest.json. countries est optionnel (FR ou FR,DE). domain choisit l'hôte pour un mot-clé : fr (défaut), com ou de.
La réponse est { results, pagination }. Les suggestions tiennent sur une page de 15 lignes au plus : total_results reste null. page supérieur à 1 renvoie 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
Exemple (mot-clé) :
BMW
Exemple (URL suggest) :
https://www.northdata.fr/suggest.json?query=BMW&countries=FR
query est obligatoire.
| Forme |
Exemple |
Effet |
| Nom |
BMW |
Suggestions sur l'hôte choisi par domain (défaut www.northdata.fr) |
| URL suggest |
https://www.northdata.de/suggest.json?query=Siemens&countries=DE |
L'hôte, le mot-clé et countries sont lus dans l'URL |
Une URL de fiche (tout chemin autre que / ou /suggest.json) renvoie 400. Passez-la à North Data Company. Un autre hôte renvoie 400. Une valeur vide renvoie 400.
countries filtre la recherche par nom. Codes ISO alpha-2 séparés par une virgule, une barre ou un espace : FR, FR,DE, FR|DE. Vide : tous les pays. Un code qui n'a pas deux lettres renvoie 400. Si query est une URL qui contient déjà countries, cette valeur l'emporte.
domain choisit l'hôte d'un nom : fr (défaut, www.northdata.fr), com ou en (www.northdata.com), de (www.northdata.de). Il est ignoré si query est une URL. Une valeur inconnue renvoie 400.
page n'accepte que 1. En dessous de 1 : 400. Au-dessus : 404. Une page contient au plus 15 lignes. total_results, total_pages et next restent nuls.
| Paramètre |
Type |
Requis |
Description |
query |
string |
oui |
Nom, ou URL suggest.json sur northdata.fr, .com ou .de |
countries |
string |
non |
Codes ISO alpha-2 (FR ou FR,DE). Vide : tous les pays |
domain |
string |
non |
fr, com ou de. Ignoré si query est une URL. Défaut fr |
page |
integer |
non |
Seulement 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 |
- Une URL de fiche passée ici renvoie
400. Utilisez North Data Company.
- Aucune suggestion renvoie
404, pas un 200 vide.
- Passez
results[].url à l'endpoint fiche.
| Code |
Signification |
400 |
Requête vide, hôte inconnu, pays invalide, ou URL de fiche |
403 |
Accès bloqué |
404 |
Aucune suggestion, ou page supérieur à 1 |
500 |
Échec du fetch |
