# North Data Scraper (`solidcode/northdata-scraper`) Actor

\[💰 $4.0 / 1K] Extract European company data from North Data: profiles, registration numbers, addresses, officers and management, published financials, corporate networks, register events, and news.

- **URL**: https://apify.com/solidcode/northdata-scraper.md
- **Developed by:** [SolidCode](https://apify.com/solidcode) (community)
- **Categories:** Developer tools, Lead generation, Other
- **Stats:** 4 total users, 3 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 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.

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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## North Data Scraper

Pull complete European company profiles from North Data at scale — legal identity, register court and number, multi-year financials, full officer rosters, corporate-network graphs, register events, and news mentions for companies across roughly 26 countries. This goes far beyond shallow search-index rows: it reads the full company detail page that search-only tools can't. Built for KYC and compliance analysts, M&A and due-diligence researchers, credit-risk teams, and B2B lead-gen ops who need verified official-register data without crafting registry URLs or hitting paywalls.

### Why This Scraper?

- **Full company detail pages, not just search hits** — reads the complete profile that search-only tools explicitly cannot: financials, officers, network, events, and news in one record.
- **Roughly 26 countries of coverage** — strongest in Germany, Austria, and Switzerland, then the broader EU and the UK, with a single country dropdown (16 named countries plus "Any country").
- **Multi-year financials, year by year** — revenue, earnings, equity, balance-sheet total, and employee counts pulled from published annual reports, each value tagged with its source publication and date.
- **Complete officer and management rosters** — every registered director and managing director with their role; large corporates like Volkswagen AG return 100+ officers in a single record.
- **Corporate-network graph** — related companies linked by shared officers and ownership, each with its relationship label, register key, and risk level (up to 25 connections per company).
- **Register events timeline** — incorporations, name changes, capital changes, mergers, and insolvencies, each dated with a description.
- **Verified register identity** — legal name, legal form, status (active, in liquidation, terminated), register court and number (HRB/HRA/VR, Companies House, SIREN, KVK, KRS, CRO), national IDs, and LEI code.
- **Plain-language search, no URL crafting** — look up by company name, manager name, keyword, or registration number; or paste a direct profile URL. No hand-built registry links required.
- **One nested record per company** — every financial year, every officer, and every event arrive nested inside a single result, so the output stays clean and your cost stays predictable.

### Use Cases

**KYC, Compliance & Due Diligence**
- Verify a counterparty's legal name, register court, and registration number against the official source
- Confirm company status (active, in liquidation, terminated) before onboarding
- Capture LEI codes and national IDs for sanctions and entity screening
- Map the full management roster for ultimate-beneficial-owner and director checks

**M&A & Investment Research**
- Pull multi-year revenue, earnings, and equity trends for target screening
- Trace corporate-network graphs to map holding structures and subsidiaries
- Track register events — capital changes, mergers, insolvencies — across a watchlist
- Benchmark balance-sheet totals and employee growth across comparables

**Credit & Risk Analysis**
- Monitor financial trajectory and equity ratios year over year
- Flag terminated or in-liquidation entities in a supplier portfolio
- Score corporate-network exposure via related-company risk levels
- Build early-warning lists from insolvency and capital-reduction events

**B2B Lead Generation & Enrichment**
- Build company lists by keyword or industry across European registers
- Enrich CRM records with verified addresses, founding dates, and register numbers
- Identify decision-makers by name and role from officer rosters
- Append financials and headcount to qualify accounts by size

### Getting Started

#### Look Up a Single Company

The simplest start — just a company name:

```json
{
    "searchQueries": ["Volkswagen AG"]
}
````

#### Search Within One Country

```json
{
    "searchQueries": ["Siemens Energy", "BMW"],
    "country": "DE",
    "resultType": "companies",
    "maxResults": 25
}
```

#### Full Profile With Every Collection

```json
{
    "searchQueries": ["Volkswagen AG"],
    "includeFinancials": true,
    "includeOfficers": true,
    "includeRelatedCompanies": true,
    "includeEvents": true,
    "includeNews": true,
    "maxResults": 10
}
```

#### Target Exact Companies by URL

Paste direct North Data profile or search URLs — these are always scraped in full:

```json
{
    "startUrls": [
        { "url": "https://www.northdata.com/Volkswagen+AG,+Wolfsburg/HRB+100484" }
    ],
    "includeFinancials": true,
    "includeOfficers": true
}
```

### Input Reference

#### What to Scrape

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `searchQueries` | string\[] | `["Volkswagen AG"]` | Company names, manager names, keywords, or registration numbers to look up. Each query returns its matching records, fully enriched. |
| `startUrls` | URL\[] | `[]` | Direct North Data company or search-result URLs. Use these to target exact companies you already know. |

#### Filters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `country` | select | `Any country` | Restrict search to one country: Germany, Austria, Switzerland, United Kingdom, France, Netherlands, Belgium, Luxembourg, Italy, Spain, Poland, Czech Republic, Denmark, Sweden, Norway, or Finland. |
| `resultType` | select | `Companies only` | What to keep from a search: Companies only, People only, or Companies and people. |

#### Detail to Include per Company

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `includeFinancials` | boolean | `true` | Add published financial figures and balance-sheet history — revenue, equity, balance-sheet total, profit/loss, employees. |
| `includeOfficers` | boolean | `true` | Add directors, managing directors, and other registered officers with their roles. |
| `includeRelatedCompanies` | boolean | `false` | Add companies linked through shared officers, ownership, or the corporate-network graph. |
| `includeEvents` | boolean | `false` | Add register events such as incorporations, name changes, capital changes, mergers, and insolvencies. |
| `includeNews` | boolean | `false` | Add news mentions and publication references indexed for the company. |

#### Limits

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `maxResults` | integer | `50` | Maximum records to scrape per search query. Direct company URLs are always scraped in full and do not count toward this limit. |

### Output

One record per company (or per person for people results), with every child collection nested as an array inside that single record.

#### Company Record

```json
{
    "recordType": "company",
    "url": "https://www.northdata.com/Volkswagen+AG,+Wolfsburg/HRB+100484",
    "name": "Volkswagen AG",
    "status": "Active",
    "foundingDate": "1937-05-28",
    "leiCode": "529900NNUPAGGOMR7D67",
    "corporatePurpose": "The manufacture and distribution of vehicles and engines of all kinds...",
    "registerNumber": "Wolfsburg HRB 100484",
    "nationalIds": [
        { "source": "Trade Register", "value": "Wolfsburg HRB 100484" }
    ],
    "address": {
        "street": "Berliner Ring 2",
        "postalCode": "38440",
        "city": "Wolfsburg",
        "country": "DE"
    },
    "city": "Wolfsburg",
    "country": "DE",
    "employees": 684025,
    "revenue": 322284000000,
    "earnings": 17941000000,
    "companyId": "5012345",
    "financials": [
        {
            "metric": "Revenue",
            "values": [
                { "year": 2023, "value": 322284000000, "formattedValue": "322.3 bn EUR", "consolidated": true, "estimate": false, "publicationTitle": "Annual Report 2023", "publicationDate": "2024-03-13" }
            ]
        }
    ],
    "balanceSheets": [
        { "section": "Assets", "date": "2023-12-31", "lines": [ { "name": "Total assets", "value": 600000000000, "formattedValue": "600.0 bn EUR", "level": 0 } ] }
    ],
    "officers": [
        { "name": "Oliver Blume", "givenName": "Oliver", "familyName": "Blume", "role": "Chairman of the Board of Management", "url": "https://www.northdata.com/..." }
    ],
    "relatedCompanies": [
        { "name": "AUDI AG", "type": "company", "description": "Ingolstadt", "url": "https://www.northdata.com/...", "id": "5067890", "city": "Ingolstadt", "registerKey": "Ingolstadt HRB 1", "riskLevel": 0, "relationships": ["Shareholder"] }
    ],
    "events": [
        { "category": "History", "date": "2023-05-10", "title": "Capital change", "description": "Share capital increased...", "type": "register" }
    ],
    "news": [
        { "category": "Marketing & Tech", "date": "2024-02-01", "title": "New EV platform announced", "description": "...", "type": "publication", "source": "Press release" }
    ]
}
```

##### Identity

| Field | Type | Description |
|-------|------|-------------|
| `recordType` | string | `company` for this record type |
| `url` | string | Canonical North Data profile URL |
| `name` | string | Registered legal name |
| `status` | string | Lifecycle status: Active, In Liquidation, Insolvency, or Terminated |
| `foundingDate` | string | Date the company was founded |
| `corporatePurpose` | string | Stated business purpose from the register |
| `registerNumber` | string | Register court and number (e.g. "Wolfsburg HRB 100484") |
| `nationalIds` | object\[] | National identifiers, each with `source` and `value` (SIREN, KVK, KRS, etc.) |
| `leiCode` | string | Legal Entity Identifier |
| `companyId` | string | North Data internal company identifier |

##### Address & Location

| Field | Type | Description |
|-------|------|-------------|
| `address` | object | Structured address: `street`, `postalCode`, `city`, `country` |
| `city` | string | City of the registered office |
| `country` | string | Country code of the registered office |

##### Financials

| Field | Type | Description |
|-------|------|-------------|
| `revenue` | number | Latest published revenue |
| `earnings` | number | Latest published earnings / profit-loss |
| `employees` | number | Latest published employee count |
| `financials` | object\[] | Per-metric series; each `values` entry carries `year`, `value`, `formattedValue`, `consolidated`, `estimate`, `publicationTitle`, `publicationDate` |
| `balanceSheets` | object\[] | Balance-sheet sections, each with `date` and nested `lines` (`name`, `value`, `formattedValue`, `level`) |

##### Officers, Network & Events

| Field | Type | Description |
|-------|------|-------------|
| `officers` | object\[] | Registered officers: `name`, `givenName`, `familyName`, `role`, `url` |
| `relatedCompanies` | object\[] | Network connections: `name`, `type`, `description`, `url`, `city`, `registerKey`, `riskLevel`, `relationships` |
| `events` | object\[] | Register events: `category`, `date`, `title`, `description`, `type` |
| `news` | object\[] | News and publication mentions: `category`, `date`, `title`, `description`, `source` |

#### Person Record

Returned when `resultType` is "People only" or "Companies and people".

```json
{
    "recordType": "person",
    "url": "https://www.northdata.com/...",
    "name": "Oliver Blume",
    "givenName": "Oliver",
    "familyName": "Blume",
    "city": "Wolfsburg",
    "country": "DE",
    "companyId": null,
    "companies": [
        { "name": "Volkswagen AG", "url": "https://www.northdata.com/Volkswagen+AG,+Wolfsburg/HRB+100484" }
    ]
}
```

| Field | Type | Description |
|-------|------|-------------|
| `recordType` | string | `person` for this record type |
| `name` | string | Full name |
| `givenName` | string | First name |
| `familyName` | string | Last name |
| `city` | string | City associated with the person |
| `country` | string | Country code |
| `companies` | object\[] | Companies the person is an officer of: `name`, `url` |

### Tips for Best Results

- **Use a registration number for an exact match** — querying with a register number (e.g. "HRB 100484") pins a single company instead of returning a list of name matches.
- **Leave the heavy toggles off for a lean run** — `includeRelatedCompanies`, `includeEvents`, and `includeNews` default off. Turn on related companies only when you actually need the ownership graph.
- **Set a country to sharpen searches** — adding a country filter narrows name matches to the right register, which matters for common names shared across borders.
- **Start small to validate** — set `maxResults` to 10–25 on your first run to confirm the data fits your needs, then scale up.
- **Financials are richest for German companies** — German firms are legally required to publish annual figures, so revenue, equity, and balance-sheet history are most complete there.
- **Mix queries and URLs in one run** — combine plain search queries with direct profile URLs; URLs are always scraped in full regardless of the result cap.
- **Switch `resultType` to People** — to build director and manager lists, set result type to People only and the records return the companies each person is tied to.

### Pricing

**$4.00 per 1,000 results** — full company profiles for less than competing tools charge for shallow search rows. No compute charges — you only pay per result returned.

| Results | Estimated Cost |
|---------|----------------|
| 100 | $0.40 |
| 1,000 | $4.00 |
| 10,000 | $40.00 |
| 100,000 | $400.00 |

A "result" is one company or person record. Its entire multi-year financial history, full officer roster (even 100+ officers), register events, and corporate network all arrive nested inside that single result — you are never charged per officer, per financial year, or per event.

### Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

- **Zapier** / **Make** / **n8n** — Workflow automation
- **Google Sheets** — Direct spreadsheet export
- **Slack** / **Email** — Notifications on new results
- **Webhooks** — Trigger custom APIs on run completion
- **Apify API** — Full programmatic access

### Legal & Ethical Use

This actor collects publicly available information from official business registers and public sources. Users are responsible for complying with applicable laws and North Data's Terms of Service. Personal data about individuals (such as company officers) must be handled in line with GDPR and other privacy regulations. Do not use the extracted data for spam, harassment, or any unlawful purpose.

# Actor input Schema

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

Company names, manager names, keywords, or registration numbers to search North Data (e.g. "Volkswagen AG", "BMW", "Siemens Energy"). Each query returns its matching companies, fully enriched.

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

Direct North Data company or search-result URLs to scrape (e.g. https://www.northdata.com/Volkswagen+AG,+Wolfsburg/HRB+100484). Use this to target exact companies you already know.

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

Restrict search results to companies registered in a single country. Leave as "Any country" to search North Data's full European coverage.

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

What kind of records to keep from a search. "Companies only" returns registered businesses; "People only" returns managers and officers; "Companies and people" keeps everything that matches.

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

Include published financial figures and balance-sheet history (revenue, equity, balance-sheet total, profit/loss, employees) when available. German companies are legally required to publish these.

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

Include directors, managing directors, and other registered officers of each company, with their roles.

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

Include companies linked through shared officers, ownership, or the corporate network graph (includes up to 25 related companies per record).

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

Include trade-register events such as incorporations, name changes, capital changes, mergers, and insolvencies.

## `includeNews` (type: `boolean`):

Include news mentions and publication references North Data has indexed for the company.

## `maxResults` (type: `integer`):

Maximum number of company (or people) records to scrape per search query. Direct company URLs are always scraped in full and do not count toward this limit.

## Actor input object example

```json
{
  "searchQueries": [
    "Volkswagen AG"
  ],
  "startUrls": [],
  "country": "",
  "resultType": "companies",
  "includeFinancials": true,
  "includeOfficers": true,
  "includeRelatedCompanies": false,
  "includeEvents": false,
  "includeNews": false,
  "maxResults": 50
}
```

# Actor output Schema

## `overview` (type: `string`):

Table of scraped results with key fields.

# 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": [
        "Volkswagen AG"
    ],
    "startUrls": [],
    "maxResults": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("solidcode/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": ["Volkswagen AG"],
    "startUrls": [],
    "maxResults": 50,
}

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

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).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": [
    "Volkswagen AG"
  ],
  "startUrls": [],
  "maxResults": 50
}' |
apify call solidcode/northdata-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=solidcode/northdata-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "North Data Scraper",
        "description": "[💰 $4.0 / 1K] Extract European company data from North Data: profiles, registration numbers, addresses, officers and management, published financials, corporate networks, register events, and news.",
        "version": "1.0",
        "x-build-id": "Du7C69Ng9GehhlEr8"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/solidcode~northdata-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-solidcode-northdata-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/solidcode~northdata-scraper/runs": {
            "post": {
                "operationId": "runs-sync-solidcode-northdata-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/solidcode~northdata-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-solidcode-northdata-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "searchQueries": {
                        "title": "Search queries",
                        "type": "array",
                        "description": "Company names, manager names, keywords, or registration numbers to search North Data (e.g. \"Volkswagen AG\", \"BMW\", \"Siemens Energy\"). Each query returns its matching companies, fully enriched.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "startUrls": {
                        "title": "Company or search URLs",
                        "type": "array",
                        "description": "Direct North Data company or search-result URLs to scrape (e.g. https://www.northdata.com/Volkswagen+AG,+Wolfsburg/HRB+100484). Use this to target exact companies you already know.",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "country": {
                        "title": "Country",
                        "enum": [
                            "",
                            "DE",
                            "AT",
                            "CH",
                            "GB",
                            "FR",
                            "NL",
                            "BE",
                            "LU",
                            "IT",
                            "ES",
                            "PL",
                            "CZ",
                            "DK",
                            "SE",
                            "NO",
                            "FI"
                        ],
                        "type": "string",
                        "description": "Restrict search results to companies registered in a single country. Leave as \"Any country\" to search North Data's full European coverage.",
                        "default": ""
                    },
                    "resultType": {
                        "title": "Result type",
                        "enum": [
                            "companies",
                            "people",
                            "both"
                        ],
                        "type": "string",
                        "description": "What kind of records to keep from a search. \"Companies only\" returns registered businesses; \"People only\" returns managers and officers; \"Companies and people\" keeps everything that matches.",
                        "default": "companies"
                    },
                    "includeFinancials": {
                        "title": "Include financial reports",
                        "type": "boolean",
                        "description": "Include published financial figures and balance-sheet history (revenue, equity, balance-sheet total, profit/loss, employees) when available. German companies are legally required to publish these.",
                        "default": true
                    },
                    "includeOfficers": {
                        "title": "Include officers & management",
                        "type": "boolean",
                        "description": "Include directors, managing directors, and other registered officers of each company, with their roles.",
                        "default": true
                    },
                    "includeRelatedCompanies": {
                        "title": "Include related companies",
                        "type": "boolean",
                        "description": "Include companies linked through shared officers, ownership, or the corporate network graph (includes up to 25 related companies per record).",
                        "default": false
                    },
                    "includeEvents": {
                        "title": "Include register events",
                        "type": "boolean",
                        "description": "Include trade-register events such as incorporations, name changes, capital changes, mergers, and insolvencies.",
                        "default": false
                    },
                    "includeNews": {
                        "title": "Include news & publications",
                        "type": "boolean",
                        "description": "Include news mentions and publication references North Data has indexed for the company.",
                        "default": false
                    },
                    "maxResults": {
                        "title": "Maximum results per query",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Maximum number of company (or people) records to scrape per search query. Direct company URLs are always scraped in full and do not count toward this limit."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
