# North Data Scraper ($0.95/1K): German & EU Company Data (`tsutseisoftware/northdata-scraper`) Actor

Scrape North Data (northdata.com / .de): German and European company register data with register number, address, purpose, revenue, earnings, history, officers, network and publications; risk signals, monitoring with alerts.

- **URL**: https://apify.com/tsutseisoftware/northdata-scraper.md
- **Developed by:** [Tsutsei Software](https://apify.com/tsutseisoftware) (community)
- **Categories:** Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.81 / 1,000 companies

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## North Data Scraper: German & European Company Register Data

> **Auf Deutsch:** Scraper und API für **North Data** (northdata.de): Firmendaten aus dem **Handelsregister** und europäischen Registern mit Registernummer und Registergericht, Adresse, Unternehmensgegenstand, Stammkapital, **Umsatz, Gewinn, Mitarbeiter und Bilanzsumme**, Registerhistorie, Insolvenzen, Konzernnetzwerk, Bekanntmachungen und Kontaktdaten, Firmen-Monitoring mit Benachrichtigung per Slack, Telegram oder WhatsApp und Export nach Excel, CSV oder JSON.

Get company data from **North Data** (northdata.com / northdata.de), the search engine for official company registers of Germany and ~25 other European countries, as clean, ready-to-use rows. Search by **company name**, **keyword**, **register number** (HRB 6684), list **every company around a map point** (up to 10 000 per point) or paste **North Data URLs**, and get each company's **register entry** (court, type and number, EUID, LEI), **legal form**, **status**, **address**, **founding date**, **corporate purpose**, **industry**, **share capital**, the **published figures** (revenue, earnings, employees, total assets, equity, public funding, patents) per year with their source, the **register history**, **insolvency** entries, the **number of officers per role**, known shareholders and shareholdings, and the company's **publications**. Optionally the **corporate network** (parents, subsidiaries, linked companies), **contact details** the company published, and the **officers by name** (personal data, opt-in).

**$3.39 per 1 000 companies with the full profile, $0.95 with what the search shows.** No proxy setup and no extra platform costs.

Built for **KYC and compliance, B2B sales and lead generation, M\&A and due diligence, credit and supplier risk**: schedule it daily in monitoring mode and get only the companies whose register data changed, with the **new register events** since the previous run, straight to Slack, Telegram, WhatsApp or your webhook.

### Why use this North Data scraper?

- 🏛️ **The whole public profile in one row:** register, identifiers, address, purpose, capital, figures per year with the publication they come from, balance sheets of listed companies, register history and legal structure.
- 📍 **Every company around a point:** all companies registered within a radius of a map point (up to 10 000 per point) with legal form, address, register, EUID, ELF code and **North Data's own risk rating** (green, yellow, red): local lead lists no other North Data scraper gives.
- 🏷️ **Industry codes:** `naceCode` (NACE class) and `industryCode` in its classification (NACE 2025, German WZ 2025, UK SIC) from the industry North Data shows, plus a **NACE filter** (`naceCodes`: 62, 62.1, 47.91); ELF legal form code and register key.
- 🚦 **Risk signals for every company:** `riskLevel` (low, medium, high) and `riskSignals` from the register data: terminated, in liquidation, insolvency (recent or past), losses, frequent changes of directors or address, a young company, warnings North Data shows. Filter by risk level, too.
- 🔎 **Filters the website gives only to logged-in users,** applied by the actor: countries, status, legal form, must / must not contain, only with published figures, minimum employees, **minimum revenue**, only names that match the query. Companies left out are not saved or charged as rows (a profile read only to check a figure or risk filter counts as an extra page).
- 🎯 **Name lists to exact companies:** "Max results per search" 1 returns the best match of each name, with `matchScore`; add the legal form ("Zalando SE") or the register number for the exact entity.
- 🕸️ **Corporate network:** parent companies, subsidiaries and companies linked by control or address, with the relationship ("Direct parent company", "100 % limited partnership capital").
- 📬 **Monitoring mode:** only new and changed companies (`changeType`, `changedFields`, `previousValues`) with the **register events and publications that are new since the previous run** (`newEvents`, `newPublications`).
- 🔔 **Alerts without any integration:** Slack, Discord, Telegram, WhatsApp or your own webhook after each run.
- 🌍 **English, German or French** labels, events and roles.
- 🔒 **Privacy first:** no names of people by default; register texts that name people keep the role without the name. Officers and people are an opt-in.

#### How it compares with other North Data scrapers

An honest comparison with the North Data scrapers most used in the Store (checked 2026-11-18), without naming them:

| Capability | This actor | Other scrapers |
|---|---|---|
| Names, keywords, register numbers, company and search URLs | yes | yes |
| Every company around a map point (up to 10 000) | yes | no |
| Register, identifiers, address, purpose, figures per year, register history | yes | yes (some only part) |
| Country, status (incl. insolvency), legal form, NACE, keyword and figure filters | yes, all of them | a few have some |
| NACE code, ELF code, register key | yes | one or two |
| North Data's risk rating, own risk level with the reasons, filter by risk | yes | two have the rating, one a grade filter, none the reasons |
| Corporate network | yes | some |
| Contact details from the company's own publications | yes | one |
| Monitoring with changed fields and **new register events** | yes | one (without new events) |
| Slack, Telegram, Discord, WhatsApp, webhook | yes | one (without WhatsApp) |
| People only on request | yes | names always included |
| Printable HTML and Markdown export, run summary | yes | no |

### What data can you get?

| Group | Fields |
|---|---|
| Identity | `name`, `formerNames`, `legalForm`, `status` (active, liquidation, insolvency, terminated), `northDataId`, `url` |
| Register | `registerId`, `registerCourt`, `registerType`, `registerNumber`, `registerSource`, `euid`, `lei`, `elfCode`, `registerKey`, `stockSymbols`, `otherIdentifiers` |
| Address | `address`, `street`, `postalCode`, `city`, `region`, `country`, `latitude`, `longitude`, `formerAddresses` |
| Business | `foundingDate`, `corporatePurpose`, `industry`, `industryCode`, `industryCodeStandard`, `naceCode`, `capital`, `capitalCurrency`, `capitalDate` |
| Figures | `latestRevenue`, `latestEarnings`, `latestEmployees`, `latestTotalAssets`, `latestEquity` (each with year and currency), `financials` (every metric per year with its source), `balanceSheet` (listed companies), `premiumOnlyMetrics` |
| Structure | `officerCount`, `officerRoles` (officers per role), `shareholderCount`, `participationCount`, `managementEventCount` |
| History | `events` (date, category, text, source link), `eventCount`, `latestEventDate`, `insolvencyEvents`, `hasInsolvency` |
| Publications | `publications`, `mentions`, `publicationCount`, `latestPublicationDate` |
| Network (option) | `networkCompanies`, `networkRelations`, `networkPersonCount`, `networkRiskCount` |
| Contacts (option) | `website`, `phones`, `emails`, `contactSource` |
| Risk | `riskLevel`, `riskSignals`, `northDataRiskLevel` (around a point, or with **Add North Data risk rating**) |
| People (personal data, option) | `officers`, `formerOfficers`, `networkPersons`, person rows with `companies` |
| Search and monitoring | `searchQuery`, `searchRank`, `matchScore`, `sourceUrl`, `changeType`, `changedFields`, `previousValues`, `newEvents`, `newPublications` |

### How to scrape North Data

1. Type company names, keywords or register numbers into **Search queries**, add points to search around (latitude, longitude, radius in km), or paste North Data URLs (company profiles or searches from northdata.com, .de or .fr).
2. Set **Max results** and **Max results per search** (1 = only the best match of each name).
3. Pick the options: figures, register history, publications, network, contact details, people, and the filters.
4. Click **Start**. Download the companies as Excel, CSV or JSON, or connect them to your tools.

### Use cases

#### Look up a list of companies (best match each)

```json
{
  "searchQueries": ["Zalando SE", "Siemens AG", "HRB 86891"],
  "maxResultsPerQuery": 1,
  "maxItems": 3
}
```

#### Every GmbH within 300 m of Alexanderplatz, Berlin

```json
{
  "aroundPoints": ["52.5219, 13.4132, 0.3"],
  "maxResultsPerPoint": 500,
  "legalForms": ["GmbH"],
  "statuses": ["active"],
  "readCompanyProfiles": false
}
```

#### German GmbHs with published revenue over €10M

```json
{
  "searchQueries": ["Maschinenbau", "Software"],
  "countries": ["DE"],
  "legalForms": ["GmbH"],
  "statuses": ["active"],
  "minRevenue": 10000000,
  "maxResultsPerQuery": 45
}
```

#### Supplier risk check with the corporate network

```json
{
  "startUrls": [{ "url": "https://www.northdata.com/Zalando%20SE,%20Berlin/HRB%20158855%20B" }],
  "includeNetwork": true,
  "includePublications": true,
  "maxPublications": 10
}
```

#### Daily watch list with alerts to Slack

```json
{
  "startUrls": [
    { "url": "https://www.northdata.com/Siemens%20AG,%20M%C3%BCnchen/HRB%206684" },
    { "url": "https://www.northdata.com/Zalando%20SE,%20Berlin/HRB%20158855%20B" }
  ],
  "onlyNewOrChanged": true,
  "monitoringKey": "suppliers",
  "slackWebhookUrl": "https://hooks.slack.com/services/..."
}
```

#### Companies in liquidation or terminated

```json
{
  "searchQueries": ["Bäckerei"],
  "statuses": ["liquidation", "terminated"],
  "maxResultsPerQuery": 45
}
```

#### Monitoring mode

Turn on **Monitoring: only new or changed companies** and schedule the actor. The first run saves every company; later runs save only companies whose name, status, legal form, register, address, capital, headline figures, number of officers, insolvency, register history or publications changed, with `changedFields`, `previousValues`, `newEvents` and `newPublications`. Unchanged companies are not returned; their check is charged as a monitoring page. For a watch list, give the companies as URLs; with search queries, a "new" company is one newly among the first results of the search. **Monitoring: report companies gone** returns a company given by URL whose profile is no longer on North Data.

#### People (optional, personal data)

**Include officers and people (personal data)** adds the officers by name with their role, city and dates, the changes of directors in the register history, the people in the network, person results of a search and person profiles. Without it, rows have the number of officers per role and register texts keep the role without the name.

### How much does it cost to scrape North Data?

Pay per event; the prices are also on the **Pricing** tab. Platform costs are included.

| Event | Price | When |
|---|---|---|
| Company saved in the dataset | **$0.95 / 1 000** (Bronze $0.91, Silver $0.85, Gold and higher $0.81) | every saved row |
| Company profile | $2.44 / 1 000 | a saved row with its profile read (the default; off with **Read company profiles**) |
| Actor start | $0.005 per run | once per run |
| Company network | $0.50 / 1 000 | a saved company with its network, only with **Add company network** |
| Contact details | $1.00 / 1 000 | a saved company with at least one contact found, only with **Add contact details** |
| Risk rating | $0.30 / 1 000 | a saved company with North Data's risk rating, only with **Add North Data risk rating** (around a point it is included) |
| Monitoring page | $0.50 / 1 000 | monitoring mode: a profile read whose company did not change |
| Extra page | $0.50 / 1 000 | pages that saved nothing: profiles left out by a figure, industry or risk filter, company URLs North Data does not know, the first page of a search that saved nothing and search pages over one per 15 saved, charged as they are read. If the saved companies don't cover a run's cost, the difference is charged as extra pages; the log says how many. A normal run pays nothing here. |
| Notification | $0.001 per run | a run that sent its notification |

| Typical run | Price (Free plan) | Typical time |
|---|---|---|
| 5 companies (the example input) | $0.022 | under a minute |
| 1 000 companies with profiles | $3.39 | about 20 minutes |
| 1 000 companies around a point, without profiles | $0.96 | about a minute |
| Daily watch list of 100 companies, 3 changed | $0.06 | about 2 minutes |

You can set a maximum cost per run; the actor stops when it is reached.

### Input example

```json
{
  "searchQueries": ["Zalando"],
  "maxItems": 5,
  "maxResultsPerQuery": 5,
  "language": "en",
  "includeFinancials": true,
  "includeEvents": true
}
```

### Output example

```json
{
  "id": "northdata:5035050244767744",
  "source": "northdata",
  "url": "https://www.northdata.com/Zalando%20SE,%20Berlin/Amtsgericht%20Charlottenburg%20(Berlin)%20HRB%20158855%20B",
  "recordType": "company",
  "northDataId": "5035050244767744",
  "name": "Zalando SE",
  "legalForm": "SE",
  "status": "active",
  "registerId": "District Court of Charlottenburg (Berlin) HRB 158855 B",
  "registerCourt": "District Court of Charlottenburg (Berlin)",
  "registerType": "HRB",
  "registerNumber": "158855 B",
  "euid": "DEF1103R.HRB158855B",
  "lei": "529900YRFFGH5AXU4S86",
  "stockSymbols": ["ZAL.SW", "ZAL.WA", "ZLNDY", "ZAL.DE", "ZLDSF"],
  "address": "Valeska-Gert-Str. 5, 10243 Berlin, Germany",
  "street": "Valeska-Gert-Str. 5",
  "postalCode": "10243",
  "city": "Berlin",
  "country": "DE",
  "corporatePurpose": "The development, marketing and provision of internet services (e-commerce trade …",
  "industry": "Auctioning in the retail trade without a pronounced focus",
  "capital": 2020,
  "capitalCurrency": "EUR",
  "latestRevenue": 12345182791,
  "latestRevenueYear": 2025,
  "latestRevenueCurrency": "EUR",
  "latestEarnings": 215084018,
  "latestTotalAssets": 9691079983,
  "officerCount": 10,
  "officerRoles": { "CEO": 1, "Member of the Executive Board": 4, "Authorized signatory (ppa)": 5 },
  "shareholderCount": 5,
  "participationCount": 49,
  "events": [{ "date": "2026-04-24", "category": "capital", "text": "Capital: €2,020.00", "isCurrent": true, "source": "Hrcdd", "url": "https://www.northdata.com/?id=…" }],
  "hasInsolvency": false,
  "riskLevel": "low",
  "riskSignals": [],
  "searchQuery": "Zalando SE",
  "searchRank": 1,
  "matchScore": 1.0,
  "profileScraped": true,
  "scrapedAt": "2026-11-18T10:00:00+00:00"
}
```

Extra export formats: a printable HTML report or a Markdown table of the results, besides Excel, CSV and JSON (**Export formats**).

### Limitations

- **A name or keyword search shows at most 45 companies** (what North Data shows visitors without an account). Use more specific queries, or several, for more. The filters of the actor work on those 45; North Data's own advanced search needs an account and is not used.
- For some single words North Data answers with one company instead of a list; the actor then adds the website's suggestions. Add the legal form ("Zalando SE") or the register number to get the exact company first.
- **Figures are only what the registers publish:** many small companies publish none, and North Data shows some figures (often revenue and employees of small companies) only to its subscribers: `premiumOnlyMetrics` names them; they are not returned. VAT numbers and shareholders' names are not on the public profile.
- **North Data accepts only a few requests a minute;** the actor reads at its pace, so 1 000 companies with profiles take about 20 minutes. Without a proxy a run reads about 13 pages a minute.
- **Contact details** exist only for companies with a publication that contains them (for example entries in the EU Transparency Register); most small companies have none.
- **Around a point:** North Data places companies whose address it could not locate exactly on the centre of their city, so a point right on a city centre also returns such companies from all over the city. Use a point a little off the centre (or check `postalCode`). Businesses registered under a person's name without a legal form are left out unless personal data is on.
- North Data's own risk rating (`northDataRiskLevel`) comes with the companies found around a point and, as a paid option, for the others; a company given by URL is rated when its search shows its map point.
- **Industry codes** come from the industry name North Data shows; for a few names (older classifications) the code is not known and `naceCode` stays empty, and **NACE codes** then leaves the company out. NAICS and ISIC codes, VAT numbers and the rules of representation are not on the public pages.
- `riskLevel` is a plain reading of the public register data, not a credit rating.
- Corporate purposes on northdata.com and northdata.fr are North Data's translations; the German original is on northdata.de (**Language** de).
- Without personal data, register texts that name people keep only the role ("Managing Director"); a sole trader's business name contains the owner's name and stays as registered.
- A request the website rejects is asked again later; if rejections continue, the run stops with what it has saved and says so. The actor never solves captchas or other challenges.

### For AI agents and API users

Call the actor through the Apify API or Apify's MCP server with `searchQueries` or `startUrls`. Use **Compact rows** (`compactOutput`) for a short row per company and **Leave out empty fields** (`omitEmptyFields`) for slimmer JSON. The run summary is in the key-value store as `SUMMARY`.

### Troubleshooting

- **0 results for a search:** check the spelling on northdata.com; the status says "no results" or "no close match".
- **"North Data refused the requests":** run again later, or keep the default Apify Proxy setting.
- **A company is missing from a name search:** add the legal form or the register number, or paste its North Data URL.

### Integrations

Connect the results to the tools you already use with the built-in integrations of Apify (the **Integrations** tab of the actor or of a saved task), with no code:

- **Google Sheets or Google Drive:** the results of every run in a spreadsheet or a file.
- **Zapier, Make and n8n:** start a workflow when a run finishes, or start the actor from one.
- **Slack or e-mail:** a message from Apify when a run finishes or fails.
- **Webhooks:** your own address gets the details of each run.
- **API and MCP:** run the actor from your code, or let an AI assistant run it through the Apify MCP server.

The results also download as Excel, CSV, JSON or XML from the **Output** tab.

### Privacy and error reports

When a run fails, the actor sends its developer a short error report: the error, the run ID and your input with secrets left out (tokens, webhooks, e-mails and similar values are hidden). Your results are never sent. Reports are deleted after at most 120 hours (5 days). To send nothing, turn off **Send error reports** (`sendErrorReports: false`). Questions about your data: open an issue in the **Issues** tab of this actor.

### WhatsApp notifications: setup

The actor sends the message from your own WhatsApp business number through the WhatsApp Cloud API of your Meta business account. You need a Meta business account; the actor uses only the values you enter in the **Notifications** section (the token and the numbers are stored encrypted and never written to the log).

1. **Create an app.** In Meta for Developers open **My Apps → Create app** and choose the use case **Connect with customers through WhatsApp**.
2. **Get a sending number.** In the app open **WhatsApp → API Setup**. You can start with the test number Meta gives you and add your own business number there later. Copy the **Phone number ID** (not the number itself) into **WhatsApp phone number ID**.
3. **Confirm the recipients (test number only).** A test number sends only to numbers on its list: in **API Setup**, under **To**, add each recipient's number and confirm it with the code WhatsApp sends to it.
4. **Create a permanent access token.** The token shown in API Setup expires within hours. In **Business settings → System users** add a system user, use **Assign assets** to give it your app (and your WhatsApp account), then **Generate token** for the app with the permissions `whatsapp_business_messaging` and `whatsapp_business_management` and the expiry you want. Paste it into **WhatsApp access token**.
5. **Create a message template (recommended).** In **WhatsApp Manager → Message templates → Create template** choose the category **Utility**, a name (e.g. `apify_results`) and a language, and write a body with two variables, for example: `New results of your Apify task: {{1}} Open the dataset: {{2}} (sent automatically after each run).` Meta does not accept a body that starts or ends with a variable and asks for sample values (e.g. `3 new jobs` and a dataset link); keep the text factual, a promotional text is moved to the Marketing category. Approval can take up to 24 hours. Enter the name in **WhatsApp template name** and its language code (e.g. `en_US`, `cs`, `pl`, `de`, as WhatsApp Manager shows it) in **WhatsApp template language**.
6. **Enter the recipients.** **WhatsApp recipient number** takes up to 5 numbers with the country code (e.g. `+420601234567`), separated by commas or new lines. Each number gets its own message.

**What the message contains.** With a template: `{{1}}` is the run summary with the first results on one line (title, company or price, place; never descriptions or contacts) and `{{2}}` the link to the dataset. A template with only `{{1}}` works too, it then gets the link at the end. Without a template the actor sends a text message with one link per result, like in Slack or Telegram.

**Without a template** WhatsApp delivers the message only when the recipient wrote to your business number in the last 24 hours (the customer service window), so a daily or hourly schedule needs a template. The run log says so once per run.

**What it costs.** Meta bills your business account, not this actor: per delivered message, by the message category (a template of the Utility category, or a service message for text in the 24-hour window, with a monthly free allowance per business number) and by the recipient's country. The current rates are in Meta's pricing of the WhatsApp Business Platform. The actor's own notification charge (see the **Pricing** tab) is once per run that delivered its notification, whatever the number of channels and recipients.

**Checked at the start.** When the run starts, the actor checks the token, the phone number ID and, when the token shows its WhatsApp account, the template (name, language, approval), without sending anything. Settings that can't work stop the run with a message that says what to fix, before anything is read from the website.

**When nothing arrives**, the run log names the WhatsApp error and what to do: a template that does not exist in that language or is not approved yet, a template with another number of variables, a recipient missing from the test number's list, an expired token, or the 24-hour window. A failed notification never fails the run and is not charged. Meta can accept a message and still not deliver it later (for example when the recipient's phone is not on WhatsApp); such a run counts as notified.

### FAQ

#### Is it legal to scrape North Data?

It reads only publicly available company profiles, without logging in, at the website's pace, and never solves captchas or other challenges. The data comes from official public registers. It returns names of people only if you turn on **Include officers and people (personal data)**; then you are responsible for processing them lawfully (GDPR). The website's terms of use may restrict extracting its data; you are responsible for how you use the data (privacy laws, database rights and the website's terms). If in doubt, consult a lawyer. This actor is not affiliated with North Data.

#### Why are revenue or employees empty?

The company did not publish them, or North Data shows them only to its subscribers (`premiumOnlyMetrics` says which).

#### Can I search by register number?

Yes: type "HRB 6684" or "Amtsgericht München HRB 6684" into **Search queries**, or paste the company's URL.

#### Do I need a proxy?

No setup needed: the default Apify Proxy setting works and costs you nothing extra.

#### Can I use it from an AI agent or through MCP?

Yes. Use **Compact rows** for smaller rows, and call the actor through the Apify API or Apify's MCP server.

Also known as a North Data API, Handelsregister scraper, German company data API or company register export (German: "Firmendaten Handelsregister", "Unternehmensdaten", "Handelsregisterauszug", "Firmenmonitoring").

# Actor input Schema

## `searchQueries` (type: `array`):

What to look up, as you would type it on North Data: a company name (Zalando SE, Bosch), a keyword (Bäckerei, software), a register number (HRB 6684) or the name of a person. Each query is a separate search with up to 45 results (what North Data shows); use "Max results per search" 1 for the best match of each name in a list.

## `maxItems` (type: `integer`):

Maximum number of rows saved in the run (all searches and URLs together). You pay per saved row. 0 = no limit.

## `maxResultsPerQuery` (type: `integer`):

How many companies each search query returns, best matches first (1–45; North Data shows at most 45 per search). 1 = only the best match of each name.

## `aroundPoints` (type: `array`):

Every company registered within a radius of a map point: latitude, longitude and radius in km (e.g. 52.5219, 13.4132, 0.3 around Alexanderplatz, Berlin). Up to 10,000 companies per point, with North Data's own risk rating; ideal for local lead lists. Combine with the filters (legal form, status, ...).

## `maxResultsPerPoint` (type: `integer`):

How many companies each point returns (1–10,000).

## `startUrls` (type: `array`):

Company profiles (https://www.northdata.com/Siemens%20AG,%20M%C3%BCnchen/HRB%206684, also from northdata.de or northdata.fr), search pages (https://www.northdata.com/search?query=siemens) and, with personal data on, person profiles. A company URL is always read, whatever "Max results per search" is.

## `language` (type: `string`):

Language of the labels, register events, roles and the translated corporate purpose. Names, addresses and register numbers stay as registered.

## `resultType` (type: `string`):

What a search keeps. People are directors and owners with the companies they are linked to; they need "Include officers and people (personal data)".

## `readCompanyProfiles` (type: `boolean`):

Open every company's profile for the register details, address, purpose, published figures, register history and legal structure (charged as "Company profile"). Off = only what the search shows (name, city, country, register, status, map point): faster and cheaper.

## `includeFinancials` (type: `boolean`):

Revenue, earnings, employees, total assets, equity, public funding and patents per year with the publication they come from, and the balance sheet of listed companies. Only what the registers publish: many small companies have none, and some figures North Data shows only to its subscribers (premiumOnlyMetrics names them).

## `includeEvents` (type: `boolean`):

Dated register events: registration, name, legal form and register changes, capital, address moves, mergers, liquidation, insolvency, trademarks, patents and public funding. Changes of directors only with personal data on.

## `maxEvents` (type: `integer`):

Newest register events kept per company (0 = all).

## `includePublications` (type: `boolean`):

Register announcements and other publications about the company (date, source, summary, link).

## `includeMentions` (type: `boolean`):

Publications that mention the company (e.g. of its parent or subsidiaries).

## `maxPublications` (type: `integer`):

Newest publications and mentions kept per company (0 = all).

## `includeNetwork` (type: `boolean`):

Parent companies, subsidiaries and companies linked by address or control, with the relationship (e.g. "Direct parent company", "100 % limited partnership capital"). One more page per company, charged as "Company network". Connected people only with personal data on.

## `networkMaxNodes` (type: `integer`):

With "Add company network": at most this many linked companies (and people), the directly linked ones first. Empty or 0 = all North Data shows.

## `includeRiskRating` (type: `boolean`):

North Data's own risk rating (green, yellow, red: sanctions lists, legal proceedings) for every company, charged as "Risk rating" only where it was found. Companies around a point have it at no extra cost.

## `includeContactDetails` (type: `boolean`):

Website, phone numbers and e-mail addresses that the company itself published (e.g. in the EU Transparency Register), where North Data has such a publication; charged as "Contact details" only for companies with at least one found. Not for sole traders unless personal data is on.

## `includePersonalData` (type: `boolean`):

Names of directors, board members and authorised signatories with their roles, cities and dates, the changes of directors in the register history, connected people in the network, people in search results and person profiles. This is personal data: you are responsible for processing it lawfully (GDPR). Off = only the number of officers per role.

## `countries` (type: `array`):

Keep only companies registered in these countries: ISO codes or English names, e.g. DE, AT, CH, Germany, France, United Kingdom.

## `statuses` (type: `array`):

Keep only companies with these statuses.

## `legalForms` (type: `array`):

Keep only these legal forms, e.g. GmbH, AG, SE, UG (haftungsbeschränkt), GmbH & Co. KG, KG, e. K., Ltd., SAS, B.V., s.r.o., sp. z o.o.

## `naceCodes` (type: `array`):

Keep only companies in these industries: NACE codes or their beginnings (62 = IT services, 62.1, 47.91). From the industry North Data shows; companies without a known code are left out.

## `includeKeywords` (type: `array`):

Keep only companies whose name, city, industry or corporate purpose contains all of these words.

## `excludeKeywords` (type: `array`):

Leave out companies whose name, city, industry or corporate purpose contains any of these words.

## `onlyMatchingNames` (type: `boolean`):

Keep only companies whose name (or former name) contains every word of the query, or whose register number is the number in the query. North Data also returns companies linked to the query in other ways (shareholders, publications).

## `onlyWithFinancials` (type: `boolean`):

Leave out companies without any published figure.

## `minEmployees` (type: `integer`):

Keep only companies whose latest published employee number is at least this.

## `minRevenue` (type: `integer`):

Keep only companies whose latest published revenue is at least this (in the company's currency, e.g. 1000000 = €1M).

## `riskLevels` (type: `array`):

Keep only companies with these risk levels (riskLevel: high = terminated, in liquidation, insolvency in the last 3 years or flagged by North Data; medium = losses, frequent changes of directors or address, a young company or an older insolvency).

## `compactOutput` (type: `boolean`):

A short row per company: identity, register, address, headline figures, contacts and risk, without the lists (figures per year, history, publications, network).

## `omitEmptyFields` (type: `boolean`):

Drop fields without a value from each row, for a slimmer export.

## `onlyNewOrChanged` (type: `boolean`):

Return new companies and companies whose name, status, legal form, register, address, capital, headline figures, number of officers, insolvency, register history or publications changed, with the changed fields, the previous values and the new register events and publications. For a watch list, give the companies as URLs; with search queries, "new" means newly among the first results.

## `monitoringKey` (type: `string`):

Name of the remembered state; use a different key for every watch list. Empty = "default".

## `includeUnchanged` (type: `boolean`):

Return the unchanged companies too, with changeType unchanged (charged like any row).

## `includeRemoved` (type: `boolean`):

A company you gave as a URL whose profile is no longer on North Data is returned once with changeType removed.

## `telegramBotToken` (type: `string`):

Token of your bot from @BotFather.

## `telegramChatId` (type: `string`):

Chat, group or channel to send to (e.g. 123456789 or -1001234567890).

## `slackWebhookUrl` (type: `string`):

Incoming webhook (https://hooks.slack.com/...).

## `discordWebhookUrl` (type: `string`):

Webhook of your Discord channel (https://discord.com/api/webhooks/...). In Discord: channel settings → Integrations → Webhooks → Copy Webhook URL. Stored encrypted.

## `webhookUrl` (type: `string`):

Any HTTPS URL (Zapier, Make, n8n, your server): receives the companies as JSON.

## `whatsappAccessToken` (type: `string`):

Access token of the WhatsApp Cloud API of your Meta business account, used with "WhatsApp phone number ID" and "WhatsApp recipient number" (step by step in the README, section "WhatsApp notifications: setup"). For scheduled runs use a permanent token of a system user: Business settings → System users → Generate token, with the permissions whatsapp_business_messaging and whatsapp_business_management; the token of WhatsApp → API Setup expires within hours. Stored encrypted.

## `whatsappPhoneNumberId` (type: `string`):

ID of your WhatsApp business number that sends the message (not the number itself), e.g. 106540352242922. In your Meta app: WhatsApp → API Setup → Phone number ID.

## `whatsappTo` (type: `string`):

Phone number that gets the message, in international format with the country code (e.g. +420601234567); up to 5 numbers separated by commas or new lines, each gets its own message and the notification is charged once per run. A test number of Meta sends only to numbers you added and confirmed under API Setup → To. Stored encrypted.

## `whatsappTemplateName` (type: `string`):

Name of your approved message template (WhatsApp Manager → Message templates, e.g. apify_results), recommended: WhatsApp delivers a template message at any time. Its body gets the run summary with the first results in {{1}} and the dataset link in {{2}} (a template with only {{1}} gets both in {{1}}). Empty: a plain text message, which WhatsApp delivers only when the recipient wrote to your business number in the last 24 hours, so a scheduled run usually needs a template. Meta charges your business account for template messages (step by step in the README, section "WhatsApp notifications: setup").

## `whatsappTemplateLanguage` (type: `string`):

Language code of the template exactly as WhatsApp Manager → Message templates shows it next to the template, e.g. en_US, en_GB, cs, sk, pl or de. Used only with "WhatsApp template name".

## `webhookHeaders` (type: `object`):

HTTP headers sent with the webhook, e.g. {"Authorization": "Bearer <your token>"} for a server that needs a key. Header values are hidden in error reports.

## `notificationLimit` (type: `integer`):

How many companies the message lists.

## `notifyOnlyChanges` (type: `boolean`):

No message after a run that saved nothing.

## `proxyConfiguration` (type: `object`):

North Data accepts only a few requests a minute from one address: Apify Proxy (automatic, no extra cost) keeps bigger runs fast and reliable. Without a proxy the run reads about 13 pages a minute.

## `maxConcurrency` (type: `integer`):

Pages read at the same time, each at North Data's pace (1–10; about 13 pages a minute each). Without a proxy always 1.

## `exportFormats` (type: `array`):

Off by default. Printable HTML report: the results as a clean, branded table with the main columns, made for printing, saving as PDF or sending to someone; for working with the data use Excel or CSV, which have every field. Markdown table: the same columns as text for AI tools, docs or GitHub. The Output tab links the files. Each file has the overview columns of every saved row and nothing is left out, so a run with tens of thousands of rows makes a file of tens of MB that can be slow to open; for big runs use the dataset or its Excel export. Excel (XLSX), CSV and JSON are always in the Output tab and under Export, at no extra cost.

## `sendErrorReports` (type: `boolean`):

When a run fails, send the developer a short error report: the error and your input with secrets left out (tokens, webhooks and e-mails are hidden). Your results are never sent. Reports are deleted after at most 120 hours. Turn off to send nothing.

## Actor input object example

```json
{
  "searchQueries": [
    "Zalando"
  ],
  "maxItems": 5,
  "maxResultsPerQuery": 10,
  "maxResultsPerPoint": 100,
  "language": "en",
  "resultType": "companies",
  "readCompanyProfiles": true,
  "includeFinancials": true,
  "includeEvents": true,
  "maxEvents": 30,
  "includePublications": false,
  "includeMentions": false,
  "maxPublications": 20,
  "includeNetwork": false,
  "includeRiskRating": false,
  "includeContactDetails": false,
  "includePersonalData": false,
  "onlyMatchingNames": false,
  "onlyWithFinancials": false,
  "compactOutput": false,
  "omitEmptyFields": false,
  "onlyNewOrChanged": false,
  "includeUnchanged": false,
  "includeRemoved": false,
  "whatsappTemplateLanguage": "en_US",
  "notificationLimit": 10,
  "notifyOnlyChanges": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "maxConcurrency": 6,
  "exportFormats": [],
  "sendErrorReports": true
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

## `excel` (type: `string`):

All saved rows as an Excel file, with every field.

## `htmlReport` (type: `string`):

The saved rows with the main columns as a clean table to print, save as PDF or send; only when "Extra export formats" includes it. Excel has every field.

## `markdown` (type: `string`):

The saved rows as a Markdown table, handy for AI tools, docs and GitHub; only when "Extra export formats" includes Markdown.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "Zalando"
    ],
    "maxItems": 5,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("tsutseisoftware/northdata-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["Zalando"],
    "maxItems": 5,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("tsutseisoftware/northdata-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "Zalando"
  ],
  "maxItems": 5,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call tsutseisoftware/northdata-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tsutseisoftware/northdata-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/YTWTvqboAfdYBQd1W/builds/LIhafnhyNJ5Sz3ccT/openapi.json
