# CRBR Scraper - Polish Beneficial Owners Registry (`trev0n/crbr-scraper`) Actor

Extract beneficial ownership data from Poland's CRBR registry. Find who really controls Polish companies - search by NIP, PESEL, or date of birth. Returns owner names, citizenship, residence, and ownership type. Essential for AML/KYC compliance and due diligence.

- **URL**: https://apify.com/trev0n/crbr-scraper.md
- **Developed by:** [Paweł](https://apify.com/trev0n) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

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

## 🏢 CRBR Beneficial Owners Scraper

🎯 **Instantly uncover who really controls any Polish company — search the official Central Register of Beneficial Owners (CRBR) and get structured, ready-to-use ownership data.**

Identify beneficial owners of Polish companies with full details: names, citizenship, country of residence, and type of ownership rights. Search by company tax number (NIP), personal ID (PESEL), or date of birth to trace ownership structures across the entire Polish corporate landscape.

### 🚀 What Does It Do?

This scraper automatically searches Poland's Central Register of Beneficial Owners (Centralny Rejestr Beneficjentow Rzeczywistych) and collects **structured, ready-to-use beneficial ownership data**. No manual browsing needed — just enter your identifiers and hit Start.

💡 **Three search modes:**

1. 🔍 **Company Lookup** — Enter NIP numbers to see who controls specific companies
2. 👤 **Person Lookup** — Enter PESEL numbers to find all companies a person controls
3. 📅 **Date of Birth Search** — Search by date of birth along with first and last name to trace beneficial ownership

### 👥 Who Is This For?

| 🏢 Use Case                           | 💬 How It Helps                                                                                     |
| ------------------------------------- | --------------------------------------------------------------------------------------------------- |
| 🔒 **AML/KYC Compliance Teams**       | Automate beneficial ownership verification for client onboarding and ongoing due diligence          |
| ⚖️ **Law Firms & Legal Departments**  | Quickly identify who stands behind any Polish company for litigation, M\&A, or contract negotiations |
| 🔎 **Due Diligence Analysts**         | Screen hundreds of companies at once — bulk search NIP numbers and get instant ownership maps       |
| 📰 **Investigative Journalists**      | Trace corporate ownership chains and uncover connections between people and companies               |
| 🏦 **Banks & Financial Institutions** | Meet EU Anti-Money Laundering Directive requirements with automated CRBR data extraction            |
| 📊 **Risk & Fraud Analysts**          | Detect shell companies and suspicious ownership patterns at scale                                   |

### ✨ Features

- 🏢 **Full Company Details** — Company name, NIP, KRS, legal form, and full registered address for every result
- 👤 **Beneficial Owner Profiles** — First name, last name, citizenship, country of residence, and date of birth
- 📜 **Ownership Rights Breakdown** — Type of ownership, detailed description of control, and share percentages
- 🔢 **Bulk Search** — Process hundreds of NIP numbers, PESEL numbers, or dates of birth in a single run
- 🔄 **Three Search Modes** — Look up by company (NIP), by person (PESEL), or by date of birth
- 📅 **Date Range Queries** — Search beneficial ownership data as of a specific date range
- ✅ **Official Data Source** — All data comes directly from Poland's government registry
- 🛡️ **Error Handling** — Invalid identifiers are flagged and skipped automatically, so your batch runs never break
- ⚡ **Fast & Lightweight** — Pure data extraction with no browser overhead, processes queries in seconds
- 🧹 **Flat Output** — One row per company-owner combination, perfect for spreadsheets and databases
- 📤 **Export Anywhere** — Download results as JSON, CSV, Excel, or push to Google Sheets, Zapier, Make, or your CRM

### 🎛️ Filters & Options

| Option             | What It Does                                                                                         |
| ------------------ | ---------------------------------------------------------------------------------------------------- |
| 🔍 **Search Mode** | Choose how to search: by company NIP, by person PESEL, or by date of birth                           |
| 🔢 **Identifiers** | Enter the NIP numbers, PESEL numbers, or "firstName lastName YYYY-MM-DD" strings you want to look up |
| 📅 **Date From**   | Optionally set the start of the date range for your query                                            |
| 📅 **Date To**     | Optionally set the end of the date range for your query                                              |
| 🔢 **Max Results** | Control how many items to extract per run                                                            |

### 📦 What You Get (Output Fields)

Every result includes:

#### Company Information

| Field           | Example                           |
| --------------- | --------------------------------- |
| companyName     | `T-MOBILE POLSKA S.A.`            |
| nip             | `5261040567`                      |
| krs             | `0000391193`                      |
| legalForm       | `Spolka akcyjna`                  |
| legalFormCode   | `116`                             |
| address         | `MARYNARSKA 12, 02-674, WARSZAWA` |
| postalCode      | `02-674`                          |
| city            | `WARSZAWA`                        |
| voivodeship     | `MAZOWIECKIE`                     |
| county          | `WARSZAWA`                        |
| municipality    | `WARSZAWA`                        |
| street          | `MARYNARSKA`                      |
| buildingNumber  | `12`                              |
| apartmentNumber | `null`                            |

#### Beneficial Owner

| Field              | Example      |
| ------------------ | ------------ |
| firstName          | `ANDREAS`    |
| lastName           | `MAIERHOFER` |
| dateOfBirth        | `1967-10-03` |
| citizenship        | `AUSTRIA`    |
| countryOfResidence | `POLSKA`     |

#### Ownership Details

| Field                | Example                                                     |
| -------------------- | ----------------------------------------------------------- |
| ownershipType        | `Inne uprawnienia`                                          |
| ownershipDescription | `osoba fizyczna zajmujaca wyzsze stanowisko kierownicze...` |

#### Metadata

| Field           | Example                    |
| --------------- | -------------------------- |
| searchMode      | `byNip`                    |
| queryIdentifier | `5261040567`               |
| dateFrom        | `2026-03-21`               |
| dateTo          | `2026-03-21`               |
| scrapedAt       | `2026-03-21T21:47:10.000Z` |

### 📊 Example Output

```json
{
    "companyName": "T-MOBILE POLSKA S.A.",
    "nip": "5261040567",
    "krs": "0000391193",
    "legalForm": "Spolka akcyjna",
    "legalFormCode": "116",
    "address": "MARYNARSKA 12, 02-674, WARSZAWA",
    "postalCode": "02-674",
    "city": "WARSZAWA",
    "voivodeship": "MAZOWIECKIE",
    "county": "WARSZAWA",
    "municipality": "WARSZAWA",
    "street": "MARYNARSKA",
    "buildingNumber": "12",
    "apartmentNumber": null,
    "firstName": "ANDREAS",
    "lastName": "MAIERHOFER",
    "dateOfBirth": "1967-10-03",
    "citizenship": "AUSTRIA",
    "countryOfResidence": "POLSKA",
    "ownershipType": "Inne uprawnienia",
    "ownershipDescription": "osoba fizyczna zajmujaca wyzsze stanowisko kierownicze...",
    "searchMode": "byNip",
    "queryIdentifier": "5261040567",
    "dateFrom": "2026-03-21",
    "dateTo": "2026-03-21",
    "scrapedAt": "2026-03-21T21:47:10.000Z"
}
```

### 📋 Dataset Views

The Apify Console gives you **3 ready-made table views** to quickly browse your results:

| View                     | What It Shows                                                                                 |
| ------------------------ | --------------------------------------------------------------------------------------------- |
| 📊 **Overview**          | Company name, NIP, KRS, legal form, beneficial owner name, and ownership type                 |
| 👤 **Beneficial Owners** | Full beneficial owner details with citizenship, country of residence, and ownership breakdown |
| 📋 **Full Details**      | Every single field — the complete dataset including address and metadata                      |

### ❓ FAQ

**🤔 What is CRBR?**
CRBR (Centralny Rejestr Beneficjentow Rzeczywistych) is Poland's official Central Register of Beneficial Owners. Every Polish company is legally required to register its beneficial owners — individuals who ultimately own or control the entity. The register was established under EU anti-money laundering directives and is maintained by the Polish Ministry of Finance.

**🤔 What is a beneficial owner?**
A beneficial owner is a natural person (individual) who ultimately owns or controls a legal entity, such as a company. In Poland, this typically means anyone who directly or indirectly holds more than 25% of shares, voting rights, or otherwise exercises control over the company's activities.

**🤔 Is this data publicly accessible?**
Yes — CRBR data is part of a public government register. Polish law requires companies to file beneficial ownership information, and the register is openly accessible for legitimate purposes such as compliance, due diligence, and anti-money laundering checks.

**🤔 How fresh is the data?**
The data is always live — every query goes directly to the official government register. You get the most current beneficial ownership filings as reported by the companies themselves. Companies are required by law to update their CRBR filings within 7 days of any ownership change.

**🤔 Can I search for multiple companies at once?**
Absolutely! Just add multiple NIP numbers to the identifiers list. The scraper processes them one by one and returns structured results for each company. You can easily search hundreds of companies in a single run.

**🤔 Can I export the data?**
Yes — JSON, CSV, Excel, XML, HTML, RSS. You can also push data directly to Google Sheets, Zapier, Make, or any webhook/API endpoint.

**🤔 How often should I run this?**
For fresh data, run daily or weekly. You can schedule automatic runs on Apify with just a few clicks.

### 🛠️ Need Custom Filters or Features?

**I'm happy to customize this scraper for your specific needs!** 🤝

Whether you need:

- 🎯 Additional search modes (e.g., search by KRS number, by company name, or by REGON)
- 📊 Cross-referencing CRBR data with other Polish registries (KRS, CEIDG, REGON)
- 🔄 Integration with your CRM, compliance platform, Google Sheets, or database
- ⏰ Scheduled ownership monitoring with automatic change detection alerts
- 🌐 Beneficial ownership data from other EU countries alongside Poland's CRBR

👉 **Don't hesitate to reach out via private message** — I respond quickly and I'm always open to building exactly what you need. No request is too small or too specific!

### ⚖️ Legal & Ethical Use

This scraper collects **only publicly available information** from Poland's Central Register of Beneficial Owners (CRBR), an official government register maintained by the Ministry of Finance. The data is made publicly accessible under Polish law implementing EU Anti-Money Laundering Directives (AMLD4/AMLD5). Note that following the EU Court of Justice ruling and evolving AMLD6 provisions, access rules to beneficial ownership registers may change across EU member states. Users are responsible for ensuring they have a justified interest in accessing this data and for complying with GDPR and all applicable data protection regulations when processing personal information obtained from the register. Please use the data responsibly and in compliance with applicable laws.

# Actor input Schema

## `searchMode` (type: `string`):

How to search the CRBR registry. 'byNip' searches by company tax number (NIP), 'byPesel' searches by personal ID (PESEL), 'byDateOfBirth' searches by date of birth with first name and last name.

## `identifiers` (type: `array`):

List of identifiers to search. For byNip: NIP numbers (10 digits). For byPesel: PESEL numbers (11 digits). For byDateOfBirth: strings in format "firstName lastName YYYY-MM-DD".

## `dateFrom` (type: `string`):

Start date for the query range (YYYY-MM-DD format). Defaults to today.

## `dateTo` (type: `string`):

End date for the query range (YYYY-MM-DD format). Defaults to today.

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

Maximum number of items to extract (0 = unlimited)

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

Proxy settings. Use Apify Proxy or your own proxy to avoid rate limiting.

## Actor input object example

```json
{
  "searchMode": "byNip",
  "identifiers": [
    "5261040567"
  ],
  "maxResults": 0,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

No description

# 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 = {
    "identifiers": [
        "5261040567"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("trev0n/crbr-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 = { "identifiers": ["5261040567"] }

# Run the Actor and wait for it to finish
run = client.actor("trev0n/crbr-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 '{
  "identifiers": [
    "5261040567"
  ]
}' |
apify call trev0n/crbr-scraper --silent --output-dataset

```

## MCP server setup

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