Piloterr

North Data Search

GET
/v2/northdata/search

Search North Data companies and people by name. Returns suggestion cards and pagination (1 credit).

Credit cost: 1 credit per call

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Company or person name, or a North Data suggest URL.

Example (keyword):

BMW

Example (suggest URL):

https://www.northdata.fr/suggest.json?query=BMW&countries=FR

Notes:

  • A profile URL returns 400. Use the company endpoint.
  • domain defaults to fr. countries is optional (FR or FR,DE).
  • Only page 1 exists.
countries?string

ISO alpha-2 codes, separated by comma, pipe or space (FR or FR,DE). Empty searches every country. A URL that already has countries wins.

domain?string

Host of a name: fr (default), com or en, de. Ignored when query is a URL.

Default"fr"
page?number

Only 1. Below 1 returns 400. Above 1 returns 404. At most 15 rows.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/northdata/search?query=string"
{  "results": [    {      "url": "https://www.northdata.fr/Maison%20Boinaud%20SAS,%20Angeac-Champagne/Siren%20907120216",      "name": "Maison Boinaud SAS",      "type": "company",      "location": "Angeac-Champagne",      "position": 1    }  ],  "pagination": {    "next": null,    "page": 1,    "per_page": 15,    "total_pages": null,    "total_results": null  }}
{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}