# Poland EKW Land Registry Scraper Ksiegi Wieczyste (`minute_contest/ekw-ksiegi-wieczyste-scraper`) Actor Elektroniczne Księgi Wieczyste - własność, hipoteki, służebności. Extract property data from Polish Land Registry. Ownership, mortgages, restrictions. 352 courts. No API exists. Kancelarie, banki, due diligence nieruchomości. - **URL**: https://apify.com/minute\_contest/ekw-ksiegi-wieczyste-scraper.md - **Developed by:** [minute contest](https://apify.com/minute_contest) (community) - **Categories:** Business, Real estate, Lead generation - **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: 1.00 out of 5 stars ## Pricing from $5.00 / 1,000 kw 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 EKW Land Registry Scraper | Elektroniczne Ksiegi Wieczyste Look up property ownership, mortgages, easements, and legal restrictions from Poland's official Electronic Land Registry - covering all ~25 million property entries across 352 court departments. No public API exists. ### Quick Start Click **Try it** and paste this input: ```json { "kwNumbers": ["WR1K/00094598/3"], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "PL" } } ```` > **Note:** RESIDENTIAL proxy is required - the portal blocks datacenter IPs. Requires Apify paid plan (Personal or higher). ### Sample Output ```json { "kwNumber": "WR1K/00094598/3", "courtCode": "WR1K", "courtName": "SAD REJONOWY DLA WROCLAWIA-KRZYKOW WE WROCLAWIU", "propertyType": "NIERUCHOMOSC GRUNTOWA", "viewType": "aktualna", "dzialIO": { "empty": false, "title": "DZIAL I-O - OZNACZENIE NIERUCHOMOSCI", "entries": [ { "label": "Numer dzialki", "value": "103" }, { "label": "Polozenie", "value": "DOLNOSLASKIE, M. WROCLAW, WROCLAW M., WROCLAW, PSIE POLE" }, { "label": "Ulica", "value": "NA POLANCE NR 22, 22A, 22B" }, { "label": "Obszar calej nieruchomosci", "value": "0,7957 HA" } ] }, "dzialII": { "empty": false, "title": "DZIAL II - WLASNOSC", "entries": ["..."] }, "dzialIV": { "empty": true, "rawText": "BRAK WPISOW" }, "success": true } ``` ### Pricing | Volume | Cost | |--------|------| | 1 property | $0.01 | | 100 properties | ~$1.03 | | 1,000 properties | ~$10.03 | | 10,000 properties | ~$100.03 | Start cost per run: **$0.025**. Free Apify credits ($5) = ~500 properties at no cost. ### Features - **Structured JSON output** - parsed from government HTML into clean data - **Check digit auto-calculation** - provide court code + number, check digit computed automatically - **All 5 sections** - extract any combination of Dzial I-O, I-Sp, II, III, IV - **Three view types** - current content, complete history, or legacy format - **Batch processing** - submit multiple KW numbers in one run - **352 court departments** - all Polish courts supported ### Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `kwNumbers` | string\[] | **Yes** | - | KW numbers in format `CODE/NUMBER/DIGIT` (e.g., `WR1K/00094598/3`). Check digit optional. | | `viewType` | string | No | `aktualna` | `aktualna` = current, `zupelna` = full history, `dotychczasowa` = legacy format | | `sections` | string\[] | No | all | Which sections: `IO`, `ISp`, `II`, `III`, `IV` | | `includeRawHtml` | boolean | No | `false` | Include raw HTML of each section | | `proxyConfiguration` | object | **Yes**\* | RESIDENTIAL PL | Apify Proxy - RESIDENTIAL group with country PL required | #### KW Number Format `CODE/NUMBER/DIGIT` where: - **CODE** (4 chars): Court department code (e.g., WR1K = Wroclaw-Krzyki) - **NUMBER** (8 digits): Property register number (padded with zeros) - **DIGIT** (1 digit): Check digit (auto-calculated if omitted) ### Output Fields | Field | Description | |-------|-------------| | `kwNumber` | Full KW number with check digit | | `courtCode` | Court department code | | `courtName` | Full court name | | `propertyType` | Property type (gruntowa, budynkowa, lokalowa) | | `viewType` | View type used | | `dzialIO` | Property designation - location, area, plot numbers, buildings | | `dzialISp` | Associated rights (e.g., share in common property) | | `dzialII` | Ownership - owner names, ownership shares | | `dzialIII` | Rights, claims, restrictions - easements, caveats, court orders | | `dzialIV` | Mortgages - amounts, creditors, currencies | | `success` | Whether extraction was successful | ### Use Cases - **Real Estate Due Diligence** - verify property ownership, mortgages, and restrictions before purchase - **Mortgage Verification** - check existing liens and encumbrances on a property - **Property Ownership Lookup** - find who owns a specific property - **Legal Research** - review easements, restrictions, and court orders affecting property - **Bank/Lender KYC** - verify collateral property status for loan applications ### Data Source & Compliance - **Portal**: https://przegladarka-ekw.ms.gov.pl/ - **Operator**: Ministry of Justice (Ministerstwo Sprawiedliwosci) - **Legal basis**: Ustawa o ksiegach wieczystych i hipotece (Land Registry Act) - **Access**: Free, public, no authentication required - **Coverage**: All property registers in Poland (~25 million entries) ### Polish Business Data Suite This actor is part of the **Polish Business Data Suite** - 9 actors covering the full Polish company intelligence stack. No subscriptions, no minimum commitment - pay only for what you use. | Registry | Actor | What it does | |----------|-------|-------------| | **eKRS** | [Financial Statements](https://apify.com/minute_contest/poland-krs-financial-scraper) | Balance sheets, income statements | | **KRS** | [Board Members](https://apify.com/minute_contest/krs-fullnames-scraper) | Full non-anonymized director names | | **KRZ** | [Debtor Registry](https://apify.com/minute_contest/krz-debtor-scraper) | Bankruptcy, restructuring, enforcement | | **KNF** | [Financial Supervision](https://apify.com/minute_contest/knf-registry-scraper) | 75,000+ regulated financial entities | | **MSiG** | [Court Gazette](https://apify.com/minute_contest/msig-scraper) | Court announcements since 2001 | | **EKW** | [Land Registry](https://apify.com/minute_contest/ekw-ksiegi-wieczyste-scraper) | Property ownership, mortgages, restrictions | | **CRBR** | [Beneficial Owners](https://apify.com/minute_contest/crbr-beneficial-owners-scraper) | UBO verification by NIP/KRS | | **UOKiK** | [Abusive Clauses](https://apify.com/minute_contest/uokik-clauses-scraper) | 7,500+ banned contract clauses | | **BDO** | [Waste Registry](https://apify.com/minute_contest/bdo-waste-registry-scraper) | 674,000+ waste management entities | > **Full suite**: [apify.com/minute\_contest](https://apify.com/minute_contest) ### Informacje po polsku #### Czym jest ten aktor? Ten aktor umozliwia automatyczne pobieranie tresci **Elektronicznych Ksiag Wieczystych** z portalu Ministerstwa Sprawiedliwosci. Portal przegladarka-ekw.ms.gov.pl nie udostepnia publicznego API - ten aktor automatyzuje przegladarke i zwraca ustrukturyzowane dane JSON zawierajace wszystkie dzialy ksiegi wieczystej: oznaczenie nieruchomosci, wlasnosc, obciazenia i hipoteki. #### Dla kogo? Narzedzie jest przeznaczone dla **kancelarii notarialnych** i prawnych weryfikujacych stan prawny nieruchomosci, **bankow** i instytucji finansowych sprawdzajacych obciazenia hipoteczne, **firm deweloperskich** analizujacych nieruchomosci pod katem inwestycji, **posrednikow nieruchomosci** weryfikujacych dane przed transakcja, oraz **komornikow** i syndykow sprawdzajacych status nieruchomosci dluznikow. #### Jak zaczac? Podaj numer ksiegi wieczystej w formacie KOD/NUMER/CYFRA (np. WR1K/00094598/3) i uruchom aktora na platformie Apify. Cyfra kontrolna jest opcjonalna - zostanie obliczona automatycznie. Mozesz podac wiele numerow jednoczesnie oraz wybrac, ktore dzialy chcesz pobrac. Wymagane jest proxy rezydencjalne (RESIDENTIAL) z krajem PL. ### Limitations - Processing time: ~15-30 seconds per KW (browser automation + form navigation) - The government portal may occasionally be slow or unavailable during maintenance - WAF blocks all datacenter IPs - residential PL proxy is **required** (paid Apify plan needed) - Each KW requires a separate browser session (form-based flow) - PESEL numbers visible in raw data are NOT filtered - users must handle GDPR compliance # Actor input Schema ## `kwNumbers` (type: `array`): List of KW numbers to look up. Format: 'CODE/NUMBER/DIGIT' (e.g., 'WR1K/00094598/3'). The check digit (last part) is optional - it will be auto-calculated if omitted. You can also provide just 'CODE/NUMBER'. ## `viewType` (type: `string`): 'aktualna' = Current content (default, most common). 'zupelna' = Complete content with full history of all entries. 'dotychczasowa' = Current content in legacy format. ## `sections` (type: `array`): Which sections (działy) to extract. Default: all. Options: 'IO' (property designation), 'ISp' (associated rights), 'II' (ownership), 'III' (restrictions/claims), 'IV' (mortgages). ## `includeRawHtml` (type: `boolean`): Include raw HTML content of each section in output (useful for custom parsing). ## `proxyConfiguration` (type: `object`): REQUIRED for the actor to work. The EKW government portal blocks all datacenter IPs. You must use Apify Proxy with RESIDENTIAL group and country PL. Without proxy, every request will be WAF-blocked and return an error. ## Actor input object example ```json { "kwNumbers": [ "WA4M/00160286/2" ], "viewType": "aktualna", "sections": [ "IO", "ISp", "II", "III", "IV" ], "includeRawHtml": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "PL" } } ``` # Actor output Schema ## `propertyRecords` (type: `string`): KW data with property designation (Dział I-O), ownership (Dział II), restrictions (Dział III), and mortgages (Dział IV). # 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 = { "kwNumbers": [ "WA4M/00160286/2" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "PL" } }; // Run the Actor and wait for it to finish const run = await client.actor("minute_contest/ekw-ksiegi-wieczyste-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 = { "kwNumbers": ["WA4M/00160286/2"], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "PL", }, } # Run the Actor and wait for it to finish run = client.actor("minute_contest/ekw-ksiegi-wieczyste-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 '{ "kwNumbers": [ "WA4M/00160286/2" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "PL" } }' | apify call minute_contest/ekw-ksiegi-wieczyste-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=minute_contest/ekw-ksiegi-wieczyste-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Poland EKW Land Registry Scraper Ksiegi Wieczyste", "description": "Elektroniczne Księgi Wieczyste - własność, hipoteki, służebności. Extract property data from Polish Land Registry. Ownership, mortgages, restrictions. 352 courts. No API exists. Kancelarie, banki, due diligence nieruchomości.", "version": "1.0", "x-build-id": "hEP77IYvF9HssdfWG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/minute_contest~ekw-ksiegi-wieczyste-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-minute_contest-ekw-ksiegi-wieczyste-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/minute_contest~ekw-ksiegi-wieczyste-scraper/runs": { "post": { "operationId": "runs-sync-minute_contest-ekw-ksiegi-wieczyste-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/minute_contest~ekw-ksiegi-wieczyste-scraper/run-sync": { "post": { "operationId": "run-sync-minute_contest-ekw-ksiegi-wieczyste-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": [ "kwNumbers" ], "properties": { "kwNumbers": { "title": "KW Numbers", "type": "array", "description": "List of KW numbers to look up. Format: 'CODE/NUMBER/DIGIT' (e.g., 'WR1K/00094598/3'). The check digit (last part) is optional - it will be auto-calculated if omitted. You can also provide just 'CODE/NUMBER'.", "items": { "type": "string" } }, "viewType": { "title": "View Type", "enum": [ "aktualna", "zupelna", "dotychczasowa" ], "type": "string", "description": "'aktualna' = Current content (default, most common). 'zupelna' = Complete content with full history of all entries. 'dotychczasowa' = Current content in legacy format.", "default": "aktualna" }, "sections": { "title": "Sections to Extract", "type": "array", "description": "Which sections (działy) to extract. Default: all. Options: 'IO' (property designation), 'ISp' (associated rights), 'II' (ownership), 'III' (restrictions/claims), 'IV' (mortgages).", "default": [ "IO", "ISp", "II", "III", "IV" ], "items": { "type": "string" } }, "includeRawHtml": { "title": "Include Raw HTML", "type": "boolean", "description": "Include raw HTML content of each section in output (useful for custom parsing).", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "REQUIRED for the actor to work. The EKW government portal blocks all datacenter IPs. You must use Apify Proxy with RESIDENTIAL group and country PL. Without proxy, every request will be WAF-blocked and return an error." } } }, "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 } } } } } } } } } } ```