# Otodom Scraper: Poland Property Listings & Price Monitor (`redomic/otodom-scraper`) Actor Scrape Otodom.pl property listings in Poland. Returns price, area, rooms, location, advertiser and URLs from any search. Monitor mode tracks new and price-changed listings. - **URL**: https://apify.com/redomic/otodom-scraper.md - **Developed by:** [Redomic](https://apify.com/redomic) (community) - **Categories:** Real estate, Lead generation - **Features:** Limited permissions - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.96 / 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. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## Otodom Scraper: Polish Property Listings and Price Monitor Export flats, houses and plots for sale or rent from Otodom.pl, Poland's biggest property portal, to a spreadsheet or an API. Each row gives you the price in PLN, price per m², area, rooms, floor, build year, city and district, the market (new or resale), the agency or private owner, and the photos. Run it on a schedule and you get only the new listings and price changes since the last run. ### Who uses it - **Investors and agents** pricing flats by district, size and build year. - **Developers** watching what new-build competitors ask per m². - **Analysts and proptech products** that need fresh Polish listing data every day. ### What you get Flats for sale across Poland, from the default input on 15 November 2026: | Listing | Price (PLN) | PLN per m² | Area (m²) | Rooms | Built | City | District | Market | |---|---|---|---|---|---|---|---|---| | 2 pokoje, 41,4 m², Muranów, ul. Niska | 775,000 | 18,720 | 41.4 | 2 | 1956 | Warszawa | Wola | resale | | Wygodne 2 pokoje z ogródkiem | 754,560 | 19,200 | 39.3 | 2 | 2026 | Warszawa | Włochy | new | | Komfortowe mieszkanie 2-pokojowe | 580,000 | 15,960 | 36.34 | 2 | 2020 | Gdańsk | Orunia Górna | resale | | Apartament premium w kamienicy z windą | 1,069,000 | 18,630 | 57.38 | 2 | 2024 | Wrocław | Stare Miasto | resale | | 4 niezależne pokoje, Stare Miasto | 1,231,000 | 21,982 | 56 | 4 | 1968 | Kraków | Stare Miasto | resale | Each row also carries the floor and the building's total floors, monthly charges (czynsz), heating, building type and material, ownership type, elevator, energy certificate, available-from date, the street, GPS coordinates, the agency name, the listing and update dates, the description and the photos. ### Two modes | Mode | What you get | Good for | |---|---|---| | `search` (default) | Every listing that matches your filters | Price surveys, exports | | `monitor` | Only listings that are new, changed price or disappeared since the last run | Alerts, tracking a district or an agency | Set `agencyPortfolio: true` to get one row per agency or developer instead: how many listings they have, their median price per m², and the listing links. ### Price $1.20 per 1,000 listings. There's no start fee. In monitor mode you pay only for new and changed listings, so a quiet day costs nothing. 100 listings cost $0.12. ### How to run it Two- and three-room flats for sale in Warsaw's Mokotów and Wola, under 900,000 PLN: ```json { "location": "mazowieckie/warszawa/warszawa", "districts": ["mokotow", "wola"], "dealType": "sale", "propertyType": "flat", "roomsMin": 2, "roomsMax": 3, "priceMax": 900000, "maxItems": 200 } ``` You can also paste any search URL from otodom.pl into `startUrls` and keep the filters you set on the site. Flats within 3 km of a point, for a hyperlocal alert: ```json { "location": "mazowieckie/warszawa/warszawa", "lat": 52.2297, "lng": 21.0122, "radiusKm": 3, "maxItems": 200 } ``` For a daily alert, save a search as a task with `"mode": "monitor"` and schedule it. The first run records what's listed today. After that you get only `new` listings, `changed` prices and `removed` ads. Add `droppedOnly: true` to get price drops only. ### Input | Field | Default | What it does | |---|---|---| | `startUrls` | all flats for sale in Poland | Otodom search URLs. | | `location` | `cala-polska` | The location part of an Otodom URL, for example `malopolskie/krakow/krakow`. | | `districts` | none | District names or slugs within the location. | | `dealType` | `sale` | `sale` or `rent`. | | `propertyType` | `flat` | `flat`, `house`, `room`, `plot`, `commercial`, `garage` or `hall`. | | `market` | both | `PRIMARY` (new build) or `SECONDARY` (resale). | | `advertiserType` | `all` | `private`, `agency` or `developer`. | | `priceMin`, `priceMax` | none | Total price in PLN. | | `pricePerM2Min`, `pricePerM2Max` | none | Price per m² in PLN. | | `areaMin`, `areaMax` | none | Area in m². | | `roomsMin`, `roomsMax` | none | Number of rooms. | | `floorMin`, `floorMax` | none | Floor number (-1 cellar/basement, 0 ground floor). Non-numeric floors are excluded. | | `buildYearMin`, `buildYearMax` | none | Construction year. Listings without a known build year are excluded when set. | | `postedWithinDays` | none | Listings posted or updated in the last 1, 3, 7, 14 or 30 days. | | `sortBy` | Otodom's order | `newest`, `oldest`, `price_asc`, `price_desc`, `area_asc` or `area_desc`. Decides which listings you get when you cap `maxItems`. | | `lat`, `lng`, `radiusKm` | none | Keep listings within this distance of a point. Each row gets `distanceKm`. | | `fetchDetails` | `true` | Open each listing for GPS, build year, floors, monthly charges and building details. Turn it off for faster, lighter rows. | | `includeNoPrice` | `false` | Also return listings without a price. | | `mode` | `search` | `search` or `monitor`. | | `droppedOnly` | `false` | In monitor mode, return only price drops. | | `agencyPortfolio` | `false` | One row per agency or developer. | | `maxItems` | `24` | The most listings to return. | ### Output fields `id`, `url`, `title`, `dealType`, `propertyType`, `market`, `priceAmount`, `priceCurrency`, `pricePerM2`, `areaM2`, `rooms`, `floor`, `totalFloors`, `buildYear`, `monthlyCharges`, `heating`, `buildingType`, `buildingMaterial`, `windowsType`, `ownership`, `constructionStatus`, `elevator`, `energyCertificate`, `availableFrom`, `features`, `region`, `city`, `district`, `street`, `lat`, `lng`, `advertiserType`, `agencyName`, `createdAt`, `modifiedAt`, `description`, `photos`, `imagesCount`, `scrapedAt`. Monitor rows add `changeType`, the previous price and the price difference. ### FAQ **Do I get phone numbers or email addresses?** No. The Actor never collects contact details, and it removes phone numbers and emails from descriptions. **Why are some fields empty?** GPS, build year, floors, monthly charges, elevator, energy certificate and available-from date come from each listing's own page, and only when the advertiser fills them in. Set `fetchDetails: false` if you only need the search-card fields. **Why don't I see new-build project pages?** Otodom mixes development project cards into its results. They aren't individual listings, so the Actor leaves them out. **Is there an Otodom API?** Not a public one for listings. This Actor reads Otodom's public pages without logging in. **Something looks wrong in my results.** Open an issue on the Issues tab with your input and we'll look at it. ### Po polsku Eksportuj ogłoszenia z Otodom.pl do arkusza: cena, cena za m², metraż, pokoje, piętro, rok budowy, miasto, dzielnica, rynek pierwotny lub wtórny i ogłoszeniodawca. W trybie `monitor` dostajesz tylko nowe ogłoszenia, zmiany cen i usunięte oferty od ostatniego uruchomienia. ### Use it from AI agents (MCP) and Python **AI agents.** Add this Actor as a tool in Claude, Cursor, VS Code or any MCP client through the Apify MCP server. The agent reads the input schema, so a plain request is enough. ```json { "mcpServers": { "otodom-scraper": { "url": "https://mcp.apify.com?tools=redomic/otodom-scraper", "headers": { "Authorization": "Bearer " } } } } ``` **Python.** `pip install apify-client`, then: ```python from apify_client import ApifyClient client = ApifyClient("") run = client.actor("redomic/otodom-scraper").call(run_input={"location": "cala-polska", "dealType": "sale", "propertyType": "flat"}) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) ``` ### More from us - [Allabolag Scraper - Swedish Company Data](https://apify.com/redomic/allabolag-company-scraper): Scrape allabolag.se for Swedish company financials, industry, status and board role titles by search, org number or URL - [Ashby Jobs Scraper with Salaries](https://apify.com/redomic/ashby-jobs-monitor): Ashby jobs scraper for any startup careers board (OpenAI, Ramp, Notion and thousands more), with salary ranges as numbers: min, max, currency, period, plus equity and bonus flags - [ATS Jobs Search: Greenhouse, Lever & Ashby Jobs API](https://apify.com/redomic/ats-jobs-search): Search 300,000+ open jobs from 11,000+ companies on Greenhouse, Lever and Ashby in one run - [Blocket Scraper: Car Monitor](https://apify.com/redomic/blocket-se-scraper): Blocket scraper: each run returns up to 2,500 Blocket Bil and Torget listings as flat rows with price, make, model, year, mileage, VIN, inspections and seller - [Closed Jobs Tracker: Filled Roles & Time-to-Fill](https://apify.com/redomic/closed-jobs-tracker): Search closed jobs from 11,000+ companies with closedOn, daysOpen and time-to-fill signals - [Google Jobs Scraper - Job Postings API](https://apify.com/redomic/google-jobs): Google Jobs and job postings scraper: get job title, company, location, posted date, salary, full description and every apply link for any search - [Google Trends API: Trending Now & Interest Over Time](https://apify.com/redomic/google-trends): Trending-now searches and new-trends alerts/monitoring per country with the news behind them, plus interest over time, interest by region, and related and rising queries for any keyword - [GovDeals Scraper](https://apify.com/redomic/govdeals-scraper): Search and monitor GovDeals government surplus auctions - [Greenhouse Jobs Monitor & Scraper](https://apify.com/redomic/greenhouse-jobs-monitor): Monitor Greenhouse jobs from any company careers board (Airbnb, Stripe, Discord and thousands more) - [Job Postings Dataset: 320k+ Open Jobs, Updated Daily](https://apify.com/redomic/job-postings-dataset): 320,000+ open jobs from 10,000+ company career sites (Greenhouse, Lever, Ashby), updated daily with first-seen and closed dates - [Lever Jobs Scraper with Salaries](https://apify.com/redomic/lever-jobs-monitor): Lever jobs scraper for any company's careers page (Palantir, Spotify, Zoox, Shield AI and thousands more): flat rows with title, team, location, workplace, commitment, apply link, salary as numbers and the full description merged - [Marktplaats.nl Scraper](https://apify.com/redomic/marktplaats-nl): Scrape Marktplaats.nl listings into clean rows: title, price in EUR, condition, seller, location, images - [Otomoto.pl Scraper](https://apify.com/redomic/otomoto-scraper): Scrape Otomoto.pl Polish car listings: one run returns used-car rows with price, make, model, year, mileage, fuel, gearbox, seller and URL - [Personio Jobs Scraper](https://apify.com/redomic/personio-jobs): Scrape open jobs from Personio company career pages (jobs.personio.de/.com XML feeds) - [Salary Data API: Pay Ranges by Job Title & Level](https://apify.com/redomic/salary-data): Get salary benchmarks (p10-p90, annualised, with n) and pay ranges from 150,000+ employer-posted jobs across 11,000+ companies, updated daily - [SIRET Company Scraper](https://apify.com/redomic/siret-company-scraper): Search French companies by name, SIREN or SIRET - [SUUMO Scraper - Japan Property Listings](https://apify.com/redomic/suumo-scraper): Scrape SUUMO Japan property listings from search URLs for rentals and sales - [Talabat Scraper — Menus, Prices & Delivery Fees](https://apify.com/redomic/talabat-scraper): Talabat menus, prices and delivery fees as flat rows in 8 MENA markets - [Workday Jobs Scraper](https://apify.com/redomic/workday-jobs): Search and monitor public Workday (myworkdayjobs.com) job postings # Changelog This Actor's version history is a separate document: https://apify.com/redomic/otodom-scraper/changelog.md # Actor input Schema ## `startUrls` (type: `array`): Otodom.pl search result URLs to scrape (e.g. https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/warszawa/warszawa/warszawa). If provided, structured filters below are ignored for URL building. ## `location` (type: `string`): Location path segment for Otodom search when not using startUrls (e.g. 'cala-polska', 'mazowieckie/warszawa/warszawa', 'malopolskie/krakow/krakow'). ## `districts` (type: `array`): District slugs or names to search within the location (e.g. \["mokotow", "wola"]). Each district is searched as a separate Otodom path sharing a single maxItems budget with deduplication. ## `dealType` (type: `string`): Sale or rent. ## `propertyType` (type: `string`): Type of property to search. ## `priceMin` (type: `integer`): Minimum total price in PLN. ## `priceMax` (type: `integer`): Maximum total price in PLN. ## `pricePerM2Min` (type: `integer`): Minimum price per square meter in PLN. ## `pricePerM2Max` (type: `integer`): Maximum price per square meter in PLN. ## `areaMin` (type: `integer`): Minimum area in square meters. ## `areaMax` (type: `integer`): Maximum area in square meters. ## `roomsMin` (type: `integer`): Minimum number of rooms. ## `roomsMax` (type: `integer`): Maximum number of rooms. ## `floorMin` (type: `integer`): Minimum floor number (-1 for cellar/basement, 0 for ground floor). ## `floorMax` (type: `integer`): Maximum floor number (-1 for cellar/basement, 0 for ground floor). ## `buildYearMin` (type: `integer`): Minimum construction year. ## `buildYearMax` (type: `integer`): Maximum construction year. ## `market` (type: `string`): Primary (new) or secondary (resale) market. Leave empty for all. ## `postedWithinDays` (type: `integer`): Keep only listings posted or modified in the last N days. Accepted values: 1, 3, 7, 14, 30. Leave empty for no time filter. ## `sortBy` (type: `string`): Order of search results. With a low maxItems, this decides which listings you get. 'default' keeps Otodom's order. ## `mode` (type: `string`): search returns matching listings; monitor reports only new, changed and removed listings since the last run (state kept per source URL). ## `droppedOnly` (type: `boolean`): In monitor mode, return only listings whose price dropped since the previous run. State and summary counts still track all changes. ## `maxItems` (type: `integer`): Maximum listing rows to return across all sources. ## `lat` (type: `number`): Centre latitude for radius search. Together with lng, rows get distanceKm; with radiusKm only rows within the radius are returned. ## `lng` (type: `number`): Centre longitude for radius search. Together with lat, rows get distanceKm; with radiusKm only rows within the radius are returned. ## `radiusKm` (type: `number`): Keep only rows within this many kilometres of lat/lng. Requires GPS (fetchDetails true); rows without coordinates are excluded. Every returned row includes distanceKm. ## `includeNoPrice` (type: `boolean`): By default listings with no published price are dropped. Set true to also return them with priceAmount null. ## `fetchDetails` (type: `boolean`): Open each listing's offer page to add GPS coordinates, build year, total floors, monthly charges (czynsz), heating, building details, amenities, photo gallery and description. On by default for richer data (datacenter requests only; slower and may use more proxy traffic). Set to false for faster search-card-only runs. Contact details are never included. ## `proxy` (type: `object`): Proxy settings (used if the Actor is configured for proxied requests). ## `agencyPortfolio` (type: `boolean`): Group results by agency/developer with counts, median price per m², and listing URLs. In monitor mode, only groups with new or removed stock are reported between unchanged runs. ## `advertiserType` (type: `string`): Filter by who posted the listing. Leave as 'all' to include private owners, agencies and developers. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/cala-polska" } ], "location": "cala-polska", "dealType": "sale", "propertyType": "flat", "market": "", "sortBy": "default", "mode": "search", "droppedOnly": false, "maxItems": 24, "includeNoPrice": false, "fetchDetails": true, "proxy": { "useApifyProxy": true }, "agencyPortfolio": false, "advertiserType": "all" } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = { "startUrls": [ { "url": "https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/cala-polska" } ], "location": "cala-polska", "maxItems": 24 }; // Run the Actor and wait for it to finish const run = await client.actor("redomic/otodom-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 = { "startUrls": [{ "url": "https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/cala-polska" }], "location": "cala-polska", "maxItems": 24, } # Run the Actor and wait for it to finish run = client.actor("redomic/otodom-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/cala-polska" } ], "location": "cala-polska", "maxItems": 24 }' | apify call redomic/otodom-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,redomic/otodom-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/HEgVQduv6ZlTPDvQj/builds/aRJJ6kB1bzAecVgbt/openapi.json