{ "openapi": "3.0.1", "info": { "title": "Poland Tax Office Auctions Scraper - eLicytacje KAS", "description": "Every sale Polish tax offices publish on eLicytacje KAS: cars, flats, houses, land, machinery and company shares with the starting price, the valuation and the discount between them, the deposit, the location, VIN and land-registry number, and sold prices.", "version": "1.0", "x-build-id": "OB81fIaGv7nmNi75k" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/regdata~poland-elicytacje-auction-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-regdata-poland-elicytacje-auction-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/regdata~poland-elicytacje-auction-scraper/runs": { "post": { "operationId": "runs-sync-regdata-poland-elicytacje-auction-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/regdata~poland-elicytacje-auction-scraper/run-sync": { "post": { "operationId": "run-sync-regdata-poland-elicytacje-auction-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", "properties": { "sections": { "title": "Sections", "type": "array", "description": "Movables (vehicles, machinery, goods), real estate, or property rights (company shares, receivables, securities). Leave empty for all three.", "items": { "type": "string", "enum": [ "movables", "realEstate", "propertyRights" ], "enumTitles": [ "Movables - Ruchomości (vehicles, machinery, goods)", "Real estate - Nieruchomości", "Property rights - Prawa majątkowe (shares, receivables)" ] } }, "categories": { "title": "Categories", "type": "array", "description": "Narrow to these categories. Each category belongs to one section, so there is no need to pick the section as well. Leave empty for everything in the chosen sections.", "items": { "type": "string", "enum": [ "vehicles", "boats", "machinery", "electronics", "antiques", "jewellery", "furniture", "clothing", "rawMaterials", "food", "livestock", "exciseGoods", "otherMovables", "houses", "flats", "commercial", "land", "otherRealEstate", "securities", "registeredShares", "billsOfExchange", "intellectualProperty", "llcShares", "financialInstruments", "otherRights" ], "enumTitles": [ "Vehicles - Pojazdy", "Boats and yachts - Łodzie i jachty", "Machinery and tools - Maszyny i narzędzia", "Electronics - Elektronika", "Antiques and art - Antyki, sztuka", "Jewellery and watches - Biżuteria, zegarki", "Furniture - Meble", "Clothing and footwear - Odzież, obuwie", "Raw materials and fuels - Surowce, paliwa, materiały", "Food - Artykuły spożywcze", "Livestock - Inwentarz żywy", "Excise goods (tobacco, alcohol) - Wyroby akcyzowe", "Other movables - Pozostałe ruchomości", "Houses - Domy", "Flats - Mieszkania", "Commercial units, halls, warehouses - Lokale użytkowe, hale, magazyny", "Land - Grunty", "Garages, parking, shares in common parts - Inne nieruchomości", "Securities not on accounts - Papiery wartościowe", "Rights in a shareholder register - Prawa w rejestrze akcjonariuszy", "Bills of exchange - Weksle", "Copyright and industrial property - Prawa autorskie i własności przemysłowej", "Shares in a limited company - Udziały w spółce z o.o.", "Financial instruments on accounts - Instrumenty finansowe", "Other property rights - Pozostałe prawa majątkowe" ] } }, "keywords": { "title": "Keywords", "type": "string", "description": "Search the announcement titles, e.g. 'Toyota', 'ciągnik', 'działka budowlana'. At least 3 letters or digits; other characters are treated as spaces." }, "locations": { "title": "Locations", "type": "array", "description": "City or voivodeship as the portal writes it, e.g. 'Warszawa', 'Kraków', 'mazowieckie', 'lubelskie'. Each entry is searched separately and the results merged. Leave empty for the whole country.", "items": { "type": "string" } }, "statuses": { "title": "Sale status", "type": "array", "description": "Which sales to include. 'Upcoming' and 'Live' are the ones you can still bid on. 'Sold' carries the final price, which makes it the realised-price history the portal has kept since it opened on 1 July 2026.", "items": { "type": "string", "enum": [ "upcoming", "live", "sold", "unsold", "cancelled", "closed", "voided" ], "enumTitles": [ "Upcoming - not started yet", "Live - bidding open now", "Sold - with the final price", "Unsold - ended without a buyer", "Cancelled", "Closed", "Voided" ] }, "default": [ "upcoming", "live" ] }, "saleKinds": { "title": "Sale type", "type": "array", "description": "Auctions, free-hand sales at a fixed price, tenders, or real-estate valuation notices - the notice a tax office publishes before a property auction, so the earliest signal that one is coming. Leave empty for all.", "items": { "type": "string", "enum": [ "auction", "freeHandSale", "tender", "valuationNotice" ], "enumTitles": [ "Auction - licytacja", "Free-hand sale - sprzedaż z wolnej ręki", "Tender - przetarg ofert", "Real-estate valuation notice - opis i oszacowanie" ] } }, "minStartingPrice": { "title": "Minimum starting price (PLN)", "minimum": 0, "type": "integer", "description": "Lowest starting price (cena wywołania) to include. Applied by the portal itself." }, "maxStartingPrice": { "title": "Maximum starting price (PLN)", "minimum": 0, "type": "integer", "description": "Highest starting price to include. Applied by the portal itself." }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Maximum announcements to export. An announcement matched by more than one location or category is exported once, so you are never charged twice for it.", "default": 1000 }, "includeDetails": { "title": "Include full details", "type": "boolean", "description": "Adds the valuation and the discount to it, the deposit and its bank account, the item's address, the category, the tax office and its contact, the item description, vehicle data (make, model, year, VIN, registration, mileage), the land-registry (KW) number and plot data for real estate, photos and the notice PDFs. Two extra requests per announcement, so a run takes longer; the price per record is the same.", "default": false }, "onlyNewOrChanged": { "title": "Only new or changed since the last run", "type": "boolean", "description": "Monitoring mode. Exports only announcements that are new, or whose status changed (for example upcoming to sold), since the last run with the same filter. The first run exports everything and sets the baseline. Schedule it daily for an alert feed.", "default": false }, "monitorId": { "title": "Monitor name", "type": "string", "description": "Optional. Runs with the same filter share one memory automatically; give a name to keep several independent feeds for the same filter. Letters, digits, '-' and '_'." }, "minEstimatedValue": { "title": "Minimum estimated value (PLN)", "minimum": 0, "type": "integer", "description": "Lowest valuation (wartość szacunkowa) to include. Applied by the portal itself." }, "maxEstimatedValue": { "title": "Maximum estimated value (PLN)", "minimum": 0, "type": "integer", "description": "Highest valuation to include. Applied by the portal itself." }, "onlyWithDeposit": { "title": "Only sales that require a deposit", "type": "boolean", "description": "Keep only sales that require a deposit (wadium) before bidding - mostly real estate and higher-value lots.", "default": false }, "publishedFrom": { "title": "Published from", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Keep only announcements published on or after this date, YYYY-MM-DD." } } }, "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 } } } } } } } } } }