{ "openapi": "3.0.1", "info": { "title": "Otodom Pl $0.8馃挵 URL Search | Location Filters | Rich Output", "description": "Pull property listings from Otodom.pl. Apartments, houses, plots, commercial, garages, new developments, rooms; sale and rent. Search builder (city + transaction + property type + filters) and URL-paste modes.", "version": "1.0", "x-build-id": "PNRoh0FXtmCjHrzfR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~otodom-pl-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-otodom-pl-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/abotapi~otodom-pl-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-otodom-pl-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/abotapi~otodom-pl-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-otodom-pl-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": [ "mode" ], "properties": { "mode": { "title": "1. Search mode", "enum": [ "search", "url" ], "type": "string", "description": "Search mode = pick transaction + property type + cities + filters below. URL mode = paste any Otodom search URL refined in a browser (recommended for filters not exposed below, like district/neighborhood).", "default": "search" }, "transaction": { "title": "Transaction", "enum": [ "sprzedaz", "wynajem" ], "type": "string", "description": "Sale (sprzeda偶) or rent (wynajem). Used to build the canonical Otodom URL.", "default": "sprzedaz" }, "estate": { "title": "Property type", "enum": [ "mieszkanie", "dom", "dzialka", "lokal", "garaz", "inwestycja", "pokoj" ], "type": "string", "description": "Otodom property type segment. Apartment (mieszkanie), house (dom), plot (dzia艂ka), commercial (lokal), garage (gara偶), investment / new development (inwestycja), room (pok贸j).", "default": "mieszkanie" }, "locations": { "title": "Cities", "type": "array", "description": "Polish city names. Recognized: Warszawa, Krak贸w, Wroc艂aw, Gda艅sk, 艁贸d藕, Pozna艅, Szczecin, Bydgoszcz, Lublin, Bia艂ystok, Katowice, Gdynia, Sopot, Gliwice, Zabrze, Rzesz贸w, Olsztyn, Toru艅, Kielce, Radom, Cz臋stochowa, Bytom, Tychy, Opole, Sosnowiec, plus all 16 voivodeship names. For unknown / smaller cities, leave empty (Poland-wide search) or use URL mode. The cartesian product of property type 脳 city is searched.", "items": { "type": "string" } }, "marketType": { "title": "Market type", "enum": [ "all", "primary", "secondary" ], "type": "string", "description": "Filter by primary (rynek pierwotny, new from developer) or secondary (rynek wt贸rny, resale). Default = both.", "default": "all" }, "minPrice": { "title": "Min price (PLN)", "minimum": 0, "type": "integer", "description": "Lower bound on totalPrice (PLN). Optional." }, "maxPrice": { "title": "Max price (PLN)", "minimum": 0, "type": "integer", "description": "Upper bound on totalPrice (PLN). Optional." }, "minArea": { "title": "Min area (m虏)", "minimum": 0, "type": "integer", "description": "Lower bound on areaInSquareMeters. Optional." }, "maxArea": { "title": "Max area (m虏)", "minimum": 0, "type": "integer", "description": "Upper bound on areaInSquareMeters. Optional." }, "minRooms": { "title": "Min rooms", "minimum": 1, "maximum": 10, "type": "integer", "description": "Minimum number of rooms (1-10)." }, "maxRooms": { "title": "Max rooms", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum number of rooms (1-10)." }, "sortBy": { "title": "Sort order", "enum": [ "DEFAULT", "LATEST", "PRICE_ASC", "PRICE_DESC", "AREA_ASC", "AREA_DESC" ], "type": "string", "description": "Default = newest. Otodom inserts promoted listings ahead of organic order regardless of sort, so sort is best-effort.", "default": "DEFAULT" }, "urls": { "title": "Search URLs (URL mode)", "type": "array", "description": "One or more full otodom.pl URLs. Tip: open otodom.pl in your browser, refine your search (city, district, filters), copy the URL from the address bar. Multi-URL supported. Filter fields above are ignored. Pagination starts at the page in the URL and walks forward.", "items": { "type": "string" } }, "maxPages": { "title": "Max pages per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on how many SERP pages to walk per city 脳 property type combination (or per pasted URL). Each page returns ~36 listings.", "default": 2 }, "maxListings": { "title": "Max listings (total)", "minimum": 0, "type": "integer", "description": "Stop after this many listings across all searches. 0 = no cap.", "default": 0 }, "fetchDetails": { "title": "Fetch detail pages (richer data, slower)", "type": "boolean", "description": "When ON, also fetch each listing's detail page for GPS coordinates, full description, agent phone, building year, ownership type, full feature list. SERP cards already carry id, title, price, area, rooms, city, province, agency, image. Latitude/longitude only appear on detail pages. Default ON.", "default": true }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Default = Apify residential with country=PL. Gives clean first-try fetches and the fastest end-to-end wall time." } } }, "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 } } } } } } } } } }