# Otodom.pl Scraper (`solidcode/otodom-pl-scraper`) Actor \[💰 $0.95 / 1K] Extract real-estate listings from Otodom.pl. Get prices, area, rooms, addresses, photos, agent contacts, and full descriptions for apartments, houses, plots, and commercial properties — both for sale and for rent — across Poland. - **URL**: https://apify.com/solidcode/otodom-pl-scraper.md - **Developed by:** [SolidCode](https://apify.com/solidcode) (community) - **Categories:** Real estate, Automation, Developer tools - **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.95 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Otodom.pl Scraper Pull real-estate listings from Otodom.pl — Poland's largest property portal — at scale, with prices in PLN, GPS coordinates, full image galleries, and listing-agent phone numbers on every row. Cover all 32 major Polish cities plus an all-of-Poland sweep, across apartments, houses, studios, rooms, plots, garages, commercial premises, halls/warehouses, and new-build investments — for sale or for rent. Built for lead-generation agencies prospecting Polish real-estate agents, expat and international buyers researching Warszawa or Kraków apartment prices, and market analysts tracking price-per-m² trends without wrestling with Otodom's filter URLs or stitching paginated results by hand. ### Why This Scraper? - **Lead-generation ready** — every listing returns the seller's phone number in plaintext E.164 format (e.g. `+48573582897`), plus agency name and Otodom agency URL. Typical population rate is 90%+ across active sale and rent listings. - **9 property types in one actor** — Apartment (Mieszkanie), Studio (Kawalerka), House (Dom), Room (Pokój), Plot/Land (Działka), Commercial premises (Lokal użytkowy), Hall/Warehouse (Hala/magazyn), Garage (Garaż), and Investment (Inwestycja — new-build developments). Flip a single dropdown to switch. - **32 Polish cities covered out of the box** — from Warszawa, Kraków, Wrocław, Gdańsk, Poznań, and Łódź down to Płock, Elbląg, and Bytom, plus an all-of-Poland (`cała Polska`) sweep when you want everything in one run. - **GPS coordinates + voivodeship → district hierarchy on every detail page** — latitude, longitude, postal code, voivodeship, county, city, district, and street arrive map-ready, no separate geocoding step. - **Up to ~30 photos per listing pulled at full resolution** — straight from the source CDN at 1280×1024, not thumbnail crops. - **Multi-room selection** — pick exactly the room counts you want (e.g. 2 + 3 + 4) instead of an awkward "minimum 2 rooms" range filter. Six options including a "6 or more" bucket. - **Primary vs secondary market filter** — split new-build developer listings from resale stock with one dropdown, then sort by lowest price-per-m² to surface undervalued primary launches. - **PLN-native pricing throughout** — `price` and `pricePerSquareMeter` are computed and exposed as separate fields. No currency conversion guesswork; price-per-m² is ready to sort, filter, and chart. - **Build-year filtering with min/max** — bracket your search to e.g. 2010–2024 for newer construction, or 1900–1939 for pre-war Warszawa townhouses. Pairs naturally with apartments and houses. ### Use Cases **Lead Generation for Polish Real Estate** - Build call lists of listing agents and developers — name, mobile phone, agency, agency profile URL - Target by city, property type, and price band to focus outreach - Identify new-build developers (primary market) actively selling inventory - Pull every active rental agent in Warszawa, Kraków, or Wrocław for a single SMS or call campaign **Market Research & Price Analysis** - Track median and percentile price-per-m² across the 32 covered cities - Compare apartment pricing in Warszawa vs Kraków vs Wrocław over time - Map inventory levels by voivodeship, county, and district - Separate primary (new-build) from secondary (resale) market pricing to measure premium **Investment & Underwriting** - Sort by lowest price-per-m² to surface undervalued listings in a target district - Filter by build year (2010+) to focus on newer construction with lower capex - Pull rental yields by combining for-sale and for-rent runs on the same district - Identify investment developments (Inwestycja) for buy-to-let or off-plan strategies **Relocation & Expat Search** - Search Warszawa, Kraków, Gdańsk, or Wrocław by district and price band - Pre-filter by build year, room count, and area before reaching out - Compare rentals across multiple cities with one run for relocation decisions - Collect photos and full descriptions to shortlist before scheduling viewings **Listings Aggregation & Competitor Tracking** - Feed real-time Otodom inventory into a property portal or comparison site - Monitor competitors' developer projects (primary listings) launching new buildings - Track price changes by re-running and diffing against your last dataset - Power Polish-market dashboards with structured, deduplicated rows ### Getting Started #### Simple — All Apartments for Sale in Warszawa Just a city and a deal type: ```json { "location": "Warszawa", "dealType": "sale", "propertyType": "apartment", "maxResults": 100 } ```` #### Filtered — Two- and Three-Room Kraków Apartments, 300–800k PLN ```json { "location": "Kraków", "dealType": "sale", "propertyType": "apartment", "rooms": ["2", "3"], "priceMin": 300000, "priceMax": 800000, "maxResults": 500 } ``` #### Advanced — New-Build Wrocław Apartments Built Since 2018, Cheapest €/m² First ```json { "location": "Wrocław", "dealType": "sale", "propertyType": "apartment", "marketType": "primary", "buildYearMin": 2018, "buildYearMax": 2026, "areaMin": 40, "areaMax": 90, "sortBy": "price_lowest", "radius": "10", "maxResults": 1000 } ``` #### Power-User — Paste an Otodom Search URL Directly Skip the guided fields and use a pre-filtered Otodom search you already have open in your browser: ```json { "startUrls": [ "https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/mazowieckie/warszawa/warszawa/warszawa?priceMin=500000&priceMax=1200000&roomsNumber=%5B%22TWO%22%2C%22THREE%22%5D" ], "maxResults": 300 } ``` ### Input Reference #### Search Targeting | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `dealType` | select | `For Sale (Sprzedaż)` | Are you looking for properties to buy or to rent? Options: For Sale (Sprzedaż), For Rent (Wynajem). | | `propertyType` | select | `Apartment (Mieszkanie)` | Property category. Options: Apartment (Mieszkanie), Studio (Kawalerka), House (Dom), Room (Pokój) — rent only, Plot / Land (Działka), Commercial premises (Lokal użytkowy), Hall / Warehouse (Hala / magazyn), Garage (Garaż), Investment / New development (Inwestycja). | | `location` | string | `Warszawa` | Polish city, voivodeship, or "cała Polska" for the entire country. Polish characters accepted and recommended. | | `radius` | select | `Exact area only (0 km)` | Expand the search beyond the selected location. Options: 0, +5, +10, +15, +25, +50, +75 km. | | `startUrls` | URL\[] | `[]` | Power-user input. Paste Otodom search-result URLs or individual listing URLs. When provided, overrides the guided fields. | #### Filters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `priceMin` | integer | empty | Minimum price in Polish złoty (PLN). Leave empty for no minimum. | | `priceMax` | integer | empty | Maximum price in Polish złoty (PLN). Leave empty for no maximum. | | `areaMin` | integer | empty | Minimum floor area in square metres. | | `areaMax` | integer | empty | Maximum floor area in square metres. | | `rooms` | string\[] | `[]` | Multi-select room count. Options: 1 room, 2 rooms, 3 rooms, 4 rooms, 5 rooms, 6 or more. Ignored for plots, garages, and commercial. | | `buildYearMin` | integer | empty | Minimum build year (1800–2100). Most useful for apartments and houses. | | `buildYearMax` | integer | empty | Maximum build year (1800–2100). | | `marketType` | select | `Any market` | Primary (new build) vs Secondary (resale) vs Any market. Most useful on sale listings. | #### Sorting & Limits | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `sortBy` | select | `Default (recommended)` | Result order. Options: Default, Newest first, Oldest first, Lowest price first, Highest price first, Smallest area first, Largest area first. | | `maxResults` | integer | `100` | Maximum listings to collect across all searches and URLs. Set to 0 for no cap (internal safety limit of 100,000 applies). Results arrive in full pages of ~36, so the final page may overshoot by a few rows. | ### Output One flat row per Otodom listing. Here's a representative sale-side result for a new-build development in Kraków: ```json { "url": "https://www.otodom.pl/pl/oferta/mista-krakow-ID4zTk9", "id": 67659493, "title": "Mista Kraków", "dealType": "sale", "propertyType": "investment", "price": 489258, "pricePerSquareMeter": 15782, "currency": "PLN", "area": 31, "rooms": 1, "floor": 2, "totalFloors": 5, "buildYear": 2025, "location": { "voivodeship": "małopolskie", "county": "Kraków", "city": "Kraków", "district": "Mistrzejowice", "street": "ul. Mistrzejowicka", "postalCode": "31-641", "latitude": 50.099307, "longitude": 20.023872 }, "description": "1, 2, 3 i 4-pokojowe mieszkania od 31 m2 do 77 m2 od dewelopera Victoria Dom...", "images": [ "https://ireland.apollo.olxcdn.com/v1/files/eyJmbiI6Im.../image;s=1280x1024;q=80", "https://ireland.apollo.olxcdn.com/v1/files/eyJmbiI6Mj.../image;s=1280x1024;q=80" ], "features": [ "Miejsce parkingowe podziemne", "Balkon", "Windy", "Strefa wypoczynku", "Przyjazny dla osób niepełnosprawnych" ], "agent": { "name": "Biuro Sprzedaży", "phone": "+48573582897", "email": null, "agencyName": "Victoria Dom", "agencyUrl": "https://www.otodom.pl/pl/firmy/deweloperzy/victoria-dom-ID10556508" }, "marketType": "PRIMARY", "addedAt": "2026-01-30T11:23:15+01:00", "updatedAt": "2026-05-22T11:56:00+02:00", "scrapedAt": "2026-05-23T12:23:32.319635+00:00", "sourceListUrl": "https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/malopolskie/krakow/krakow/krakow" } ``` #### Core Identity | Field | Type | Description | |-------|------|-------------| | `url` | string | Direct Otodom listing URL | | `id` | number | Unique Otodom listing identifier | | `title` | string | Listing title as shown on Otodom | | `dealType` | string | `sale` or `rent` | | `propertyType` | string | `apartment`, `studio`, `house`, `room`, `plot`, `commercial`, `hall`, `garage`, or `investment` | | `marketType` | string | `PRIMARY` (new build), `SECONDARY` (resale), `ALL`, or `null` | #### Pricing | Field | Type | Description | |-------|------|-------------| | `price` | number | Listing price in PLN. For rentals this is the monthly rent. | | `pricePerSquareMeter` | number | Price per square metre in PLN — ready to sort, filter, and chart | | `currency` | string | Always `PLN` | #### Property Details | Field | Type | Description | |-------|------|-------------| | `area` | number | Floor area in square metres | | `rooms` | number | Number of rooms (1–10, with 6+ rolled into 6) | | `floor` | number / string | Floor number (0 = ground floor); special labels like `Garret`, `Cellar` are passed through as strings | | `totalFloors` | number | Total floors in the building | | `buildYear` | number | Year the building was constructed | | `features` | string\[] | Amenity and feature labels in Polish (e.g. parking, balcony, lift, storage room) | #### Location | Field | Type | Description | |-------|------|-------------| | `location.voivodeship` | string | Polish voivodeship (e.g. `mazowieckie`, `małopolskie`) | | `location.county` | string | County (powiat) name | | `location.city` | string | City name | | `location.district` | string | District / neighbourhood | | `location.street` | string | Street name with `ul.` prefix when present | | `location.postalCode` | string | Polish postal code (e.g. `31-641`) | | `location.latitude` | number | Latitude (WGS84) | | `location.longitude` | number | Longitude (WGS84) | #### Description & Media | Field | Type | Description | |-------|------|-------------| | `description` | string | Full plain-text description from the detail page (HTML stripped) | | `images` | string\[] | All listing photo URLs at 1280×1024 from the source CDN | #### Agent Contact | Field | Type | Description | |-------|------|-------------| | `agent.name` | string | Seller / agent name (or "Biuro Sprzedaży" for developer sales offices) | | `agent.phone` | string | Phone number in plaintext E.164 format (e.g. `+48573582897`) | | `agent.email` | string | Contact email when published — most listings expose phone only | | `agent.agencyName` | string | Agency or developer name | | `agent.agencyUrl` | string | Otodom profile page for the agency / developer | #### Metadata | Field | Type | Description | |-------|------|-------------| | `addedAt` | string | When the listing was first published on Otodom (ISO 8601) | | `updatedAt` | string | Last update on Otodom (ISO 8601) | | `scrapedAt` | string | When this row was collected (ISO 8601 UTC) | | `sourceListUrl` | string | The exact search URL this row came from — useful for traceability and debugging | ### Tips for Best Results - **Use Polish characters in `location`** — `Warszawa`, `Kraków`, `Gdańsk`, `Łódź`. The actor folds diacritics automatically, but native spellings match Otodom's own search dictionary most reliably. - **For sub-district precision, paste a Start URL** — Polish cities use a four-level voivodeship/county/city/district hierarchy. The actor resolves city names automatically; for a specific district (e.g. Warszawa-Mokotów), open the search in your browser and paste the URL into `startUrls`. - **Use `marketType: primary` to find new-build developments only** — these often appear in pre-sale and are harder to surface on aggregators. Pair with `propertyType: investment` to list entire development projects. - **Sort by `Lowest price first` plus a tight `priceMax` band** — surfaces the best price-per-m² listings in your filter set. Pair with `buildYearMin: 2015` to focus on recent stock. - **Room counts are ignored for plots, garages, commercial, and halls** — Otodom does not index them by room count, so leave `rooms` empty for those property types. - **Start with `maxResults: 50–100` to verify your filter combination** — once the result mix looks right, re-run with `maxResults: 0` (capped internally at 100,000) for the full sweep. - **`cała Polska` is the country-wide fallback** — leave `location` empty or set it to `cała Polska` to scan every Polish region in one run. Useful for nationwide developer or commercial inventory pulls. ### Pricing **$0.95 per 1,000 listings, pay-per-result.** You only pay for the rows we return — no compute charges, no per-minute billing. Below the typical $1.00/1,000 market rate for Polish real-estate data. | Listings | Cost | |----------|------| | 100 | $0.10 | | 1,000 | $0.95 | | 10,000 | $9.50 | | 100,000 | $95.00 | A "result" is any listing row in the output dataset. Platform fees (storage, data transfer) are additional and depend on your Apify plan. ### Integrations Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via: - **Zapier** / **Make** / **n8n** — Workflow automation - **Google Sheets** — Direct spreadsheet export - **Slack** / **Email** — Notifications on new results - **Webhooks** — Trigger custom APIs on run completion - **Apify API** — Full programmatic access ### Legal & Ethical Use This actor is designed for legitimate market research, lead generation, relocation research, and personal property search. Users are responsible for complying with applicable laws — including Polish and EU data protection rules (GDPR / RODO) — and with Otodom.pl's Terms of Service. Do not use extracted contact data for spam, unsolicited bulk messaging, or any unlawful purpose. Be mindful of consent and opt-out obligations when contacting individuals identified through this data. # Actor input Schema ## `dealType` (type: `string`): Are you looking for properties to buy or to rent? Ignored when Start URLs are provided (the URL controls deal type). ## `propertyType` (type: `string`): Filter by property category. Mirrors Otodom's own category navigation. Note: 'Room' is only valid with Deal Type = For Rent. If you pick Room + For Sale, the actor will automatically switch to For Rent and warn you (Otodom does not sell individual rooms). ## `location` (type: `string`): Where in Poland to search — a city name (e.g. 'Warszawa', 'Kraków', 'Gdańsk'), voivodeship, or 'cała Polska' for the entire country. Polish characters are accepted and recommended. ## `radius` (type: `string`): Expand the search this many kilometres beyond the selected location. Set 0 to limit results to the location boundary itself. Matches Otodom's UI options. ## `startUrls` (type: `array`): Power-user input. Paste Otodom search-result URLs (e.g. https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/warszawa) or individual listing URLs (e.g. https://www.otodom.pl/pl/oferta/...). When provided, these override the Deal Type / Property Type / Location / Filters settings above. ## `priceMin` (type: `integer`): Only include listings priced at or above this amount in Polish złoty. Leave empty for no minimum. ## `priceMax` (type: `integer`): Only include listings priced at or below this amount in Polish złoty. Leave empty for no maximum. ## `areaMin` (type: `integer`): Only include properties with floor area at or above this many square metres. ## `areaMax` (type: `integer`): Only include properties with floor area at or below this many square metres. ## `rooms` (type: `array`): Only include properties with these room counts. Select multiple to combine. Leave empty for no filter. Applies to apartments, houses, and rooms — ignored for plots, garages, and commercial. ## `buildYearMin` (type: `integer`): Only include properties built in or after this year. Leave empty for no minimum. Most useful for apartments and houses; ignored by Otodom for plots, garages, and commercial premises. ## `buildYearMax` (type: `integer`): Only include properties built in or before this year. Leave empty for no maximum. ## `marketType` (type: `string`): Primary market (developer / new build) vs secondary market (resale). Otodom uses this distinction prominently on sale listings. ## `sortBy` (type: `string`): How Otodom orders results before we collect them. ## `maxResults` (type: `integer`): Maximum number of listings to collect across all searches and URLs. Set to 0 for no cap (an internal safety limit of 100,000 is then applied). Results are collected in full pages of ~36 listings, so the final page may overshoot this number by a few rows. ## Actor input object example ```json { "dealType": "sale", "propertyType": "apartment", "location": "Warszawa", "radius": "0", "startUrls": [], "rooms": [], "marketType": "any", "sortBy": "default", "maxResults": 100 } ``` # Actor output Schema ## `overview` (type: `string`): Table of scraped listings with the key fields — title, price, area, rooms, city, and listing URL. ## `details` (type: `string`): Full per-listing fields including images, agency, agent contacts, market type, construction year, GPS coordinates, and timestamps. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "dealType": "sale", "propertyType": "apartment", "location": "Warszawa", "radius": "0", "startUrls": [], "rooms": [], "marketType": "any", "sortBy": "default", "maxResults": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("solidcode/otodom-pl-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "dealType": "sale", "propertyType": "apartment", "location": "Warszawa", "radius": "0", "startUrls": [], "rooms": [], "marketType": "any", "sortBy": "default", "maxResults": 100, } # Run the Actor and wait for it to finish run = client.actor("solidcode/otodom-pl-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "dealType": "sale", "propertyType": "apartment", "location": "Warszawa", "radius": "0", "startUrls": [], "rooms": [], "marketType": "any", "sortBy": "default", "maxResults": 100 }' | apify call solidcode/otodom-pl-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solidcode/otodom-pl-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Otodom.pl Scraper", "description": "[💰 $0.95 / 1K] Extract real-estate listings from Otodom.pl. Get prices, area, rooms, addresses, photos, agent contacts, and full descriptions for apartments, houses, plots, and commercial properties — both for sale and for rent — across Poland.", "version": "1.0", "x-build-id": "LncNxg8nczb0uoEBa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~otodom-pl-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-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/solidcode~otodom-pl-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-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/solidcode~otodom-pl-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-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", "properties": { "dealType": { "title": "Deal Type", "enum": [ "sale", "rent" ], "type": "string", "description": "Are you looking for properties to buy or to rent? Ignored when Start URLs are provided (the URL controls deal type).", "default": "sale" }, "propertyType": { "title": "Property Type", "enum": [ "apartment", "studio", "house", "room", "plot", "commercial", "hall", "garage", "investment" ], "type": "string", "description": "Filter by property category. Mirrors Otodom's own category navigation. Note: 'Room' is only valid with Deal Type = For Rent. If you pick Room + For Sale, the actor will automatically switch to For Rent and warn you (Otodom does not sell individual rooms).", "default": "apartment" }, "location": { "title": "Location", "type": "string", "description": "Where in Poland to search — a city name (e.g. 'Warszawa', 'Kraków', 'Gdańsk'), voivodeship, or 'cała Polska' for the entire country. Polish characters are accepted and recommended." }, "radius": { "title": "Search Radius", "enum": [ "0", "5", "10", "15", "25", "50", "75" ], "type": "string", "description": "Expand the search this many kilometres beyond the selected location. Set 0 to limit results to the location boundary itself. Matches Otodom's UI options.", "default": "0" }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Power-user input. Paste Otodom search-result URLs (e.g. https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/warszawa) or individual listing URLs (e.g. https://www.otodom.pl/pl/oferta/...). When provided, these override the Deal Type / Property Type / Location / Filters settings above.", "items": { "type": "string" } }, "priceMin": { "title": "Minimum Price (PLN)", "minimum": 0, "type": "integer", "description": "Only include listings priced at or above this amount in Polish złoty. Leave empty for no minimum." }, "priceMax": { "title": "Maximum Price (PLN)", "minimum": 0, "type": "integer", "description": "Only include listings priced at or below this amount in Polish złoty. Leave empty for no maximum." }, "areaMin": { "title": "Minimum Area (m²)", "minimum": 0, "type": "integer", "description": "Only include properties with floor area at or above this many square metres." }, "areaMax": { "title": "Maximum Area (m²)", "minimum": 0, "type": "integer", "description": "Only include properties with floor area at or below this many square metres." }, "rooms": { "title": "Number of Rooms", "uniqueItems": true, "type": "array", "description": "Only include properties with these room counts. Select multiple to combine. Leave empty for no filter. Applies to apartments, houses, and rooms — ignored for plots, garages, and commercial.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6+" ], "enumTitles": [ "1 room", "2 rooms", "3 rooms", "4 rooms", "5 rooms", "6 or more" ] }, "default": [] }, "buildYearMin": { "title": "Minimum Build Year", "minimum": 1800, "maximum": 2100, "type": "integer", "description": "Only include properties built in or after this year. Leave empty for no minimum. Most useful for apartments and houses; ignored by Otodom for plots, garages, and commercial premises." }, "buildYearMax": { "title": "Maximum Build Year", "minimum": 1800, "maximum": 2100, "type": "integer", "description": "Only include properties built in or before this year. Leave empty for no maximum." }, "marketType": { "title": "Market", "enum": [ "any", "primary", "secondary" ], "type": "string", "description": "Primary market (developer / new build) vs secondary market (resale). Otodom uses this distinction prominently on sale listings.", "default": "any" }, "sortBy": { "title": "Sort Order", "enum": [ "default", "date_newest", "date_oldest", "price_lowest", "price_highest", "area_smallest", "area_largest" ], "type": "string", "description": "How Otodom orders results before we collect them.", "default": "default" }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of listings to collect across all searches and URLs. Set to 0 for no cap (an internal safety limit of 100,000 is then applied). Results are collected in full pages of ~36 listings, so the final page may overshoot this number by a few rows.", "default": 100 } } }, "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 } } } } } } } } } } ```