{ "openapi": "3.0.1", "info": { "title": "Poland Developer Apartment Prices API – Official dane.gov.pl", "description": "Every Polish developer price list published on dane.gov.pl (ceny mieszkań deweloperów, jawność cen), parsed fresh into one clean record per apartment or house, with price-change and new/sold detection. Export CSV, JSON or Excel.", "version": "0.1", "x-build-id": "x8nWo9YIrWGPNXvfm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/enterprising_hamster~polish-developer-apartment-prices/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-enterprising_hamster-polish-developer-apartment-prices", "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/enterprising_hamster~polish-developer-apartment-prices/runs": { "post": { "operationId": "runs-sync-enterprising_hamster-polish-developer-apartment-prices", "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/enterprising_hamster~polish-developer-apartment-prices/run-sync": { "post": { "operationId": "run-sync-enterprising_hamster-polish-developer-apartment-prices", "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": { "mode": { "title": "What to return", "enum": [ "offers", "priceChanges" ], "type": "string", "description": "Offers returns each unit of the newest price list of every developer dataset published in the period. Price changes compares that list with the developer's previous one and returns only differences.", "default": "offers" }, "lastDays": { "title": "Published in the last N days", "minimum": 1, "maximum": 14, "type": "integer", "description": "Price lists published on dane.gov.pl in the last N×24 hours. Ignored when a date is set below. Developers republish lists daily, so 1 day already covers most active investments.", "default": 1 }, "dateFrom": { "title": "Published from (date)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "First publication date, YYYY-MM-DD, Polish time. At most 14 days with dateTo." }, "dateTo": { "title": "Published to (date)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Last publication date, inclusive, YYYY-MM-DD, Polish time." }, "voivodeships": { "title": "Voivodeships", "type": "array", "description": "Keep units in these voivodeships (województwa). Units whose list gives no voivodeship are dropped by this filter.", "items": { "type": "string", "enum": [ "dolnośląskie", "kujawsko-pomorskie", "lubelskie", "lubuskie", "łódzkie", "małopolskie", "mazowieckie", "opolskie", "podkarpackie", "podlaskie", "pomorskie", "śląskie", "świętokrzyskie", "warmińsko-mazurskie", "wielkopolskie", "zachodniopomorskie" ] }, "default": [] }, "cities": { "title": "Cities or municipalities", "type": "array", "description": "Keep units whose city (miejscowość) or municipality (gmina) is one of these, e.g. Warszawa, Kraków. Case and Polish letters do not matter.", "default": [], "items": { "type": "string" } }, "developers": { "title": "Developer name contains", "type": "array", "description": "Keep units whose developer name, price-list title or investment name contains one of these fragments, e.g. Dom Development, Murapol.", "default": [], "items": { "type": "string" } }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Parking spaces, storage and commercial units are never returned as units; they appear as add-ons of a unit. Units whose type the list does not state are kept.", "items": { "type": "string", "enum": [ "apartment", "house" ], "enumTitles": [ "Apartments (lokale mieszkalne)", "Houses (domy jednorodzinne)" ] }, "default": [ "apartment", "house" ] }, "onlyAvailable": { "title": "Only available units", "type": "boolean", "description": "Drop units marked sold or reserved. Most lists do not state availability; those units are kept.", "default": false }, "onlyNew": { "title": "Only price lists not delivered before", "type": "boolean", "description": "Skip price lists this Actor already delivered in an earlier run with the same state key. Use with a daily schedule.", "default": false }, "stateKey": { "title": "State key", "type": "string", "description": "Separate memory for onlyNew, e.g. one key per schedule. Letters, digits, _ and -." }, "maxItems": { "title": "Max records", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stop after this many records. Each record is one charged event.", "default": 1000 }, "maxPriceLists": { "title": "Max price lists", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Read at most this many developer price lists, newest first. 0 means all.", "default": 0 }, "maxConcurrency": { "title": "Parallel downloads", "minimum": 1, "maximum": 16, "type": "integer", "description": "Price lists read at the same time.", "default": 8 }, "maxRequestsPerSecond": { "title": "Max requests per second", "minimum": 0.2, "maximum": 20, "type": "number", "description": "Politeness limit for file downloads. The dane.gov.pl API itself is always queried at 2 requests per second.", "default": 8 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }