Suche nach Unternehmen und Personen auf North Data (northdata.fr, northdata.com, northdata.de). 1 Credit pro Aufruf.
query ist ein Name oder eine suggest.json-URL. countries ist optional (FR oder FR,DE). domain wählt den Host für ein Stichwort: fr (Standard), com oder de.
Die Antwort ist { results, pagination }. Vorschläge sind eine Seite mit höchstens 15 Zeilen, total_results bleibt null. page größer als 1 liefert 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
Beispiel (Stichwort):
BMW
Beispiel (Suggest-URL):
https://www.northdata.de/suggest.json?query=Siemens&countries=DE
query ist Pflicht.
| Form |
Beispiel |
Wirkung |
| Name |
BMW |
Vorschläge auf dem Host aus domain (Standard www.northdata.fr) |
| Suggest-URL |
https://www.northdata.de/suggest.json?query=Siemens&countries=DE |
Host, Suchwort und countries kommen aus der URL |
Eine Profil-URL (jeder Pfad außer / oder /suggest.json) ergibt 400. Diese URL an North Data Company übergeben. Ein anderer Host ergibt 400. Ein leerer Wert ergibt 400.
countries filtert die Namenssuche. ISO-Alpha-2, getrennt durch Komma, Pipe oder Leerzeichen: FR, FR,DE, FR|DE. Leer: alle Länder. Ein Code ohne genau zwei Buchstaben ergibt 400. Steht countries schon in der URL, gilt dieser Wert.
domain wählt den Host eines Namens: fr (Standard, www.northdata.fr), com oder en (www.northdata.com), de (www.northdata.de). Bei einer URL wird domain ignoriert. Ein unbekannter Wert ergibt 400.
page akzeptiert nur 1. Unter 1: 400. Über 1: 404. Eine Seite hat höchstens 15 Zeilen. total_results, total_pages und next bleiben leer.
| Parameter |
Typ |
Pflicht |
Beschreibung |
query |
string |
ja |
Name oder suggest.json-URL auf northdata.fr, .com oder .de |
countries |
string |
nein |
ISO-Alpha-2 (FR oder FR,DE). Leer: alle Länder |
domain |
string |
nein |
fr, com oder de. Bei einer URL ignoriert. Standard fr |
page |
integer |
nein |
Nur 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 |
- Eine Profil-URL liefert hier
400. Nutzen Sie North Data Company.
- Keine Vorschläge liefern
404, kein leeres 200.
results[].url an den Firmenendpunkt übergeben.
| Code |
Bedeutung |
400 |
Leere Anfrage, unbekannter Host, ungültiges Land oder Profil-URL |
403 |
Blockiert |
404 |
Kein Vorschlag, oder page größer als 1 |
500 |
Abruf fehlgeschlagen |
