Otodom Property Scraper — Poland Sale + Rent · PLN/m² Market
Pricing
from $1.50 / 1,000 property extracteds
Otodom scraper and Polish real estate data API for Poland. Search sale and rental listings by location, ZIP, coordinates, polygon or URL; return price, PLN per square metre, area, rooms, floor, primary or secondary market, geo coordinates, agency details and advertiser contacts.
You can access the Otodom Property Scraper — Poland Sale + Rent · PLN/m² Market programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "1.0", "x-build-id": "GxzEXHP3BK6RppR6e" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~otodom-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-otodom-property-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/sian.agency~otodom-property-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-otodom-property-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/sian.agency~otodom-property-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-otodom-property-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": { "listingType": { "title": "🏠 Listing Type", "enum": [ "sale", "rent", "both" ], "type": "string", "description": "Which side of the market to scrape.\n\n• **sale** — for-sale listings\n• **rent** — rental listings\n• **both** — runs each query twice, once for sale and once for rent (PAID — doubles the query count)", "default": "sale" }, "searchMode": { "title": "🧭 Search Mode", "enum": [ "location", "zip", "coordinates", "polygon", "url" ], "type": "string", "description": "How to specify where to search.\n\n• **location** — free-text place name (e.g. Warszawa)\n• **zip** — Polish postal code (NN-NNN)\n• **coordinates** — latitude + longitude (+ radius)\n• **polygon** — a drawn map area\n• **url** — an Otodom search-results URL", "default": "location" }, "location": { "title": "📍 Location (Search Mode = location)", "type": "string", "description": "Polish place name — a city, district, or voivodeship. Examples: 'Warszawa', 'Kraków', 'Gdańsk, pomorskie'.", "default": "Warszawa" }, "locations": { "title": "📋 Bulk Locations (PAID, location mode)", "uniqueItems": true, "type": "array", "description": "Array of Polish place names. PAID tier only.", "items": { "type": "string" } }, "zipCode": { "title": "📮 ZIP Code (Search Mode = zip)", "type": "string", "description": "Polish postal code in NN-NNN format. Example: '00-950'." }, "zipCodes": { "title": "📋 Bulk ZIP Codes (PAID, zip mode)", "uniqueItems": true, "type": "array", "description": "Array of Polish postal codes (NN-NNN). PAID tier only.", "items": { "type": "string" } }, "latitude": { "title": "🌐 Latitude (Search Mode = coordinates)", "type": "number", "description": "Latitude of the search centre (-90 to 90)." }, "longitude": { "title": "🌐 Longitude (Search Mode = coordinates)", "type": "number", "description": "Longitude of the search centre (-180 to 180)." }, "radius": { "title": "📏 Radius (km) (Search Mode = coordinates)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Search radius in kilometres around the centre point. Leave empty for the default." }, "polygon": { "title": "✏️ Polygon (Search Mode = polygon)", "type": "string", "description": "A polygon ring as 'lon lat,lon lat,...' pairs. Copy it from an Otodom map draw-search." }, "url": { "title": "🔗 Search URL (Search Mode = url)", "type": "string", "description": "An Otodom search-results URL (starts with https://www.otodom.pl/). All filters encoded in the URL are respected." }, "urls": { "title": "📋 Bulk Search URLs (PAID, url mode)", "uniqueItems": true, "type": "array", "description": "Array of Otodom search-results URLs. PAID tier only.", "items": { "type": "string" } }, "propertyType": { "title": "🏷 Property Type", "enum": [ "Flat", "House", "Land", "Commercial", "Warehouse", "Garage", "Room", "Investment" ], "type": "string", "description": "Filter by property type. Leave empty for all types." }, "market": { "title": "🏢 Market", "enum": [ "All", "Primary", "Secondary" ], "type": "string", "description": "Primary (new / from developer), Secondary (resale), or All." }, "ownerType": { "title": "👤 Advertiser Type", "enum": [ "All", "Agency", "Private", "Developer" ], "type": "string", "description": "Filter by who posted the listing." }, "sortOrder": { "title": "↕️ Sort Order", "enum": [ "Relevance", "Newest", "Price_Low_to_High", "Price_High_to_Low", "Price_Per_Meter_Low", "Area_Large_to_Small" ], "type": "string", "description": "Ordering of the search results." }, "minPrice": { "title": "💵 Min price (PLN)", "minimum": 0, "type": "integer", "description": "Minimum price. For sale this is the asking price; for rent it is the monthly rent. Leave empty for no minimum." }, "maxPrice": { "title": "💵 Max price (PLN)", "minimum": 0, "type": "integer", "description": "Maximum price. Leave empty for no maximum." }, "minArea": { "title": "📐 Min area (m²)", "minimum": 0, "type": "integer", "description": "Minimum living area in square metres. Leave empty for no minimum." }, "maxArea": { "title": "📐 Max area (m²)", "minimum": 0, "type": "integer", "description": "Maximum living area in square metres. Leave empty for no maximum." }, "minRooms": { "title": "🚪 Min rooms", "minimum": 0, "maximum": 50, "type": "integer", "description": "Minimum number of rooms. Leave empty for any." }, "maxRooms": { "title": "🚪 Max rooms", "minimum": 0, "maximum": 50, "type": "integer", "description": "Maximum number of rooms. Leave empty for any." }, "minYearBuilt": { "title": "🏗 Min year built", "minimum": 1800, "maximum": 2100, "type": "integer", "description": "Earliest construction year. Leave empty for any." }, "maxYearBuilt": { "title": "🏗 Max year built", "minimum": 1800, "maximum": 2100, "type": "integer", "description": "Latest construction year. Leave empty for any." }, "daysSinceCreated": { "title": "🕒 Listed within (days)", "minimum": 0, "maximum": 50, "type": "integer", "description": "Only listings created within the last N days. Leave empty for all." }, "hasPhotos": { "title": "🖼 Only with photos", "type": "boolean", "description": "When ON, only return listings that have at least one photo.", "default": false }, "maxResults": { "title": "📊 Max results per query", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard cap on listings returned per query. Auto-paginates until the cap is reached or the search is fully drained. FREE tier is always capped at 25 listings per run.", "default": 72 }, "includeDetails": { "title": "📇 Include full detail + contacts (PAID)", "type": "boolean", "description": "When ON, fetches the full detail record for each listing (owner/agent name + phone, agency, build year, construction status, heating, ownership, coordinates). Adds a ListingEnriched charge per listing. Disabled on FREE tier.", "default": false } } }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Otodom Property Scraper — Poland Sale + Rent · PLN/m² Market from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: