# North Data Scraper - EU Company Register, Officers & Financials (`topapi/northdata-scraper`) Actor

Scrape North Data company records by name, person, register number, address or URL: register and court, status, address, LEI, officers with roles, yearly financials, history, publications, linked companies. Monitor mode. $0.90 per 1,000 companies, no login.

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

## Pricing

from $0.90 / 1,000 company records

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

### What does North Data Scraper do?

**North Data Scraper** collects company records from [North Data](https://www.northdata.com), the search engine over Europe's official company registers (German Handelsregister, UK Companies House, French Sirene, Dutch KvK, Belgian KBO, Danish CVR, Swiss, Austrian, Polish, Nordic and more registers). One row per company: register court and number, legal form, status, registered address, LEI and EUID, corporate purpose, industry, share capital, officers with their roles, yearly financial figures, the latest balance sheet, the register timeline, register publications and linked companies. Compliance, KYB, credit, M\&A and B2B sales teams use it to check and enrich companies without opening the register of each country.

- 🔎 **Search like on northdata.com**: company names, brands, keywords, register numbers (`HRB 6684`) or person names, or paste North Data company, person and search links
- 📍 **Street addresses**: every company registered at an address
- 🏛️ **The full company profile in every row**: register parts, all current and former registers, LEI, EUID, tickers, former names and addresses, purpose, industry, capital
- 👔 **Officers**: managing directors, board members, authorised signatories with role, city and North Data link, plus the count per role
- 💶 **Financials**: yearly revenue, earnings, employees, total assets, public funding and patents with the publication each figure came from, and the balance sheet tree
- 📅 **Timeline and publications**: registration, name, address, capital, statute, merger, acquisition, liquidation and termination events, management changes, register publications and the companies they name
- 🎯 **Filters before you pay**: countries, status, legal form, city, register court, name words, founding date, revenue, employees, officers, insolvency, LEI
- 💸 **Cheap list mode**: search-result rows only (name, city, country, register, status mark, coordinates) at a lower price, 15 rows per request
- 🔁 **Monitor mode** for scheduled runs: only companies that are new or whose register data changed, with the changed fields named, and Slack, Discord, Telegram or webhook alerts
- 🔓 No North Data account, no cookies, no API key

### What data can you get from North Data?

| | | |
|---|---|---|
| 🏢 Name, legal form, status | 🏛️ Register court, type, number | 🆔 LEI, EUID, tickers, national ids |
| 📍 Street, postcode, city, country | 🗺️ Coordinates (search results) | 🏘️ Every company at the same address (link) |
| 📜 Corporate purpose | 🏭 Industry segment | 💰 Share capital and date |
| 👔 Officers with role, city, link | 🧮 Representatives per role | 🔗 Linked companies (parent, shareholder, merger) |
| 📈 Revenue, earnings, employees, total assets | 📊 Yearly series with source publication | 🧾 Balance sheet lines |
| 📅 Founding and registration date | 🕰️ History: name, address, capital, statute, M\&A | 🚪 Liquidation, termination, insolvency |
| 📰 Register publications, newest first | 💬 Mentions in other companies' filings | 🔁 New / changed, changed fields, first seen |
| 🧑 Person records: companies, role, latest filing | | |

### How to scrape North Data with North Data Scraper

1. [Create a free Apify account](https://console.apify.com/sign-up) (it comes with monthly free credit).
2. Open **North Data Scraper** and type a company name such as `Zalando`, a register number such as `HRB 6684`, or paste a link from northdata.com.
3. Pick countries, status or other filters if you need them, and the number of rows.
4. Click **Start** and download the companies as JSON, CSV, Excel or HTML, or read them through the API.

### ⬇️ Input

Everything is optional; an empty form runs a small sample search.

| Input | What it does |
|---|---|
| **Company, person or register number** (`searchQueries`) | One search per line. North Data shows up to 45 matches per search to visitors without a subscription. A name that matches one company exactly opens that company; when you ask for more rows, North Data's own suggestions for the same words follow it. |
| **North Data URLs** (`startUrls`) | Company pages, person pages and search links from northdata.com, .de or .fr, or a text file of them. A company link always reads the full profile. |
| **Street addresses** (`addresses`) | `Dieselstr. 6, 48361 Beelen, Germany`: every company registered there. German and Dutch postcodes get North Data's own `D-` / `NL-` form automatically; you can also paste the address link from any company page. |
| **Record type** (`resultType`) | Companies, people (officers, managers) or both. |
| **Maximum rows** (`maxItems`) / **per search** (`maxResultsPerQuery`) | Caps for the run and per search. Default 20 rows. |
| **Countries** (`countries`) | Keep only these countries. With a country set, each search also asks North Data's country-filtered suggestions, so you get more matches from that country than the global 45. |
| **Company status** (`statuses`) | Active, in liquidation, terminated, insolvency. Terminated and liquidation marks are read from the search result itself, so filtered companies cost no profile read. |
| **Legal forms**, **Cities**, **Register courts**, **Name must / must not contain** | Word filters on the search rows (e.g. `GmbH`, `München`, `Charlottenburg`, `Holding`). |
| **Founded on or after / before / within the last days** | Founding date window. |
| **Register publication after** (`publishedAfter`) | Only companies with a filing, officer change or report since this date. |
| **Minimum / maximum revenue**, **Minimum employees**, **Only companies with published figures**, **Minimum officers**, **Insolvency events**, **Only companies with an LEI** | Profile filters. |
| **Read the full company profile** (`includeDetails`) | On (default): one company page per row. Off: search-result rows only, at the listing price. Profile filters and monitor mode switch it on. |
| **Officers / Financials / History and events / Publications and mentions / Linked companies** | Leave a part out of the rows (same price). |
| **Events per timeline** (`maxEvents`, 50) / **Publications per company** (`maxPublications`, 25) | How many of the newest events and publications to keep; `publicationCount` always holds the total. |
| **Language** | English (northdata.com), German (.de) or French (.fr) labels for roles, events and register names. |
| **Compact rows** / **Leave out empty fields** | Short rows or rows without empty fields. |
| **Monitor mode**, **Monitor name**, **What to deliver**, **Also deliver unchanged**, **Reset monitor memory** | Scheduled watch lists (see below). |
| **Webhook / Slack / Discord / Telegram**, **Companies listed per alert**, **Alert only when something was found** | Alerts at the end of a run. |
| **Delay between requests (ms)**, **Proxy** | North Data limits requests per IP (see Limits). The defaults pace the run; a proxy of your own spreads a large run. |

#### Input JSON

```json
{
  "searchQueries": ["Bosch", "software gmbh berlin"],
  "countries": ["DE"],
  "statuses": ["active"],
  "maxItems": 20
}
```

```json
{
  "startUrls": [{ "url": "https://www.northdata.com/Zalando%20SE,%20Berlin/HRB%20158855" }],
  "monitorMode": true,
  "monitorStoreName": "supplier-watch",
  "slackWebhookUrl": "https://hooks.slack.com/services/..."
}
```

Input names of other North Data actors (`queries`, `search`, `companyUrls`, `maxResults`, `includeNetwork`, `fetchProfiles`, `incrementalMode`, `stateKey`, `excludeKeywords` ...) are accepted too.

#### One row per company, once

The same company found by several searches is delivered and charged once. Search results that are people are kept only with **Record type** people or both.

### ⬆️ Output

A real row from a run on 2026-10-28 (search `Bosch`, countries DE; lists shortened to one or two items):

```json
{
  "recordType": "company",
  "northDataId": "70156952",
  "name": "Bosch Automotive Service Solutions GmbH",
  "legalForm": "GmbH",
  "status": "active",
  "foundingDate": "1971-12-08",
  "registrationDate": "1971-12-08",
  "street": "Am Dörrenhof 1",
  "postalCode": "85131",
  "city": "Pollenfeld",
  "countryCode": "DE",
  "address": "Am Dörrenhof 1, 85131 Pollenfeld, Germany",
  "addressSearchUrl": "https://www.northdata.com/Am%20D%C3%B6rrenhof%201,%20D-85131%20Pollenfeld",
  "register": "District Court of Ingolstadt HRB 86",
  "registerAuthority": "District Court of Ingolstadt",
  "registerType": "HRB",
  "registerNumber": "86",
  "registerWatchName": "Bosch Automotive Service Solutions GmbH, Pollenfeld, Amtsgericht Ingolstadt HRB 86",
  "euid": "DED5701V.HRB86",
  "formerNames": ["SPX Service Solutions Germany GmbH"],
  "corporatePurpose": "Manufacture of special and special tools for motor vehicles",
  "industry": ["Manufacture of other parts and accessories for motor vehicles"],
  "capital": "470,000 DEM",
  "capitalDate": "2004-05-04",
  "officerCount": 3,
  "officers": [
    { "name": "Haberkorn, Eric", "givenName": "Eric", "familyName": "Haberkorn", "role": "Managing Director", "city": "Truchtersheim", "type": "person",
      "url": "https://www.northdata.com/Haberkorn,%20Eric,%20Truchtersheim/dbt" }
  ],
  "currentRepresentatives": [{ "role": "Managing Director", "count": 2 }],
  "history": [
    { "date": "2013-06-18", "category": "name", "text": "Name: Bosch Automotive Service Solutions GmbH", "source": "Hrb",
      "sourceUrl": "http://www.handelsregisterbekanntmachungen.de/skripte/hrb.php?rb_id=700281&land_abk=by", "publicationUrl": "https://www.northdata.com/?id=14899054" }
  ],
  "managementChanges": [
    { "date": "2023-07-18", "category": "management", "text": "Managing Director Eric Haberkorn", "source": "Hrcdd", "publicationUrl": "https://www.northdata.com/?id=6185990919553024" }
  ],
  "hasInsolvencyEvents": false,
  "publicationCount": 125,
  "latestPublicationDate": "2026-09-08",
  "publications": [
    { "date": "2026-09-08", "source": "Eb", "topics": ["AnnualFinancialReport"], "text": "Shareholder: Robert Bosch GmbH", "publicationUrl": "https://www.northdata.com/?id=5620793717424128",
      "viaCompany": { "name": "Robert Bosch GmbH", "url": "https://www.northdata.com/Robert%20Bosch%20GmbH,%20Gerlingen/Amtsgericht%20Stuttgart%20HRB%2014000" } }
  ],
  "linkedCompanies": [
    { "name": "Robert Bosch GmbH", "url": "https://www.northdata.com/Robert%20Bosch%20GmbH,%20Gerlingen/Amtsgericht%20Stuttgart%20HRB%2014000", "relation": "Shareholder", "lastPublicationDate": "2026-09-08" }
  ],
  "northDataUrl": "https://www.northdata.com/Bosch%20Automotive%20Service%20Solutions%20GmbH,%20Pollenfeld/Amtsgericht%20Ingolstadt%20HRB%2086",
  "searchQuery": "Bosch",
  "searchRank": 3,
  "detailsFetched": true,
  "language": "en",
  "scrapedAt": "2026-10-28T09:50:09.272Z"
}
```

For a large listed company the same row also carries `lei`, `tickers`, yearly `financials` (for Siemens AG: 9 years of revenue, earnings, public funding and patents, each with its publication), `balanceSheets` (assets and liabilities trees from the latest annual report), `marketingTech` (funding, patents, trademarks), `mergersAcquisitions` and `mentions`.

#### Fields

| Field | What it holds |
|---|---|
| `name`, `legalForm`, `status`, `statusDate` | Registered name, legal form read from the name, `active` / `in liquidation` / `terminated` / `insolvency` and the date that set it |
| `foundingDate`, `registrationDate` | Founding date; the home register's registration date |
| `street`, `postalCode`, `city`, `countryCode`, `address`, `formerAddresses`, `addressSearchUrl` | Registered address, earlier ones, and the North Data page of every company at that address |
| `register`, `registerAuthority`, `registerType`, `registerNumber`, `registerSource`, `registerWatchName` | The current register entry and its parts |
| `registers`, `formerRegisters`, `nationalIds` | Every register entry (current and former) with source; other national ids (SIRET ...) |
| `lei`, `euid`, `tickers`, `formerNames` | Identifiers and former names |
| `corporatePurpose`, `industry`, `breadcrumbs`, `capital`, `capitalDate` | Purpose, industry segment, share capital |
| `officers`, `officerCount`, `currentRepresentatives`, `knownShareholdings` | Officers (people with a role are current; people without one are former or other links), count per role, number of shareholdings |
| `revenue`, `earnings`, `employees`, `totalAssets`, `equity` (+ `...Year`), `currency`, `financialsEstimated`, `financialsCensored` | Latest published figures; `financialsCensored` names the series North Data shows only to its subscribers for this company |
| `financials`, `balanceSheets`, `financialStatementsYears` | Yearly series with source publication and auditor; balance sheet lines |
| `history`, `managementChanges`, `marketingTech`, `mergersAcquisitions`, `hasInsolvencyEvents` | Timelines, newest first, each event with date, category, text, source register and links |
| `publications`, `publicationCount`, `latestPublicationDate`, `mentions`, `mentionCount`, `linkedCompanies` | Register publications and mentions with source, topics, text and related company; linked companies with relation |
| `latitude`, `longitude` | Coordinates of companies found through the quick search |
| `northDataUrl`, `northDataId`, `searchQuery`, `searchRank`, `matchedQuery`, `detailsFetched`, `language`, `scrapedAt` | Source page and run context |
| `changeType`, `changedFields`, `firstSeenAt` | Monitor mode |
| Person rows: `name`, `givenName`, `familyName`, `city`, `countryCode`, `companies` (name, link, role, terminated, latest publication), `companyCount` | With **Record type** people or both |

Measured fill on 29 companies delivered on 2026-10-28 (searches `Zalando`, `Siemens Energy`, `Bosch` with countries DE): name, legal form, status, founding date, address, register, industry, history and publications 100%; register number 97%; EUID 97%; corporate purpose 97%; current representatives 93%; officers 83%; linked companies 62%; capital 55%; former names 34%; financial series 31%; LEI 14%; revenue 10%. Figures depend on the country and the company's size: small companies publish no figures, and North Data shows some series only to subscribers (`financialsCensored` lists them).

### How can I use North Data data?

- **KYC / KYB and compliance:** confirm register number, court, status, LEI and officers of a counterparty; flag liquidation, termination and insolvency events.
- **Credit and risk:** track capital changes, management changes and published figures; watch a portfolio with monitor mode.
- **Sales and lead generation:** company lists by keyword, country, legal form and city, with managing directors and addresses.
- **M\&A and research:** linked companies, parents and shareholdings named in the filings, merger and acquisition history.
- **Data enrichment:** turn a list of company names or register numbers into structured register records.

### Run it on a schedule (monitor mode)

1. Put your companies in **North Data URLs** (or keep a search), turn on **Monitor mode** and give the watch list a **Monitor name**.
2. Save the input as a task and add a daily or weekly schedule on the **Schedules** tab.
3. The first run delivers every company; later runs deliver only companies that are new or whose name, status, address, register, capital, officers, figures, LEI or latest publication changed, with `changeType` and `changedFields`. A run with no change charges nothing.
4. Add a Slack, Discord, Telegram or webhook address to get the changes as a message.

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

North Data Scraper is pay-per-result. No start fee. Companies removed by your filters, duplicates, companies North Data refused to show, and unchanged companies in monitor mode are never charged.

| Row | Price |
|---|---:|
| Company record (full profile) | **$0.0009** ($0.90 per 1,000) |
| Company listing (search-result row, profile off) | $0.00072 ($0.72 per 1,000) |
| Person record | $0.00072 ($0.72 per 1,000) |

| Example | Price |
|---|---:|
| 20 full company records | $0.018 |
| 100 company listings | $0.072 |
| 5 people | $0.0036 |

Apify platform usage (compute, proxy) is included in these prices.

### Integrations, API, scheduling & MCP

- **Schedules:** run it daily or weekly from the **Schedules** tab; with monitor mode each run returns only new or changed companies.
- **Alerts:** Slack, Discord, Telegram or any webhook, straight from the input.
- **No-code:** Make, Zapier, n8n, Google Sheets, Airtable via [Apify integrations](https://docs.apify.com/integrations).
- **API:** call it from Node.js or Python with `apify-client`; code on the [API tab](https://apify.com/topapi/northdata-scraper/api/python) and the [Apify API reference](https://docs.apify.com/api/v2).
- **MCP / AI agents:** connect Claude, Cursor or any MCP client through the [MCP tab](https://apify.com/topapi/northdata-scraper/api/mcp) and look up companies in plain language; **Compact rows** keeps the answers small.

### More TopApi scrapers

<table>
<tr>
<td>💼 <a href="https://apify.com/topapi/xing-jobs-scraper">XING Jobs Scraper</a>: who is hiring in Germany, Austria and Switzerland</td>
<td>🧭 <a href="https://apify.com/topapi">All TopApi actors</a></td>
</tr>
</table>

### Limits & empty runs

- **45 matches per search:** North Data shows visitors without a subscription at most 45 results per search (15 per page). Use several narrower searches (add a legal form, a city or a word of the name) or set **Countries** for more.
- **Requests per IP:** North Data limits how many pages one IP address may open (measured on 2026-10-28: about 25 to 30 pages, after which that address is refused for 15 minutes or more). The run paces its requests and moves to an Apify datacenter connection and then to a residential one when its address is refused. When every connection is refused, the run stops cleanly: the companies it found but could not open are listed in the `RUN_SUMMARY` record (`rateLimited.unreadUrls`) and are not charged; run them again later. In our tests one run read 25 to 45 full profiles; list mode reads 15 companies per request, so a run returns about 400 listing rows. For large lists, split them over several runs or schedule them.
- **Figures:** small companies publish no figures; for some companies North Data shows revenue, earnings or employees only to its subscribers. Those series are named in `financialsCensored`, never filled with zero.
- **Not on North Data's public pages, so not fields:** VAT ids, phone numbers, e-mail addresses, websites, risk flags, NACE / NAICS codes and ownership percentages (North Data's paid API and premium plan), and the network graph.
- **Coordinates** come with companies found through the quick search; companies from a URL or a suggestion carry none.
- **Empty dataset:** your filters removed every company (the status line says which filter removed how many), the search has no match, or in monitor mode nothing changed. Nothing is charged for an empty run.

### FAQ

#### How many companies can North Data Scraper collect in one run?

About 25 to 45 full company profiles per run in our tests, because North Data limits pages per IP address; the rest are listed in `RUN_SUMMARY` for a later run. In list mode (profile off) about 400 rows per run.

#### Can I look up one company by its register number?

Yes. Type the number with its type, for example `HRB 6684`, or the name and city; an exact match opens the company directly.

#### Which countries does North Data cover?

Germany, Austria, Switzerland, the United Kingdom, France, the Netherlands, Belgium, Luxembourg, Spain, Portugal, Poland, the Czech Republic, Slovakia, Denmark, Sweden, Norway, Finland, the Baltic states, Croatia, Cyprus, Greece, Malta, Romania, Ukraine, Israel and more, with different depth per register.

#### Does it return officers and managing directors?

Yes: every person North Data lists for the company with role, city and North Data link, and the number of current representatives per role.

#### Can I get only new or changed companies?

Yes, with **Monitor mode** on a schedule. Each row then carries `changeType` (`new` / `changed`) and `changedFields`.

#### Can I integrate North Data Scraper with other apps?

Yes: Make, Zapier, n8n, Google Sheets, Slack and more via [Apify integrations](https://docs.apify.com/integrations), or [webhooks](https://docs.apify.com/integrations/webhooks) when a run finishes.

#### Can I use North Data Scraper with the Apify API?

Yes. Start runs and read datasets with `apify-client` for [Node.js](https://apify.com/topapi/northdata-scraper/api/javascript) or [Python](https://apify.com/topapi/northdata-scraper/api/python).

#### Can I use North Data Scraper through an MCP server?

Yes. Open the [MCP tab](https://apify.com/topapi/northdata-scraper/api/mcp), connect Claude Desktop, Cursor or another MCP client, and ask for companies in plain language.

#### Do I need a North Data account, cookies or an API key?

No. The actor reads the pages North Data shows to every visitor.

#### Why did my run return no results?

Usually filters: the status line and `RUN_SUMMARY` give the matches per search and what each filter removed. If the status says North Data refused every request, all of the run's connections were limited at that moment: nothing was charged; run it again a little later or with your own proxy.

#### Your feedback

Found a bug or missing a field? Open an issue on the [Issues tab](https://apify.com/topapi/northdata-scraper/issues/open).

# Actor input Schema

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

Company names, brands, keywords, person names or register numbers, one per line, e.g. "Zalando", "Siemens Energy", "HRB 6684", "bäckerei münchen". North Data URLs pasted here work too.

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

North Data company pages (northdata.com/Zalando%20SE,%20Berlin/HRB%20158855), person pages and search URLs (northdata.com/siemens?offset=0), from northdata.com, .de or .fr. A text file of URLs works too.

## `addresses` (type: `array`):

Addresses with the country, one per line, e.g. "Werner-von-Siemens-Str. 1, 80333 München, Germany": the companies registered there.

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

What to keep from a search: companies, people (officers, managers) or both.

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

Upper limit on rows for the whole run (0 = no limit). Rows are charged only when delivered.

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

Upper limit per search or address (North Data shows at most 45 matches per search signed out). Empty = no per-search limit.

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

Keep only companies in these countries. With a country set, each search also asks North Data's own country-filtered suggestions, so more matches come from that country.

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

Keep only companies in these states.

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

Keep only these legal forms, as written in the company name, e.g. "GmbH", "AG", "Ltd", "SAS", "B.V.", "sp. z o.o.".

## `cities` (type: `array`):

Keep companies whose city contains one of these words, e.g. "Berlin", "München".

## `registerCourts` (type: `array`):

Keep companies whose register entry contains one of these words, e.g. "Munich", "Charlottenburg", "Companies House", "HRB".

## `nameIncludes` (type: `array`):

Keep companies with at least one of these words in the name or a former name.

## `nameExcludes` (type: `array`):

Drop companies with any of these words in the name, e.g. "Holding", "Verwaltungs".

## `foundedAfter` (type: `string`):

Founding date window start (2024-01-01).

## `foundedBefore` (type: `string`):

Founding date window end.

## `foundedWithinDays` (type: `integer`):

Only companies founded in the last N days (pairs with monitor mode for new-company alerts).

## `publishedAfter` (type: `string`):

Only companies with a register publication (filing, officer change, report) on or after this date.

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

Latest published yearly revenue, in the company's currency. Companies without a published figure are skipped.

## `maxRevenue` (type: `integer`):

Latest published yearly revenue upper limit.

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

Latest published employee number at least this (companies without a published figure are skipped).

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

Skip companies with no yearly revenue, earnings, employee or balance figures.

## `minOfficers` (type: `integer`):

Keep companies with at least this many current officers (managing directors, board members, authorised signatories).

## `insolvency` (type: `string`):

Filter on insolvency publications.

## `withLeiOnly` (type: `boolean`):

Keep only companies with a Legal Entity Identifier.

## `includeDetails` (type: `boolean`):

Adds address, register details, LEI, purpose, industry, capital, officers, figures, history, publications and linked companies. Off = cheaper list rows from the search page.

## `includeOfficers` (type: `boolean`):

Every officer North Data lists (managing directors, board members, authorised signatories, former ones without a role) with role, city and person link.

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

Yearly series (revenue, earnings, employees, total assets, public funding, patents) with the publication each figure came from, and the latest balance sheet.

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

Register timeline: registration, name, address, capital and statute changes, management changes, funding, mergers and acquisitions.

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

Dated register publications and mentions with source and linked company.

## `includeRelatedCompanies` (type: `boolean`):

Parents, shareholdings, merger partners and other companies named in the publications, with the relation.

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

Most recent events kept per timeline (history, management changes, funding, M\&A).

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

Most recent publications and mentions kept per company (the total count is always in publicationCount).

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

Language of roles, event texts and register labels. Names, addresses and numbers are always original.

## `compact` (type: `boolean`):

A short row per company: identity, register, address, headline figures and the first 10 officers.

## `excludeEmptyFields` (type: `boolean`):

Drop fields with no value from each row.

## `monitorMode` (type: `boolean`):

Remember companies between runs and return only new or changed ones, with changeType and changedFields.

## `monitorStoreName` (type: `string`):

Named key-value store that holds the monitor memory. Use one name per watch list.

## `monitorEmit` (type: `string`):

New and changed companies, or new ones only.

## `emitUnchanged` (type: `boolean`):

Return every company every run, tagged changeType new / changed / unchanged (each row is charged).

## `resetMonitor` (type: `boolean`):

Forget what earlier runs saw and start over.

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

POST the delivered companies (count + first rows) as JSON to this URL at the end of the run.

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

Post a summary into a Slack channel.

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

Post a summary into a Discord channel.

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

Token of the Telegram bot that sends the summary.

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

The chat or channel that receives the summary.

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

How many companies to list in the message before summarising the rest.

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

Stay silent on runs that delivered nothing.

## `requestDelayMillis` (type: `integer`):

Minimum gap between two requests from the same IP. North Data limits requests per IP; the default (1,200 ms, two at a time) stays fast for small runs. Raise it for gentler runs.

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

Optional. By default the run uses its own connection, then an Apify datacenter IP, then a residential IP, each paced under North Data's per-IP request limit. Set your own proxy here to spread a large run.

## Actor input object example

```json
{
  "searchQueries": [
    "Zalando"
  ],
  "resultType": "companies",
  "maxItems": 5,
  "onlyWithFinancials": false,
  "insolvency": "any",
  "withLeiOnly": false,
  "includeDetails": true,
  "includeOfficers": true,
  "includeFinancials": true,
  "includeEvents": true,
  "includePublications": true,
  "includeRelatedCompanies": true,
  "maxEvents": 50,
  "maxPublications": 25,
  "language": "en",
  "compact": false,
  "excludeEmptyFields": false,
  "monitorMode": false,
  "monitorStoreName": "northdata-monitor",
  "monitorEmit": "newAndChanged",
  "emitUnchanged": false,
  "resetMonitor": false,
  "notificationLimit": 10,
  "notifyOnlyChanges": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

One item per company (or person): register, status, address, identifiers, officers, financials, history, publications and linked companies.

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

Per-search counts (found, delivered, filtered, unchanged, not found, failed), requests per egress and the rate-limit pauses.

# 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": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("topapi/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": False },
}

# Run the Actor and wait for it to finish
run = client.actor("topapi/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": false
  }
}' |
apify call topapi/northdata-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,topapi/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/aEgOaxKbPbNo62aQg/builds/6JcTqTigKSfX4OWc1/openapi.json
