North Data

At a glance

Availability: Experimental (how to enable).
Auth: API key.
Connection: The key from NORTHDATA_API_KEY is sent as the X-Api-Key header.
Docs: https://northdata.github.io/doc/api/

Set these per environment. See Connect an integration.

Variable	Required	Description
`NORTHDATA_API_KEY`	Yes	North Data API key (format XXXX-XXXX), sent as the X-Api-Key header Docs.

Get a North Data Premium account with API access: The Data API is part of North Data’s paid Data Services. Request access (a trial can be arranged) at https://www.northdata.de/_data or via sales.
Obtain your API key: After activation you receive an API key in the format XXXX-XXXX from North Data.
Set the environment variable: Set NORTHDATA_API_KEY in your .env. The key is sent as the X-Api-Key HTTP header on every request.
Verify access: Run Get Company with name=‘<a known company>’ and address=‘<its city>’ and confirm a JSON profile is returned.

Only successful queries are billed; search endpoints are billed per unique company returned - keep power search filters narrow
In Germany, company name plus city uniquely identify a company; alternatively use registerId + registerCity (e.g. ‘HRB 12345’ + ‘Hamburg’)
The API serves JSON by default and is also reachable under www.northdata.com with the same paths

Tool	Access	Description
Search Companies	Read	Fuzzy universal search for companies (and optionally persons) by free-text query, e.g. ‘Siemens, München’. Use this to find a company before fetching its details.
Get Company	Read	Retrieve a single company’s profile (register info, address, status, financial indicators). Identify it either by name + address (city), or by registerId + registerCity, or by companyId from a previous search.
Power Search	Read	Structured company search with filters for location radius, industry segment, legal form, status, and countries. Billed per unique company returned, so keep filters narrow.
Suggest Companies	Read	Auto-complete suggestions for a partial company or person name. Free of charge - suggested companies do not count toward the monthly quota, so use this as a cheap first pass before Get Company.
Get Person	Read	Look up a person (officer, shareholder, representative) by name and address or by a person ID from a previous search result. Billed like company lookups.

Look up the company ‘<name>, <city>’ in North Data and summarize its register entry, status, and key financial indicators.
Use North Data power search to find active companies of a given industry within 25 km of a city and list name, city, and legal form.