# Poland Bailiff Auctions API - Komornik Auctions in English (`webdata_labs/poland-komornik-auctions-api`) Actor \[💵 $4.00 / 1K] Licytacje komornicze z licytacje.komornik.pl: nieruchomości, cena wywołania, wartość oszacowania, rękojmia, województwo. Clean English schema for international investors - appraisal, opening bid, discount %, auction round, deposit, deadlines & coordinates. Not a raw portal dump. - **URL**: https://apify.com/webdata\_labs/poland-komornik-auctions-api.md - **Developed by:** [WebData Labs](https://apify.com/webdata_labs) (community) - **Categories:** Developer tools, Lead generation, Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $4.00 / 1,000 auction records 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/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 Bailiff Auctions API - Komornik Judicial Auctions in English Structured, investor-ready data from **licytacje.komornik.pl**, Poland's official register of bailiff (*komornik*) judicial auctions - the single portal every enforced sale of real estate and movable property must be published on. This is **not a raw portal dump**. Every auction is normalized into one clean English lead row with the numbers a property investor actually needs: the court appraisal, the opening bid, **how far below the appraisal that opening sits (discount %)**, the implied **auction round**, the required deposit, and every deadline - so you can filter a distressed -asset pipeline without reading Polish enforcement notices. ### What you get One row per auction, in English: - **Economics (PLN):** `appraisalValue` (wartość oszacowania), `openingBid` (cena wywołania), `discountPctVsAppraisal`, `auctionRound` (FIRST / SECOND, inferred from the statutory opening ratio), `depositEstimate` (rękojmia, 1/10 of the appraisal). - **Classification:** `assetClass` (REAL_ESTATE / MOVABLE / OTHER), `category` (Apartment, House, Land, Commercial premises, Car...), `auctionType` (E_AUCTION / STATIONARY). - **Schedule:** `auctionStartAt`, `auctionEndAt`, `depositDeadline`, `publishedAt`. - **Location:** structured `address` (street, building/flat no., postal code, city), `province` (English voivodeship name), `provinceCode`, `latitude`/`longitude` when present. - **Links:** `announcementUrl` to the official listing. - Optional (`includeDetails`): `description`, `bailiffOffice`, `caseSignature`, exact `depositAmount`. ### Why the discount and round matter Under Polish enforcement law the opening bid is a fixed fraction of the court appraisal: **3/4 at the first auction, 2/3 at the second**. So a 25% discount signals a first auction, ~33% signals a second (cheaper) auction. The raw portal never gives you this - the API derives it on every row, so you can sort a whole voivodeship by real discount in one pass. ### Example input ```json { "province": "Masovia", "assetType": "real-estate", "eauctionOnly": true, "maxOpeningBid": 500000, "sortBy": "auction-date", "maxResults": 100 } ```` Accepts a Polish slug or English name for `province` (`mazowieckie` or `Masovia`, `malopolskie` or `Lesser Poland`, `slaskie` or `Silesia`). Leave it empty to search all of Poland. To pull specific listings, pass `itemIds` (the number in a `.../items/` URL) and the search filters are ignored. ### Example output row ```json { "recordType": "auction", "itemId": 77407, "announcementUrl": "https://licytacje.komornik.pl/items/77407", "title": "I e-licytacja lokalu mieszkalnego w Gorzowie Wielkopolskim", "assetClass": "REAL_ESTATE", "category": "Apartment", "auctionType": "E_AUCTION", "currency": "PLN", "appraisalValue": 439500.0, "openingBid": 329625.0, "discountPctVsAppraisal": 25.0, "auctionRound": "FIRST", "depositEstimate": 43950.0, "auctionStartAt": "2026-09-24T11:00:00+02:00", "depositDeadline": "2026-09-22T23:59:59+02:00", "address": { "street": "ul.Brukselska", "buildingNo": "7A", "flatNo": "3", "postalCode": "66-400", "city": "Gorzów Wielkopolski", "province": "Lubusz" }, "province": "Lubusz", "provinceCode": "lubuskie" } ``` ### Use cases - **Distressed real-estate sourcing** - filter apartments/houses/land by voivodeship, discount, and round. - **Investor lead feeds** - schedule the Actor and push new second-round (deepest-discount) auctions to a CRM. - **Vehicle/equipment resale** - `assetType: movable` for cars, trucks, and machinery below market. - **Market monitoring** - track appraisal-vs-opening spreads across regions over time. ### Pricing Pay per result: **$4.00 / 1,000 auction records** (platform usage included, no per-run start fee). ### Notes - Data comes from the official public register. Values are in Polish złoty (PLN). - `auctionRound` and `depositEstimate` are derived from statutory ratios; enable `includeDetails` for the portal's exact deposit when published. - Enabling Apify Proxy (Polish residential recommended) keeps large runs reliable. *** ### Po polsku **API licytacji komorniczych** - dane z oficjalnego portalu **licytacje.komornik.pl** w czystym, angielskim schemacie dla inwestorów. Zamiast surowego zrzutu strony dostajesz jeden uporządkowany wiersz na licytację: **wartość oszacowania**, **cena wywołania**, **procent dyskonta**, **numer licytacji** (pierwsza/druga), **rękojmia**, terminy i lokalizacja (województwo, miasto, adres). Filtruj po województwie, kategorii (mieszkania, domy, działki, lokale, pojazdy), cenie i typie licytacji (e-licytacja). Cena: **$4.00 / 1000 rekordów**. # Actor input Schema ## `province` (type: `string`): Polish voivodeship to search. Accepts the Polish slug or English name: 'mazowieckie'/'Masovia', 'malopolskie'/'Lesser Poland', 'slaskie'/'Silesia', 'dolnoslaskie'/'Lower Silesia'... Leave empty to search all of Poland. ## `city` (type: `string`): Optional city filter, e.g. 'Warszawa', 'Kraków', 'Wrocław'. Combined with the voivodeship. ## `assetType` (type: `string`): What kind of asset is being auctioned. ## `eauctionOnly` (type: `boolean`): Return only electronic auctions (e-licytacja) you can bid on online, excluding traditional in-person auctions. ## `minOpeningBid` (type: `integer`): Only auctions with an opening bid (cena wywołania) at or above this amount, in Polish złoty. ## `maxOpeningBid` (type: `integer`): Only auctions with an opening bid at or below this amount, in Polish złoty. ## `searchQuery` (type: `string`): Free-text search over the auction title, e.g. 'lokal mieszkalny' or a street/city name. ## `sortBy` (type: `string`): How to order results before the max-results cap is applied. ## `itemIds` (type: `string`): Fetch specific auction items directly instead of searching. One or more item IDs (the number in a licytacje.komornik.pl/items/ URL), separated by comma, space or new line. When set, the search filters above are ignored. ## `includeDetails` (type: `boolean`): Fetch each auction's detail record (description, bailiff office, case signature, exact deposit). Two extra light requests per auction. Off = search rows only, faster and gentler on the portal. ## `maxResults` (type: `integer`): Safety cap on how many auctions to return in one run. ## `includeRaw` (type: `boolean`): Attach the original Polish API payloads under 'raw' for auditing. Off by default to keep rows clean. ## `proxyConfiguration` (type: `object`): Required. The komornik portal serves an empty result set to datacenter IPs, so Polish RESIDENTIAL proxy is the default and recommended setting. The Actor automatically rotates residential exit IPs until it finds one the portal serves. ## Actor input object example ```json { "province": "Masovia", "assetType": "real-estate", "eauctionOnly": false, "sortBy": "newest", "includeDetails": false, "maxResults": 50, "includeRaw": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "PL" } } ``` # Actor output Schema ## `OUTPUT` (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 = { "province": "Masovia" }; // Run the Actor and wait for it to finish const run = await client.actor("webdata_labs/poland-komornik-auctions-api").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 = { "province": "Masovia" } # Run the Actor and wait for it to finish run = client.actor("webdata_labs/poland-komornik-auctions-api").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 '{ "province": "Masovia" }' | apify call webdata_labs/poland-komornik-auctions-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=webdata_labs/poland-komornik-auctions-api", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Poland Bailiff Auctions API - Komornik Auctions in English", "description": "[💵 $4.00 / 1K] Licytacje komornicze z licytacje.komornik.pl: nieruchomości, cena wywołania, wartość oszacowania, rękojmia, województwo. Clean English schema for international investors - appraisal, opening bid, discount %, auction round, deposit, deadlines & coordinates. Not a raw portal dump.", "version": "0.1", "x-build-id": "Ezoi2u6AMHbKeZpmD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webdata_labs~poland-komornik-auctions-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webdata_labs-poland-komornik-auctions-api", "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/webdata_labs~poland-komornik-auctions-api/runs": { "post": { "operationId": "runs-sync-webdata_labs-poland-komornik-auctions-api", "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/webdata_labs~poland-komornik-auctions-api/run-sync": { "post": { "operationId": "run-sync-webdata_labs-poland-komornik-auctions-api", "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": { "province": { "title": "Voivodeship (province)", "type": "string", "description": "Polish voivodeship to search. Accepts the Polish slug or English name: 'mazowieckie'/'Masovia', 'malopolskie'/'Lesser Poland', 'slaskie'/'Silesia', 'dolnoslaskie'/'Lower Silesia'... Leave empty to search all of Poland." }, "city": { "title": "City (optional)", "type": "string", "description": "Optional city filter, e.g. 'Warszawa', 'Kraków', 'Wrocław'. Combined with the voivodeship." }, "assetType": { "title": "Asset type", "enum": [ "real-estate", "movable", "other" ], "type": "string", "description": "What kind of asset is being auctioned.", "default": "real-estate" }, "eauctionOnly": { "title": "E-auctions only", "type": "boolean", "description": "Return only electronic auctions (e-licytacja) you can bid on online, excluding traditional in-person auctions.", "default": false }, "minOpeningBid": { "title": "Min opening bid (PLN)", "minimum": 0, "type": "integer", "description": "Only auctions with an opening bid (cena wywołania) at or above this amount, in Polish złoty." }, "maxOpeningBid": { "title": "Max opening bid (PLN)", "minimum": 0, "type": "integer", "description": "Only auctions with an opening bid at or below this amount, in Polish złoty." }, "searchQuery": { "title": "Free-text search (optional)", "type": "string", "description": "Free-text search over the auction title, e.g. 'lokal mieszkalny' or a street/city name." }, "sortBy": { "title": "Sort order", "enum": [ "newest", "oldest", "auction-date", "opening-price-asc", "opening-price-desc", "estimate-desc" ], "type": "string", "description": "How to order results before the max-results cap is applied.", "default": "newest" }, "itemIds": { "title": "Specific item IDs (optional)", "type": "string", "description": "Fetch specific auction items directly instead of searching. One or more item IDs (the number in a licytacje.komornik.pl/items/ URL), separated by comma, space or new line. When set, the search filters above are ignored." }, "includeDetails": { "title": "Fetch full details", "type": "boolean", "description": "Fetch each auction's detail record (description, bailiff office, case signature, exact deposit). Two extra light requests per auction. Off = search rows only, faster and gentler on the portal.", "default": false }, "maxResults": { "title": "Max auctions", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Safety cap on how many auctions to return in one run.", "default": 50 }, "includeRaw": { "title": "Include raw fields", "type": "boolean", "description": "Attach the original Polish API payloads under 'raw' for auditing. Off by default to keep rows clean.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Required. The komornik portal serves an empty result set to datacenter IPs, so Polish RESIDENTIAL proxy is the default and recommended setting. The Actor automatically rotates residential exit IPs until it finds one the portal serves.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "PL" } } } }, "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 } } } } } } } } } } ```