# KRS Poland Business Registry Scraper (`parseforge/krs-poland-scraper`) Actor

Scrapes the official Polish National Court Register (KRS) by 10-digit KRS number. Returns the full current excerpt for entrepreneurs and associations as a flat row.

- **URL**: https://apify.com/parseforge/krs-poland-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Lead generation, Business, Other
- **Stats:** 23 total users, 2 monthly users, 90.9% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $6.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.
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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

[![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)](https://apify.com/parseforge?fpr=vmoqkp)

### KRS Poland Business Registry Scraper

**Scrape official Polish company data from the National Court Register (KRS) by KRS number.** Get the full current excerpt for any business, association, or foundation in one flat record. No login, no API key. Export to CSV, JSON, Excel, or XML.

The Polish National Court Register (Krajowy Rejestr Sądowy) holds the legal filings for every registered company, association, and foundation in Poland. Getting structured data out means either manual lookups on the government portal or building a parser for its HTML. This Actor reads the official public excerpts directly, so you get the current registration details for a list of KRS numbers in one run.

| Who uses it | What they scrape KRS Poland for |
|---|---|
| Compliance officers | Verify a Polish counterparty's registration status and legal representatives before signing a contract. |
| Business data resellers | Enrich a CRM with official Polish company names, addresses, and share capital from the primary source. |
| Investigative journalists | Pull the board members and supervisory board of a set of Polish foundations or associations. |
| Procurement teams | Check that a Polish supplier is an active entrepreneur and not in bankruptcy or liquidation. |

### What it does

This Actor collects the full current excerpt for each KRS number you provide and returns every section as a flat row.

- 🏢 **Entrepreneurs and associations:** choose registry type 'P' for companies or 'S' for foundations and associations.
- 🔢 **Bulk KRS lookup:** paste up to a million 10-digit KRS numbers and get the full excerpt for each.
- 📋 **Fixed schema:** every run returns the same fields, so your downstream pipeline stays stable.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

### What you can do with KRS Poland data

**📋 Due diligence on Polish companies.**

A compliance analyst runs a list of KRS numbers before a quarterly review to confirm each entity is still active and to record its current management board.

**🗂️ Enrich a lead list with official registration data.**

A sales operations manager matches a spreadsheet of Polish prospects by KRS number and appends the registered address, NIP, and share capital.

**🔍 Investigate a network of foundations.**

A researcher provides KRS numbers for several related foundations and collects their statutory purposes and board members to map connections.

**📊 Monitor registry changes over time.**

A data team schedules weekly runs for a watchlist of KRS numbers and diffs the excerpts to spot changes in management or legal status.

### Why choose this scraper

|  | What you get |
|---|---|
| **Primary source** | Data comes directly from the public KRS excerpt, not a third-party cache. |
| **No parsing needed** | The Actor handles the government portal's structure and returns clean fields. |
| **Batch lookups** | Provide a list of KRS numbers and collect them all in one run. |

### How it compares

No other Store actor targets KRS Poland the same way, so the honest comparison is with the alternatives teams actually weigh.

| | KRS Poland Business Registry Scraper | Build it in-house | By hand |
|---|---|---|---|
| Setup | Run it now, zero config | Days of engineering | None, but hours per pull |
| When KRS Poland changes | Maintained for you | You fix it | You re-learn the page |
| Proxies, retries, anti-bot | Built in | Your problem | Browser only |
| Output | Fixed JSON schema, CSV/Excel export | Whatever you build | Copy-paste |
| Cost | Pay per result | Engineering time | Analyst hours |

### Configure the run

Drive the Actor from a list of 10-digit KRS numbers and choose the registry type. The official excerpt is fetched for each number and only the current data reaches your dataset. The Input tab lists every parameter.

A first run with the defaults:

```json
{
  "maxItems": 10,
  "krsNumbers": [
    "0000033014",
    "0000006494"
  ]
}
```

A larger pull:

```json
{
  "maxItems": 200,
  "krsNumbers": [
    "0000033014",
    "0000006494"
  ]
}
```

### Pricing

Pay-per-result: **$0.0065 per result** collected. You pay only for the results written to your dataset.

| Results collected | Approximate cost |
|---|---|
| 100 results | $0.65 |
| 1,000 results | $6.50 |
| 10,000 results | $65.00 |

New Apify accounts start with $5 in free credit.

### Free users

Free-plan runs return up to 10 results as a preview. [Upgrade your Apify plan](https://console.apify.com/sign-up?fpr=vmoqkp) to collect up to 1,000,000 results per run.

### Run it

1. [Create a free Apify account with $5 in credit](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the [KRS Poland Business Registry Scraper](https://apify.com/parseforge/krs-poland-scraper?fpr=vmoqkp).
3. Set your inputs and any filters, then click **Start**.
4. Export the results as CSV, Excel, JSON, or XML from the **Dataset** tab.

Run it programmatically through the [Apify API](https://docs.apify.com/api/v2) (`run-sync-get-dataset-items`) or the [ApifyClient](https://docs.apify.com/api/client/js) for JavaScript and Python.

### Use with AI agents (MCP)

Give an AI agent live access to KRS Poland through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

```bash
claude mcp add --transport http apify "https://mcp.apify.com/?tools=parseforge/krs-poland-scraper"
```

Then prompt it in plain language to run the scraper and read back the results.

### Troubleshooting

**Why did some of my KRS numbers return no data?**

Check that the number is exactly 10 digits and belongs to the registry type you selected. A number for an association will not return data if you chose type P for entrepreneurs.

**The run is slow when I provide thousands of KRS numbers.**

The Actor reads the public portal sequentially to avoid being blocked. For large lists, expect roughly one lookup per second. You can split the list across multiple runs.

**I got a timeout error on some numbers.**

The government portal can be slow during business hours in Poland. The Actor retries automatically. If timeouts persist, reduce the maxItems and run the list in smaller batches.

**The NIP field is empty for a company I know has one.**

The Actor returns exactly what the public excerpt contains. Some older entries may not have the NIP populated in the register. Verify the number on the official KRS portal manually.

**Can I get the data in English?**

The official register is maintained in Polish only. The Actor returns the original Polish text. You can use a translation API on the exported dataset if needed.

### FAQ

| Question | Answer |
|---|---|
| What is a KRS number? | A KRS number is a 10-digit identifier assigned to every entity registered in the Polish National Court Register. You can find it on a company's website, on their invoices, or by searching the public KRS portal. |
| Does this Actor return historical excerpts or only the current one? | It returns the current full excerpt as shown on the public portal. Historical filings are not included. |
| What is the difference between registry type P and S? | Type P covers entrepreneurs, which includes commercial companies like sp. z o.o. and S.A. Type S covers associations, foundations, and other non-commercial organizations. |
| Can I search by company name instead of KRS number? | No, this Actor looks up entities by their 10-digit KRS number. You need to obtain the KRS number first, for example from a VAT invoice or a web search. |
| Is the data in Polish or English? | The data is returned as it appears in the official register, which is in Polish. Field names are in English for easier processing. |
| Does this Actor provide the NIP or REGON numbers? | Yes, the current excerpt includes the NIP and REGON identifiers when they are present in the register. |
| How many KRS numbers can I look up in one run? | You can set the maximum up to one million. The Actor processes each number sequentially and respects the portal's response time. |
| Do I need a Polish IP address to use this Actor? | No, the public KRS portal is accessible from any location. The Actor runs on Apify's infrastructure and does not require a Polish IP. |
| What format does the output come in? | You can export your dataset to CSV, JSON, Excel, or XML from the Apify console or via API. |
| Does the Actor handle KRS numbers for entities that have been dissolved? | If the entity still has a public excerpt available, the Actor will return it. If the number is no longer in the register, that lookup will be skipped. |

### Related actors

Browse the full [ParseForge collection](https://apify.com/parseforge?fpr=vmoqkp) for more scrapers.

🆘 **Need help?** Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ **Disclaimer.** This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Polish Ministry of Justice. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

# Actor input Schema

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

How many companies to collect per run.

## `krsNumbers` (type: `array`):

10-digit KRS numbers to look up (e.g. '0000033014').

## `registry` (type: `string`):

'P' for Entrepreneurs (companies); 'S' for Associations, foundations.

## Actor input object example

```json
{
  "maxItems": 10,
  "krsNumbers": [
    "0000033014",
    "0000006494"
  ],
  "registry": "P"
}
```

# 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 = {
    "maxItems": 10,
    "krsNumbers": [
        "0000033014",
        "0000006494"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/krs-poland-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 = {
    "maxItems": 10,
    "krsNumbers": [
        "0000033014",
        "0000006494",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/krs-poland-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 '{
  "maxItems": 10,
  "krsNumbers": [
    "0000033014",
    "0000006494"
  ]
}' |
apify call parseforge/krs-poland-scraper --silent --output-dataset

```

## MCP server setup

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