{ "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 } } } } } } } } } }