# North Data Company Scraper — EU Registry, Officers & Revenue (`haketa/northdata-scraper`) Actor

Extract European company registry records, CEOs & officers, financial KPIs, VAT/LEI IDs, addresses & corporate filings from North Data across 20+ EU countries (DE HRB, UK, FR SIREN, CH, AT, ES, IT, NL). Export revenue, profit, assets, employees, phones & websites to JSON/CSV.

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

## Pricing

from $2.80 / 1,000 results

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

<h1 align="center">🇪🇺 North Data Company Scraper — EU Registry, Officers & Revenue</h1>

<p align="center">
  <strong>Extract verified European company registry profiles, commercial register IDs (HRB, SIREN, Companies House, UID, FN, KVK, KBO), CEOs &amp; directors, multi-year financial KPIs, VAT/LEI numbers, direct contacts, corporate ownership networks, and official filings across 20+ countries.</strong>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/Coverage-20%2B_European_Registries-0A66C2?style=for-the-badge" alt="20+ European Registries" />
  <img src="https://img.shields.io/badge/Financials-Revenue_%7C_Profit_%7C_Assets-16A34A?style=for-the-badge" alt="Financials" />
  <img src="https://img.shields.io/badge/Governance-CEOs_%26_Board_Officers-7C3AED?style=for-the-badge" alt="Officers" />
  <img src="https://img.shields.io/badge/Contacts-Website_%7C_Phone_%7C_Email_%7C_VAT-EA580C?style=for-the-badge" alt="Contacts & VAT" />
  <img src="https://img.shields.io/badge/Export-JSON_%7C_CSV_%7C_Excel_%7C_API-0F172A?style=for-the-badge" alt="Export Formats" />
</p>

***

**North Data Company Scraper** collects structured corporate intelligence from **North Data**, covering official commercial registries, gazette publications, and financial disclosures across **Germany, the United Kingdom, France, Switzerland, Austria, Spain, Italy, the Netherlands, Belgium, Poland, the Nordics, Luxembourg, Ireland, Central & Eastern Europe**.

Whether you are automating **KYB/KYC entity verification**, screening **M\&A and private equity targets**, enriching **European B2B CRM accounts** with VAT/LEI numbers and direct contact channels, or mapping **executive board mandates**, this Actor turns European company registry searches into clean, analytics-ready datasets in seconds.

> 💡 **Zero-configuration ready:** Run with default settings or empty input `{}` to immediately collect **100 enriched European company profiles** complete with commercial register numbers, active/former directors, financial statements, addresses, and filing history.

***

### ⚡ At a Glance

| Capability | Details |
| :--- | :--- |
| 🌍 **Geographic Coverage** | **24+ European jurisdictions** — `DE`, `GB`, `FR`, `CH`, `AT`, `ES`, `IT`, `NL`, `BE`, `PL`, `SE`, `DK`, `NO`, `FI`, `LU`, `IE`, `PT`, `CZ`, `SK`, `RO`, `HR`, `GR`, `EE`, `LT` |
| 🏛️ **Official Identifiers** | Commercial Register ID (`HRB`/`HRA`, `SIREN`, `Companies House`, `CHE` UID, `FN`, `KVK`, `KBO`, `CVR`, `KRS`), **EUID**, **EU VAT ID**, **LEI Code**, ISO 20275 **ELF Code** |
| 💶 **Financial Statements** | Multi-year **Revenue**, **Net Profit / Earnings**, **Total Assets**, **Equity**, **Equity Ratio**, **Return on Sales**, **Share Capital**, **Employee Headcount**, **Cash**, **Liabilities**, **Auditor** |
| 👔 **Leadership & Governance** | Current & former **Managing Directors (`Geschäftsführer`), CEOs, Presidents, Board Chairs, Directors & Authorized Signatories (`Prokura`)** with appointment/end dates and cities |
| 🕸️ **Corporate Network** | **Parent companies, subsidiaries, shareholders & affiliates** with voting-rights / ownership percentages when published |
| 📇 **Direct B2B Contacts** | Published **corporate websites, phone numbers, fax numbers, email addresses**, full street addresses, postal codes, and GPS coordinates |
| 🔎 **Flexible Search Inputs** | Search by **company name**, **industry keyword**, **commercial register ID**, **executive person name**, or **direct profile URLs** |
| 📦 **Structured Output** | Clean **50+ field** JSON records + flat overview table for one-click **CSV / Excel / Parquet** export |

***

### 🎯 High-Value Use Cases

| Use Case | How Teams Use This Dataset |
| :--- | :--- |
| 🏦 **KYC / KYB & Compliance Onboarding** | Verify legal entity existence, active vs. liquidated status, statutory representation rules, commercial register IDs (`HRB`, `SIREN`, `Companies House`), `EUID`, `LEI`, and `VAT` numbers across Europe. |
| 🤝 **Private Equity & M\&A Target Screening** | Filter mid-market European companies (`GmbH`, `SAS`, `B.V.`, `AG`, `Ltd.`) by industry keywords, evaluate multi-year revenue/profit/equity ratios, and inspect parent-subsidiary structures before outreach. |
| 📞 **European B2B Sales & Executive Lead Gen** | Combine verified legal entity names, NACE industry classifications, employee headcounts, named Managing Directors / Presidents, corporate websites, `+49`/`+33`/`+41`/`+44` phone numbers, and emails. |
| 🛡️ **Supplier & Counterparty Risk Vetting** | Spot liquidation or termination flags, review statutory auditors, audit equity ratios and balance-sheet liabilities, and inspect historical address or management changes. |
| 🗄️ **CRM & Master Data Enrichment** | Append missing `HRB`/`SIREN`/`UID` numbers, EU VAT IDs, founding dates, NACE codes, and latest financial figures to Salesforce, HubSpot, Snowflake, or internal data warehouses. |
| 🧭 **Executive Mandate & Board Mapping** | Search an executive or board member's name to uncover every European company where they currently hold or previously held a statutory leadership mandate. |

***

### 📊 Extracted Data Fields (50+ Structured Attributes)

Coverage indicators reflect verified multi-country production runs across active and historical European entities:

- 🟢 **Core Registry Field** — Populated on virtually all registered companies (`85%–100%`)
- 🟡 **Conditional / Published Field** — Populated whenever disclosed in commercial filings or corporate records (`25%–80%`)

#### 🏛️ Corporate Identity & EU Register IDs

| Field | Type | Coverage | Description |
| :--- | :--- | :---: | :--- |
| `companyId` | `string` | 🟢 | Unique numeric North Data entity identifier |
| `companyName` | `string` | 🟢 | Clean registered company name (e.g., `Robert Bosch GmbH`, `Doctolib SAS`) |
| `rawLegalName` | `string` | 🟢 | Full statutory legal denomination from the commercial register |
| `formerNames` | `string[]` | 🟡 | Historical legal names and previous trade names |
| `legalForm` | `string` | 🟢 | Legal entity form (`GmbH`, `AG`, `SE`, `UG`, `SAS`, `SARL`, `Ltd.`, `PLC`, `B.V.`, `S.L.`, etc.) |
| `elfCode` | `string` | 🟢 | Official ISO 20275 Entity Legal Form code (e.g., `2HBR`, `6CHY`) |
| `status` | `string` | 🟢 | Normalized entity status: `Active`, `Liquidation`, or `Terminated` |
| `isActive` | `boolean` | 🟢 | `true` when the company is currently active |
| `registerId` | `string` | 🟢 | Commercial register number (e.g., `HRB 14000`, `Siren 794598813`, `Companies House 12871051`, `CHE-101.602.521`) |
| `registerAuthority` | `string` | 🟢 | Registering court or national commercial registry (e.g., `District Court of Stuttgart`, `Companies House`, `INSEE / RCS`) |
| `euId` | `string` | 🟢 | European Unique Identifier (`EUID`, e.g., `DEB8534.HRB14000`) |
| `vatId` | `string` | 🟡 | EU Value Added Tax number when published (e.g., `DE811128135`, `FR14794598813`) |
| `leiCode` | `string` | 🟡 | 20-character Global Legal Entity Identifier (`LEI`) |
| `foundingDate` | `string` | 🟢 | Official registration / incorporation date (`YYYY-MM-DD`) |
| `terminationDate` | `string` | 🟡 | Official dissolution / strike-off date (`YYYY-MM-DD`) if terminated |
| `overallRiskLevel` | `string` | 🟢 | Entity risk indicator (`GREEN`, `YELLOW`, `RED`) |
| `naceCode` | `string` | 🟢 | Primary NACE / UKSIC / WZ economic activity code (e.g., `62.01`, `46.6`) |
| `industry` | `string` | 🟢 | Standardized English NACE industry description |
| `segmentCodes` | `object` | 🟢 | Cross-walked industry codes across `nace`, `wz`, `uksic`, `isic`, and `naics` |
| `corporatePurpose` | `string` | 🟢 | Statutory business object / corporate purpose statement |
| `representationPolicy` | `string` | 🟡 | Statutory signing and joint/sole representation rules |

#### 💶 Financials: Revenue, Profit, Assets & Employees

| Field | Type | Coverage | Description |
| :--- | :--- | :---: | :--- |
| `shareCapital` | `number` | 🟢 | Registered base or share capital in numeric units |
| `shareCapitalFormatted` | `string` | 🟢 | Human-readable share capital (e.g., `€25,000`, `€1.20B`) |
| `currency` | `string` | 🟢 | Reporting currency ISO code (`EUR`, `GBP`, `CHF`, `SEK`, `DKK`, `NOK`, `PLN`, etc.) |
| `latestFinancialYear` | `string` | 🟡 | Most recent fiscal year with published KPIs (e.g., `2025`, `2024`) |
| `latestRevenue` | `number` | 🟡 | Most recent annual revenue / turnover (numeric) |
| `latestRevenueFormatted` | `string` | 🟡 | Formatted annual revenue (e.g., `€90.3B`, `€4,900,000`, `£2,900,000`) |
| `latestProfit` | `number` | 🟡 | Most recent annual net profit / earnings (`Earnings`, numeric; negative for net loss) |
| `latestProfitFormatted` | `string` | 🟡 | Formatted net profit / earnings (e.g., `€1.33B`, `€86,215`) |
| `latestAssets` | `number` | 🟡 | Most recent total balance-sheet assets (`BalanceTotal`, numeric) |
| `latestAssetsFormatted` | `string` | 🟡 | Formatted total assets (e.g., `€112.8B`, `€880,912`) |
| `latestEquity` | `number` | 🟡 | Most recent shareholders' equity (numeric) |
| `latestEquityFormatted` | `string` | 🟡 | Formatted shareholders' equity (e.g., `€93.5B`, `€543,708`) |
| `equityRatio` | `number` | 🟡 | Equity-to-assets ratio percentage (e.g., `61.72`) |
| `employees` | `number` | 🟡 | Latest reported or filed employee headcount |
| `financials` | `array` | 🟡 | Multi-year historical array with `date`, `year`, `consolidated`, `currency`, `revenue`, `profit`, `totalAssets`, `equity`, `equityRatio`, `returnOnSales`, `employees`, `cash`, `liabilities`, `taxes`, `auditorName`, `sourceTitle` |

#### 👔 CEOs, Directors & Officers

| Field | Type | Coverage | Description |
| :--- | :--- | :---: | :--- |
| `keyExecutive` | `string` | 🟢 | Primary active decision-maker and title (e.g., `Roger Helena Cornelis Meijers (Managing Director)`) |
| `officersCount` | `number` | 🟢 | Total count of current and historical officers & signatories |
| `activeOfficersCount` | `number` | 🟢 | Count of currently active directors, board members, and signatories |
| `officers` | `array` | 🟢 | Structured list of executives & officers: `name`, `firstName`, `lastName`, `role`, `isCurrent`, `startDate`, `endDate`, `city`, `profileUrl` |

#### 📍 Address, Contacts, Network & Filing History

| Field | Type | Coverage | Description |
| :--- | :--- | :---: | :--- |
| `address` | `string` | 🟢 | Full formatted registered address (e.g., `Boschstr. 8, 45770 Marl, Germany`) |
| `street` | `string` | 🟢 | Street name and building number |
| `postalCode` | `string` | 🟢 | Postal / ZIP code |
| `city` | `string` | 🟢 | Registered municipality / city |
| `state` | `string` | 🟡 | Federal state / region code (e.g., `NW`, `BW`, `BY`) |
| `countryCode` | `string` | 🟢 | ISO 3166-1 alpha-2 country code (`DE`, `GB`, `FR`, `CH`, `AT`, `NL`, etc.) |
| `country` | `string` | 🟢 | Full English country name |
| `latitude` / `longitude` | `number` | 🟢 | Geocoded coordinates of the registered office |
| `website` | `string` | 🟡 | Corporate website URL when published |
| `phone` | `string` | 🟡 | Direct corporate telephone number in international format |
| `email` | `string` | 🟡 | Corporate contact email address when published |
| `relatedCompaniesCount` | `number` | 🟡 | Number of connected parent, subsidiary, or affiliate entities |
| `relatedCompanies` | `array` | 🟡 | Corporate network links (`companyId`, `name`, `registerKey`, `city`, `relationship`, `isCurrent`, `profileUrl`) |
| `publicationsCount` | `number` | 🟢 | Number of official registry filings & historical corporate events |
| `publications` | `array` | 🟢 | Chronological corporate filing history (`date`, `source`, `category`, `summary`, `url`) |
| `companyUrl` | `string` | 🟢 | Canonical North Data company profile URL |
| `searchQuery` | `string` | 🟢 | Input query or URL that matched this company |
| `scrapedAt` | `string` | 🟢 | ISO 8601 UTC extraction timestamp |

***

### 🛠️ Input Parameters

All fields are **optional**. Running with no parameters (`{}`) automatically collects **100 diverse European companies** with full profile enrichment.

| Parameter | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| `queries` | `string[]` | `[]` | Company names (`Siemens`, `Doctolib`), industry keywords (`Robotics`, `Biotech`, `Solar`), register IDs (`HRB 14000`, `Siren 794598813`), or executive names (`Oliver Blume`). |
| `country` | `string` | `"all"` | Filter discovery to a specific European country (`DE`, `GB`, `FR`, `CH`, `AT`, `ES`, `IT`, `NL`, `BE`, `PL`, `SE`, `DK`, `NO`, `FI`, `LU`, `IE`, `PT`, `CZ`, `SK`, `RO`, `HR`, `GR`, `EE`, `LT`) or keep `"all"` for pan-European search. |
| `activeOnly` | `boolean` | `false` | Exclude liquidated, dissolved, and terminated entities so only currently active companies are returned. |
| `includeFullProfile` | `boolean` | `true` | Enrich every company with officers, multi-year financials, VAT/LEI IDs, contacts, corporate network links, and publications. Disable for ultra-rapid basic registry lookup. |
| `startUrls` | `array` | `[]` | Optional direct North Data company profile URLs or search URLs. |
| `maxItems` | `integer` | `0` | Maximum number of unique companies to output (`0` = unlimited for custom queries, `100` for empty input; prefill is `100`). |
| `proxyConfiguration` | `object` | `{"useApifyProxy": true}` | Proxy settings for reliable parallel collection. |

***

### 🧪 Input Recipes & Examples

#### 1. Pan-European Enterprise & Subsidiary Discovery (Default Prefill)

```json
{
  "queries": ["Robotics", "Medtech", "Siemens", "Bosch"],
  "country": "all",
  "activeOnly": false,
  "includeFullProfile": true,
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

#### 2. Active German Mittelstand Robotics & Automation (`GmbH` / `AG`)

```json
{
  "queries": ["Robotics", "Industrial Automation", "Maschinenbau"],
  "country": "DE",
  "activeOnly": true,
  "includeFullProfile": true,
  "maxItems": 250
}
```

<details>
<summary><strong>🇫🇷 3. French SaaS, AI &amp; Healthtech Scale-ups (SIREN + Financials)</strong></summary>

```json
{
  "queries": ["Artificial Intelligence", "Logiciel", "Biotech"],
  "country": "FR",
  "activeOnly": true,
  "includeFullProfile": true,
  "maxItems": 150
}
```

</details>

<details>
<summary><strong>🇨🇭 4. Swiss Holding &amp; Life Sciences Entities (UID / CHE)</strong></summary>

```json
{
  "queries": ["Pharma", "Medtech", "Holding"],
  "country": "CH",
  "activeOnly": true,
  "includeFullProfile": true,
  "maxItems": 100
}
```

</details>

<details>
<summary><strong>👔 5. Executive Mandate &amp; Direct URL Enrichment</strong></summary>

```json
{
  "queries": ["Oliver Blume"],
  "startUrls": [
    { "url": "https://www.northdata.com/Robert%20Bosch%20GmbH,%20Gerlingen/Amtsgericht%20Stuttgart%20HRB%2014000" },
    { "url": "https://www.northdata.com/Doctolib%20SAS,%20Levallois-Perret/Siren%20794598813" }
  ],
  "includeFullProfile": true,
  "maxItems": 50
}
```

</details>

***

### 📄 Sample Output Record (JSON)

```json
{
  "companyId": "4874897978",
  "companyName": "GSG-Robotics GmbH",
  "rawLegalName": "GSG-Robotics GmbH",
  "formerNames": ["GSG-Robotics"],
  "legalForm": "GmbH",
  "elfCode": "2HBR",
  "status": "Active",
  "isActive": true,
  "registerId": "HRB 12439",
  "registerAuthority": "District Court of Gelsenkirchen",
  "euId": "DER2507.HRB12439",
  "vatId": "DE814986443",
  "leiCode": null,
  "foundingDate": "2008-07-17",
  "terminationDate": null,
  "overallRiskLevel": "GREEN",
  "address": "Boschstr. 8, 45770 Marl, Germany",
  "street": "Boschstr. 8",
  "postalCode": "45770",
  "city": "Marl",
  "state": "NW",
  "countryCode": "DE",
  "country": "Germany",
  "latitude": 51.671048,
  "longitude": 7.1595964,
  "website": "https://gsg-robotics.de/de",
  "phone": "+49 2365509000",
  "email": "info@gsg-robotics.com",
  "naceCode": "46.6",
  "industry": "Wholesale of other machinery, equipment and supplies",
  "segmentCodes": {
    "nace": ["46.6"],
    "wz": ["46.6"],
    "uksic": ["46.6"],
    "isic": ["466"],
    "naics": []
  },
  "corporatePurpose": "Trade and distribution of industrial robots and their services",
  "representationPolicy": "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten.",
  "shareCapital": 25000,
  "shareCapitalFormatted": "€25,000",
  "currency": "EUR",
  "latestFinancialYear": "2024",
  "latestRevenue": 4900000,
  "latestRevenueFormatted": "€4,900,000",
  "latestProfit": 86215,
  "latestProfitFormatted": "€86,215",
  "latestAssets": 880911.63,
  "latestAssetsFormatted": "€880,912",
  "latestEquity": 543707.79,
  "latestEquityFormatted": "€543,708",
  "equityRatio": 61.72,
  "employees": 9,
  "financials": [
    {
      "date": "2024-12-31",
      "year": "2024",
      "consolidated": false,
      "currency": "EUR",
      "revenue": 3400000,
      "revenueFormatted": "€3,400,000",
      "profit": 51200,
      "profitFormatted": "€51,200",
      "totalAssets": 748670,
      "totalAssetsFormatted": "€748,670",
      "equity": 543707.79,
      "equityFormatted": "€543,708",
      "equityRatio": 72.62,
      "returnOnSales": 1.51,
      "employees": 9,
      "cash": 25529.52,
      "liabilities": 204961.94,
      "taxes": null,
      "auditorName": null,
      "sourceTitle": "Jahresabschluss zum Geschäftsjahr vom 01.01.2024 bis zum 31.12.2024"
    }
  ],
  "keyExecutive": "Roger Helena Cornelis Meijers (Managing Director)",
  "officersCount": 3,
  "activeOfficersCount": 1,
  "officers": [
    {
      "name": "Roger Helena Cornelis Meijers",
      "firstName": "Roger Helena Cornelis",
      "lastName": "Meijers",
      "role": "Managing Director",
      "isCurrent": true,
      "startDate": "2018-08-27",
      "endDate": null,
      "city": "Sittard",
      "profileUrl": "https://www.northdata.com/Meijers,%20Roger%20Helena%20Cornelis,%20Sittard/88l"
    },
    {
      "name": "Jürgen Willy Fischer",
      "firstName": "Jürgen Willy",
      "lastName": "Fischer",
      "role": "Managing Director",
      "isCurrent": false,
      "startDate": "2012-07-12",
      "endDate": "2017-05-18",
      "city": "Bremen",
      "profileUrl": "https://www.northdata.com/Fischer,%20J%C3%BCrgen%20Willy,%20Bremen/mwv"
    }
  ],
  "relatedCompaniesCount": 3,
  "relatedCompanies": [
    {
      "companyId": "3897366158",
      "name": "THERMCONCEPT GmbH",
      "registerKey": "1228195032703",
      "city": "Bremen",
      "relationship": "Managing Director",
      "isCurrent": true,
      "profileUrl": "https://www.northdata.com/THERMCONCEPT%20GmbH,%20Bremen/HRB%2032703"
    }
  ],
  "publicationsCount": 14,
  "publications": [
    {
      "date": "2025-09-19",
      "source": "Financial Register",
      "category": "Annual Financial Statement",
      "summary": "Jahresabschluss zum Geschäftsjahr vom 01.01.2024 bis zum 31.12.2024",
      "url": "https://www.northdata.com/?id=5172146151882752"
    },
    {
      "date": "2018-08-27",
      "source": "Hrb",
      "category": "Executive / Board Change",
      "summary": "27/08/2018 Managing Director Roger Helena Cornelis Meijers",
      "url": "https://www.northdata.com/?id=4825529597"
    }
  ],
  "companyUrl": "https://www.northdata.com/GSG-Robotics%20GmbH,%20Marl/Amtsgericht%20Gelsenkirchen%20HRB%2012439",
  "searchQuery": "Robotics",
  "scrapedAt": "2026-11-19T12:25:00.000Z"
}
```

***

### 💻 Programmatic Usage (API & SDKs)

#### Node.js (`apify-client`)

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

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });

const run = await client.actor('haketa/northdata-scraper').call({
    queries: ['Robotics', 'Medtech'],
    country: 'DE',
    activeOnly: true,
    includeFullProfile: true,
    maxItems: 100,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Retrieved ${items.length} European companies:`, items[0]);
```

#### Python (`apify-client`)

```python
import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])

run = client.actor("haketa/northdata-scraper").call(
    run_input={
        "queries": ["Fintech", "Cybersecurity"],
        "country": "FR",
        "activeOnly": True,
        "includeFullProfile": True,
        "maxItems": 100,
    }
)

items = client.dataset(run["defaultDatasetId"]).list_items().items
for company in items[:5]:
    print(company["companyName"], company["registerId"], company["latestRevenueFormatted"])
```

#### cURL

```bash
curl -X POST "https://api.apify.com/v2/acts/haketa~northdata-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "queries": ["Siemens", "Bosch"],
    "country": "DE",
    "activeOnly": true,
    "maxItems": 50
  }'
```

***

### 🔌 Workflow Integrations

Connect **North Data Company Scraper** directly to your existing B2B stack:

- **CRM & Outbound:** Push newly registered `GmbH`, `SAS`, and `Ltd.` companies with named Managing Directors, websites, and phones straight into **HubSpot**, **Salesforce**, **Pipedrive**, or **Clay** via Apify integrations or webhooks.
- **Spreadsheets & BI:** Export the curated **Overview** table in one click to **Google Sheets**, **Excel (`.xlsx`)**, **CSV**, or **Power BI / Tableau**.
- **Data Pipelines:** Schedule recurring weekly or monthly runs to monitor financial filings, board changes, and entity status updates into **Snowflake**, **BigQuery**, **PostgreSQL**, or **Amazon S3**.

***

### ❓ Frequently Asked Questions (FAQ)

#### Which European countries and commercial registers are covered?

The scraper covers **24+ European jurisdictions**, including Germany (`Handelsregister HRB/HRA/VR`), the United Kingdom (`Companies House`), France (`SIREN/SIRET & BODACC`), Switzerland (`UID / SHAB`), Austria (`Firmenbuch FN`), Spain (`BORME`), Italy (`S.r.l. / S.p.A.`), the Netherlands (`KVK`), Belgium (`KBO/BCE`), Poland (`KRS`), Sweden, Denmark (`CVR`), Norway (`Brønnøysund`), Finland (`PRH`), Luxembourg (`RCS`), Ireland (`CRO`), Portugal, Czechia, Slovakia, Romania, Croatia, Greece, Estonia, and Lithuania.

#### Can I search by commercial register ID (e.g., `HRB 14000` or `SIREN 794598813`)?

Yes. Enter exact commercial register numbers, `LEI` codes, or `CHE-` UID numbers directly in `queries` to resolve and enrich specific legal entities in bulk.

#### Can I search by an executive or director's name?

Yes. Entering a person's name (such as `Oliver Blume` or `Stanislas Niox-Chateau`) in `queries` automatically resolves the European companies associated with that individual's executive or board mandates and outputs their full company profiles.

#### Why do some small companies have `null` revenue or profit?

Statutory financial disclosure rules vary by European jurisdiction and company size. Large and mid-sized corporations publish full income statements (`Revenue` and `Earnings`), whereas micro-entities (for example, small German `UG`/`GmbH` or UK micro-company filers) are legally permitted to file abridged balance sheets containing only `Total Assets`, `Equity`, and `Share Capital` without top-line revenue.

#### Does the scraper support German umlauts and European accents?

Yes. Queries and company names with characters such as `ä`, `ö`, `ü`, `ß`, `é`, `è`, `ê`, `ç`, `ñ`, `ł`, `ø`, and `å` are preserved accurately.

#### How are multi-query runs balanced when `maxItems` is set?

When you provide multiple search terms in `queries`, the Actor paginates across all queries in round-robin order so every search term contributes evenly rather than exhausting `maxItems` on the first query alone.

#### How fast is full profile enrichment?

A typical run of **100–150 fully enriched European companies** (including officers, multi-year financials, contacts, network links, and publications) completes in **under 45 seconds** using standard Apify Proxy configuration.

***

### ⚠️ Limitations

- **Statutory Disclosure Boundaries:** Contact details (`website`, `phone`, `email`), `vatId`, and full P\&L revenue figures are populated whenever published in North Data's underlying registry and corporate intelligence records; shell holding companies or dormant entities may only carry statutory address, capital, officer, and register data.
- **Per-Query Pagination Depth:** Each individual search keyword paginates up to ~900 matching entities on North Data. To harvest thousands of companies in a broad sector, supply multiple specific industry keywords or combine queries with the `country` filter.
- **Italian Coverage Scope:** While Germany, France, the UK, DACH, Benelux, Nordics, Spain, and CEE have native commercial registry indexing, Italian (`IT`) coverage primarily reflects cross-border corporate filings, EU funding recipients, and international group subsidiaries.

***

### 📋 Changelog

#### v1.0 (2026-11-19)

- Initial release of **North Data Company Scraper**.
- Added pan-European company discovery across 24+ countries with native country filtering (`DE`, `GB`, `FR`, `CH`, `AT`, `ES`, `IT`, `NL`, `BE`, `PL`, `SE`, `DK`, `NO`, `FI`, `LU`, `IE`, and CEE).
- Added full enrichment of commercial register IDs, `EUID`, `VAT`, `LEI`, ISO `ELF` codes, NACE industry classifications, direct B2B contacts (`website`, `phone`, `fax`, `email`), multi-year `financials[]`, active & former `officers[]` with appointment/end dates, `relatedCompanies[]` ownership links, and chronological `publications[]`.
- Added executive person-name mandate resolution, direct `startUrls` support, `activeOnly` filtering, and balanced multi-query pagination.

# Actor input Schema

## `queries` (type: `array`):

Enter company names (e.g., 'Siemens', 'Bosch', 'Doctolib'), industry keywords (e.g., 'Robotics', 'Fintech', 'Biotech', 'Solar Energy'), commercial register IDs (e.g., 'HRB 14000', 'Siren 794598813'), or executive names (e.g., 'Oliver Blume').

## `country` (type: `string`):

Restrict company discovery to a specific European country, or keep 'All Europe' to search across all covered European commercial registries.

## `activeOnly` (type: `boolean`):

When enabled, excludes dissolved, terminated, or liquidated companies and outputs only active legal entities.

## `includeFullProfile` (type: `boolean`):

Enriches every company with current & former CEOs/directors, multi-year financial KPIs (revenue, net profit, total assets, equity, employees), VAT/LEI/EUID identifiers, direct website/phone/email contacts, NACE industry classification, subsidiary/parent corporate links, and filing history.

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

Optional list of direct North Data company profile URLs or search URLs (e.g., https://www.northdata.com/Robert%20Bosch%20GmbH,%20Gerlingen/Amtsgericht%20Stuttgart%20HRB%2014000).

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

Maximum number of unique company records to collect across the run. Set to 0 for unlimited (note: completely empty input defaults to 100 companies).

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

Proxy configuration for reliable high-throughput collection across European registries.

## Actor input object example

```json
{
  "queries": [
    "Robotics",
    "Medtech",
    "Siemens",
    "Bosch"
  ],
  "country": "all",
  "activeOnly": false,
  "includeFullProfile": true,
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `dataset` (type: `string`):

View, filter, and download all extracted North Data company records in JSON, CSV, Excel, or Parquet.

# 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 = {
    "queries": [
        "Robotics",
        "Medtech",
        "Siemens",
        "Bosch"
    ],
    "country": "all",
    "activeOnly": false,
    "includeFullProfile": true,
    "maxItems": 100,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("haketa/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 = {
    "queries": [
        "Robotics",
        "Medtech",
        "Siemens",
        "Bosch",
    ],
    "country": "all",
    "activeOnly": False,
    "includeFullProfile": True,
    "maxItems": 100,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("haketa/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 '{
  "queries": [
    "Robotics",
    "Medtech",
    "Siemens",
    "Bosch"
  ],
  "country": "all",
  "activeOnly": false,
  "includeFullProfile": true,
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call haketa/northdata-scraper --silent --output-dataset

```

## MCP server setup

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