# Polish KRS Company Leads - New & Changed Companies (`burly_bat/polish-fresh-company-leads-krs`) Actor Export new and changed Polish KRS company records from the official KRS Open API. Filter by date, region, legal form and PKD for KYB, vendor discovery and B2B market research. - **URL**: https://apify.com/burly\_bat/polish-fresh-company-leads-krs.md - **Developed by:** [Burly Bat](https://apify.com/burly_bat) (community) - **Categories:** Lead generation, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Polish Fresh Company Leads - KRS New & Changed Companies Turn the official Polish KRS daily bulletin into a clean registry-monitoring and KYB feed. This Actor reads the public KRS Open API daily bulletin, fetches current company extracts, and returns normalized company records that are useful for KYB, vendor discovery and market research workflows. ### What It Returns - Company name, KRS, REGON and NIP when returned by the official API - Legal form, registration date and last KRS entry date - Voivodeship, county, city and postal code - PKD activity codes and descriptions - Freshness flags: new registration vs recently changed company - Buyer-persona match labels for accounting, agency and B2B SaaS use cases - Source API URL and public registry URL ### Safe Scope This MVP is KRS-first and uses official public registry/open-data endpoints. It does not scrape private websites, does not enrich records with emails or phone numbers, does not use proxies, and does not extract unmasked personal data from PDFs. Users are responsible for lawful use of exported data, GDPR obligations, marketing consent rules, and data-subject rights. This Actor is not affiliated with the Polish Ministry of Justice, KRS, CEIDG, Biznes.gov.pl, or Apify. ### Input - `dateFrom` / `dateTo` - KRS bulletin date range, capped at 7 days - `leadMode` - `new_registrations` or `new_or_changed` - `presetPersona` - `all_b2b`, `accounting_offices`, `marketing_agencies`, `b2b_saas_sales` - `voivodeships`, `pkdPrefixes`, `legalForms` - optional filters - `maxCompanyAgeDays` - new-registration freshness window - `maxItems` - capped export limit ### Example Output ```json { "leadId": "krs:0000000153", "source": "KRS Open API", "krs": "0000000153", "entityName": "EXAMPLE SOFTWARE SPOLKA Z OGRANICZONA ODPOWIEDZIALNOSCIA", "legalForm": "SPOLKA Z OGRANICZONA ODPOWIEDZIALNOSCIA", "registrationDate": "2026-06-15", "lastEntryDate": "2026-06-29", "isNewRegistration": true, "freshnessDays": 14, "voivodeship": "MAZOWIECKIE", "city": "WARSZAWA", "pkdPrimaryCode": "62.01.Z", "pkdPrimaryName": "DZIALALNOSC ZWIAZANA Z OPROGRAMOWANIEM", "buyerPersonaMatch": "b2b_saas_sales", "matchReasons": ["new_registration_window", "persona_match:b2b_saas_buyer"], "riskFlags": ["public_registry_data_only", "no_private_contact_enrichment"] } ```` ### Pricing Draft Recommended Store monetization: pay per returned dataset item using `apify-default-dataset-item` / `Returned company record`. Starting draft: **3.00 USD / 1000 returned records** and no monthly rental. Increase only after non-owner runs or paid events prove demand and real usage cost. ### Related Actor Need Polish public-sector buyer intent as well? Use the companion Actor: `Polish IT Tenders Feed - BZP Procurement Leads`. # Actor input Schema ## `dateFrom` (type: `string`): First KRS bulletin date in YYYY-MM-DD format. Defaults to dateTo. ## `dateTo` (type: `string`): Last KRS bulletin date in YYYY-MM-DD format. Defaults to today. ## `leadMode` (type: `string`): Export only newly registered companies or also recently changed KRS companies. ## `presetPersona` (type: `string`): Optional lead-use preset used for match labels and practical filtering defaults. ## `voivodeships` (type: `array`): Optional uppercase Polish voivodeship names, e.g. MAZOWIECKIE. ## `pkdPrefixes` (type: `array`): Optional PKD prefixes such as 62, 63, 73 or 69. ## `legalForms` (type: `array`): Optional legal-form keywords such as SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ. ## `maxCompanyAgeDays` (type: `integer`): A company is treated as newly registered when registration date is within this number of days. ## `maxItems` (type: `integer`): Maximum company leads to export. Kept deliberately low for safe public API usage. ## Actor input object example ```json { "leadMode": "new_or_changed", "presetPersona": "all_b2b", "maxCompanyAgeDays": 31, "maxItems": 50 } ``` # Actor output Schema ## `results` (type: `string`): Dataset items with company name, KRS, REGON/NIP when returned by the official API, PKD, region, registration date, last entry date and source links. ## `summary` (type: `string`): Run summary stored in the default key-value store under the OUTPUT key. # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("burly_bat/polish-fresh-company-leads-krs").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 = {} # Run the Actor and wait for it to finish run = client.actor("burly_bat/polish-fresh-company-leads-krs").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 '{}' | apify call burly_bat/polish-fresh-company-leads-krs --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=burly_bat/polish-fresh-company-leads-krs", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Polish KRS Company Leads - New & Changed Companies", "description": "Export new and changed Polish KRS company records from the official KRS Open API. Filter by date, region, legal form and PKD for KYB, vendor discovery and B2B market research.", "version": "0.1", "x-build-id": "szoS4DiT7cTpGlYCH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/burly_bat~polish-fresh-company-leads-krs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-burly_bat-polish-fresh-company-leads-krs", "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/burly_bat~polish-fresh-company-leads-krs/runs": { "post": { "operationId": "runs-sync-burly_bat-polish-fresh-company-leads-krs", "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/burly_bat~polish-fresh-company-leads-krs/run-sync": { "post": { "operationId": "run-sync-burly_bat-polish-fresh-company-leads-krs", "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": { "dateFrom": { "title": "Date from", "type": "string", "description": "First KRS bulletin date in YYYY-MM-DD format. Defaults to dateTo." }, "dateTo": { "title": "Date to", "type": "string", "description": "Last KRS bulletin date in YYYY-MM-DD format. Defaults to today." }, "leadMode": { "title": "Lead mode", "enum": [ "new_registrations", "new_or_changed" ], "type": "string", "description": "Export only newly registered companies or also recently changed KRS companies.", "default": "new_or_changed" }, "presetPersona": { "title": "Buyer persona preset", "enum": [ "all_b2b", "accounting_offices", "marketing_agencies", "b2b_saas_sales" ], "type": "string", "description": "Optional lead-use preset used for match labels and practical filtering defaults.", "default": "all_b2b" }, "voivodeships": { "title": "Voivodeships", "type": "array", "description": "Optional uppercase Polish voivodeship names, e.g. MAZOWIECKIE.", "items": { "type": "string" } }, "pkdPrefixes": { "title": "PKD prefixes", "type": "array", "description": "Optional PKD prefixes such as 62, 63, 73 or 69.", "items": { "type": "string" } }, "legalForms": { "title": "Legal forms", "type": "array", "description": "Optional legal-form keywords such as SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ.", "items": { "type": "string" } }, "maxCompanyAgeDays": { "title": "Max company age days", "minimum": 1, "maximum": 366, "type": "integer", "description": "A company is treated as newly registered when registration date is within this number of days.", "default": 31 }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum company leads to export. Kept deliberately low for safe public API usage.", "default": 50 } } }, "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 } } } } } } } } } } ```