# Poland CRBR Beneficial Owners Scraper (`fetch_cat/poland-crbr-beneficial-owners-scraper`) Actor Extract Polish CRBR beneficial ownership records by NIP, KRS, company name, PESEL, or beneficiary name for AML, KYC, KYB, and due diligence. - **URL**: https://apify.com/fetch\_cat/poland-crbr-beneficial-owners-scraper.md - **Developed by:** [Hanna Nosova](https://apify.com/fetch_cat) (community) - **Categories:** Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.06 / 1,000 item extracteds 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/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 ## Poland CRBR Beneficial Owners Scraper Extract structured beneficial ownership data from Poland's public Central Register of Beneficial Owners (CRBR). Search by company name, NIP, KRS, PESEL, or beneficiary name and export compliance-ready data for AML, KYC, KYB, due diligence, and investigations. ### What does Poland CRBR Beneficial Owners Scraper do? Poland CRBR Beneficial Owners Scraper turns public CRBR searches into structured dataset rows. It helps you collect company identity, beneficial-owner identity, control rights, filing evidence, and source metadata without manual copy-paste from the public registry. ### Example input ```json { "searches": [ { "mode": "companyName", "query": "ORLEN" }, { "mode": "nip", "query": "7742894628" }, { "mode": "beneficiaryPesel", "query": "73110202448" } ], "maxResults": 25 } ```` ### Example output ```json { "recordType": "beneficial_owner", "searchMode": "companyName", "sourceQuery": "ORLEN", "found": true, "companyName": "ORLEN ADMINISTRACJA SP. Z O.O.", "nip": "7742894628", "krs": "0000252883", "legalForm": "Spółka z ograniczoną odpowiedzialnością", "companyAddress": "CHEMIKÓW 7, 09-411, PŁOCK, PŁOCK, PŁOCK, MAZOWIECKIE", "beneficiaryFullName": "MAŁGORZATA DANUTA GOŁUCHOWSKA", "beneficiaryPesel": "73110202448", "beneficiaryCitizenships": ["PL - POLSKA"], "beneficiaryResidenceCountry": "PL - POLSKA", "controlType": "osoba fizyczna zajmująca wyższe stanowisko kierownicze, o której mowa w art. 2 ust. 2 pkt.1 lit. a tiret 5 ustawy AML", "controlTypeCode": "002", "rightsSummary": "osoba fizyczna zajmująca wyższe stanowisko kierownicze, o której mowa w art. 2 ust. 2 pkt.1 lit. a tiret 5 ustawy AML", "requestId": "7A7C490EFF8C49A99D544269C26675C6", "presentationStart": "2026-07-09", "presentationEnd": "2026-07-09", "sourceUrl": "https://crbr.podatki.gov.pl/adcrbr/#/wyszukaj", "retrievedAt": "2026-07-09T21:12:44.000Z" } ``` ### Who is it for? - AML and KYC teams checking beneficial ownership of Polish companies. - KYB onboarding teams enriching customer files with official-source ownership data. - Compliance, legal, and finance teams building audit evidence. - Investigators, journalists, and data teams researching Polish corporate control. ### Use cases - Verify UBO declarations before onboarding a Polish counterparty. - Batch-check NIP or KRS identifiers from a customer portfolio. - Search company names to discover matching CRBR entries. - Collect source request IDs and presentation periods for audit trails. - Export beneficial-owner rows to CSV, Excel, JSON, webhooks, or data warehouses. ### Output fields - Company identity: name, NIP, KRS, legal form, registered address - Beneficial owner identity: names, PESEL or birth date when returned publicly, citizenship, residence country - Control details: control basis, AML wording, ownership amount/unit, indirect control and privileges when available - Filing evidence: CRBR request ID, presentation dates, correction flag, discrepancy count, source URL - Representatives who filed the declaration, with roles when returned by CRBR - Error/not-found rows for auditable batch checks ### Input settings | Field | Type | Description | | --- | --- | --- | | `searches` | array | Search requests. Each request has `mode` and `query`. | | `searches[].mode` | string | `companyName`, `nip`, `krs`, `beneficiaryPesel`, or `beneficiaryName`. | | `searches[].query` | string | Company name, NIP, KRS, PESEL, or beneficiary name. | | `searches[].firstName` / `lastName` | string | Optional overrides for beneficiary-name searches. | | `searches[].pesel` | string | Optional exact PESEL override for beneficiary searches. | | `searches[].birthDate` | string | Optional YYYY-MM-DD birth date for beneficiary-name searches. | | `maxResults` | integer | Maximum dataset rows to save. | | `dateFrom`, `dateTo` | string | CRBR presentation period. Defaults to today. | | `requestDelayMs` | integer | Polite delay between searches. | | `includeRaw` | boolean | Include raw CRBR fragments for audit/debug exports. | ### Input recipes #### Search by company name ```json { "searches": [{ "mode": "companyName", "query": "ORLEN" }], "maxResults": 25 } ``` #### Exact company check by NIP or KRS ```json { "searches": [ { "mode": "nip", "query": "7742894628" }, { "mode": "krs", "query": "0000252883" } ], "maxResults": 10 } ``` #### Beneficiary check by PESEL ```json { "searches": [{ "mode": "beneficiaryPesel", "query": "73110202448" }], "maxResults": 10 } ``` ### Pricing This actor uses pay-per-event pricing: - Actor start: `$0.005` per run - CRBR result row: tiered by Apify public usage plans. The Starter / Bronze reference price is `$0.0001` per saved dataset row (about `$0.10` per 1,000 rows). | Tier | Result row price | | --- | --- | | Free | `$0.000115` | | Starter / Bronze | `$0.0001` | | Scale / Silver | `$0.000078` | | Business / Gold | `$0.00006` | | Custom / Platinum | `$0.00004` | | Custom / Diamond | `$0.000028` | Use `maxResults` to control cost for broad company-name searches. ### Tips and limits - Use NIP, KRS, or PESEL for exact checks. - Use company-name searches for discovery, then re-run exact identifiers for audit files. - Beneficiary-name searches may require birth-date context depending on CRBR validation rules. - Empty, invalid, or no-match searches are saved as `not_found` or `error` rows so batch audits remain traceable. ### Legality and responsible use Poland's CRBR is a public beneficial-ownership register, but results can include personal data such as names, citizenship, residence country, birth dates, or PESEL values when the public service returns them. Use this actor only for lawful purposes such as AML/KYC/KYB checks, due diligence, compliance audits, journalism, public-interest research, or other legitimate uses. You are responsible for having an appropriate legal basis, following applicable data-protection rules, limiting retention and sharing, and respecting CRBR portal terms and Polish/EU law. ### API usage #### Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('fetch_cat/poland-crbr-beneficial-owners-scraper').call({ searches: [{ mode: 'companyName', query: 'ORLEN' }], maxResults: 20, }); console.log(`Dataset: https://api.apify.com/v2/datasets/${run.defaultDatasetId}/items`); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_APIFY_TOKEN') run = client.actor('fetch_cat/poland-crbr-beneficial-owners-scraper').call(run_input={ 'searches': [{'mode': 'companyName', 'query': 'ORLEN'}], 'maxResults': 20, }) print(f"Dataset: https://api.apify.com/v2/datasets/{run['defaultDatasetId']}/items") ``` #### cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/fetch_cat~poland-crbr-beneficial-owners-scraper/runs?token=YOUR_APIFY_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"searches":[{"mode":"companyName","query":"ORLEN"}],"maxResults":20}' ``` ### MCP and agent usage Connect AI agents through Apify MCP using: ```text https://mcp.apify.com/?tools=fetch_cat/poland-crbr-beneficial-owners-scraper ``` #### Claude CLI ```bash claude mcp add apify-crbr --url "https://mcp.apify.com/?tools=fetch_cat/poland-crbr-beneficial-owners-scraper" ``` #### JSON config ```json { "mcpServers": { "apify-crbr": { "url": "https://mcp.apify.com/?tools=fetch_cat/poland-crbr-beneficial-owners-scraper" } } } ``` #### Example prompts - "Search CRBR for ORLEN and summarize the beneficial-owner rows." - "Check this list of KRS numbers and return companies with missing CRBR matches." - "Prepare a KYB evidence table with request IDs and presentation dates." Useful agent tasks include company onboarding checks, UBO enrichment, batch KYB preparation, and audit evidence collection. ### Related actors - [Poland KRS Company Registry Scraper](https://apify.com/fetch_cat/poland-krs-company-registry-scraper) - company registry records from KRS - [Google Maps Reviews Scraper](https://apify.com/fetch_cat/google-maps-reviews-scraper) - local business review extraction ### FAQ #### Does this require a login? No. It reads Poland's public CRBR register. #### Does it return full PESEL values? The actor returns values present in the public CRBR response. Handle personal data responsibly and in line with applicable law. #### Can I run batches? Yes. Add multiple objects to `searches` and set `maxResults` to your desired export size. #### What happens when a query is invalid? The actor saves an `error` row with the CRBR validation message instead of crashing the whole batch. ### Support Questions, feature requests, or run issues? Open an issue from the actor page on Apify and include: - Run ID or reproducible public URL - Input JSON (remove private batch data if needed) - Expected output - Actual output or error message - Whether the same query works in the public CRBR portal # Actor input Schema ## `searches` (type: `array`): One or more company or beneficiary searches. Use NIP/KRS/PESEL for exact compliance checks, or companyName for discovery. ## `maxResults` (type: `integer`): Stops saving rows after this limit across all searches. ## `dateFrom` (type: `string`): CRBR presentation period start date (YYYY-MM-DD). Defaults to today. ## `dateTo` (type: `string`): CRBR presentation period end date (YYYY-MM-DD). Defaults to today. ## `requestDelayMs` (type: `integer`): Polite delay between public registry requests. ## `includeRaw` (type: `boolean`): Attach the raw source response fragment to each dataset row for audits/debugging. This can make exports larger. ## Actor input object example ```json { "searches": [ { "mode": "companyName", "query": "ORLEN" } ], "maxResults": 20, "requestDelayMs": 500, "includeRaw": false } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searches": [ { "mode": "companyName", "query": "ORLEN" } ], "maxResults": 20, "requestDelayMs": 0, "includeRaw": false }; // Run the Actor and wait for it to finish const run = await client.actor("fetch_cat/poland-crbr-beneficial-owners-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searches": [{ "mode": "companyName", "query": "ORLEN", }], "maxResults": 20, "requestDelayMs": 0, "includeRaw": False, } # Run the Actor and wait for it to finish run = client.actor("fetch_cat/poland-crbr-beneficial-owners-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 '{ "searches": [ { "mode": "companyName", "query": "ORLEN" } ], "maxResults": 20, "requestDelayMs": 0, "includeRaw": false }' | apify call fetch_cat/poland-crbr-beneficial-owners-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fetch_cat/poland-crbr-beneficial-owners-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Poland CRBR Beneficial Owners Scraper", "description": "Extract Polish CRBR beneficial ownership records by NIP, KRS, company name, PESEL, or beneficiary name for AML, KYC, KYB, and due diligence.", "version": "0.1", "x-build-id": "XILKTUpBdjvHhhPew" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~poland-crbr-beneficial-owners-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-poland-crbr-beneficial-owners-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/fetch_cat~poland-crbr-beneficial-owners-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-poland-crbr-beneficial-owners-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/fetch_cat~poland-crbr-beneficial-owners-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-poland-crbr-beneficial-owners-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", "required": [ "searches" ], "properties": { "searches": { "title": "CRBR searches", "type": "array", "description": "One or more company or beneficiary searches. Use NIP/KRS/PESEL for exact compliance checks, or companyName for discovery.", "items": { "type": "object", "required": [ "mode", "query" ], "properties": { "mode": { "title": "Search mode", "type": "string", "enum": [ "companyName", "nip", "krs", "beneficiaryPesel", "beneficiaryName" ], "enumTitles": [ "Company name", "NIP", "KRS", "Beneficiary PESEL", "Beneficiary name" ], "description": "How this CRBR search should be interpreted." }, "query": { "title": "Query", "type": "string", "description": "Company name, NIP, KRS, PESEL, or beneficiary name." }, "firstName": { "title": "Beneficiary first name", "type": "string", "description": "Optional override for beneficiary name searches." }, "lastName": { "title": "Beneficiary last name", "type": "string", "description": "Optional override for beneficiary name searches." }, "pesel": { "title": "Beneficiary PESEL", "type": "string", "description": "Optional exact PESEL override for beneficiary searches." }, "birthDate": { "title": "Beneficiary birth date", "type": "string", "description": "Optional birth date in YYYY-MM-DD format for beneficiary name searches." } } } }, "maxResults": { "title": "Maximum dataset rows", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stops saving rows after this limit across all searches.", "default": 20 }, "dateFrom": { "title": "Presentation date from", "type": "string", "description": "CRBR presentation period start date (YYYY-MM-DD). Defaults to today." }, "dateTo": { "title": "Presentation date to", "type": "string", "description": "CRBR presentation period end date (YYYY-MM-DD). Defaults to today." }, "requestDelayMs": { "title": "Delay between CRBR searches (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Polite delay between public registry requests.", "default": 500 }, "includeRaw": { "title": "Include raw CRBR record", "type": "boolean", "description": "Attach the raw source response fragment to each dataset row for audits/debugging. This can make exports larger.", "default": false } } }, "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 } } } } } } } } } } ```