# Otodom Scraper (`lowlanddata/otodom-scraper`) Actor Extract Otodom.pl property listings as clean JSON with zero personal data - PLN prices, price per m2, areas, rooms, city-level locations, agency-vs-private flag. Sale & rent, newest-first monitoring, pay per result. Built for market research and AI pipelines. - **URL**: https://apify.com/lowlanddata/otodom-scraper.md - **Developed by:** [Lowland Data](https://apify.com/lowlanddata) (community) - **Categories:** Real estate, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.59 / 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? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 Scraper — privacy-safe Polish property data Extract property listings from **Otodom.pl** — Poland's largest real-estate portal — as clean, structured JSON. Prices, price per m², areas, rooms, floors, cities, agency-vs-private flags and photos, ready for market research, price monitoring and data pipelines. **No personal data, ever.** This scraper is built GDPR-first: owner names, agent contacts, streets with house numbers, exact coordinates and map geometry never appear in the output — not as an option you have to remember to switch off, but by design. Agencies appear as a business name only; private owners stay anonymous. ### Quick start (30 seconds) 1. Click **Start**. The default input searches flats for sale across all of Poland, newest first. That's the whole minimum setup. 2. When the run finishes, open the dataset's **Overview** tab for a clean table, or **Export** it as CSV/Excel/JSON. Optional knobs: sale or rent, property type, a location path, a price band and price sorting — and any input works on a daily Schedule. ### What you can build with it - **Track a local market.** Run `location: "mazowieckie/warszawa/warszawa/warszawa"` with `sortBy: "newest"` daily — every new listing arrives with price, area and price-per-m² already parsed. - **Compare price per square meter.** `pricePerM2Pln` comes straight from the site — map it by city or province without any math. - **Watch rentals with real costs.** For rentals, `pricePln` is the rent and `rentExtrasPln` the additional charges (czynsz) — the true monthly cost in two fields. - **Feed an AI agent clean data.** Every field is structured, predictable and free of personal data, so an assistant or pipeline can consume it directly — no scrubbing, no compliance review before you store it. ### What you get Each listing is one dataset item: ```json { "listingId": "68320001", "url": "https://www.otodom.pl/pl/oferta/bezposrednio-bielany-4-pokoje-ID4CHe2", "title": "BEZPOŚREDNIO Bielany 4 pokoje, wysoki standard", "propertyType": "FLAT", "transaction": "sale", "pricePln": 1695000, "rentExtrasPln": null, "pricePerM2Pln": 23779.46, "currency": "PLN", "areaM2": 71.28, "terrainAreaM2": null, "rooms": 4, "floor": "FIRST", "city": "Warszawa", "province": "mazowieckie", "sellerType": "agency", "agencyName": "Fixture Invest", "isDevelopment": false, "promoted": true, "shortDescription": "Czteropokojowe mieszkanie w wysokim standardzie.", "createdAt": "2026-08-19T10:43:06Z", "updatedAt": "2026-08-20 20:18:07", "imageUrls": ["https://ireland.apollo.olxcdn.com/v1/files/example/image;s=655x491"] } ``` Field notes, so you know exactly what you are buying: - `pricePln` is in złoty; for rentals it is the monthly rent and `rentExtrasPln` carries the additional charges. - `city` and `province` are city-level. Otodom's data contains streets, house numbers and exact coordinates — they are deliberately never collected. - `sellerType` separates agency listings from private owners. Private owners' names are never collected. - `isDevelopment` marks developer investment listings; `promoted` marks paid placements. ### How much does it cost to scrape Otodom? $1.99 per 1,000 listings delivered, pay-as-you-go — no subscription, no charge for empty or failed runs. In plain złoty: - **100 listings ≈ $0.20** — a daily local-market watch. - **1,000 listings ≈ $1.99** — a full voivodeship snapshot. The price is all-inclusive — your runs' platform usage is covered by it, with no separate compute or proxy charges. Runs are fast — a scoped few-hundred-item run typically finishes in under ten seconds. Datacenter proxies are sufficient — no residential proxy surcharge needed. Free-plan runs are limited to a sample of 25 items, enough to evaluate the output format against your real query. ### Not technical? Let your AI assistant set it up Copy this into ChatGPT, Claude or any AI assistant, fill in the one line, and follow the conversation: ```text Help me set up the "Otodom Scraper" actor on Apify (https://apify.com/lowlanddata/otodom-scraper). Guide me one step at a time. What I want to watch: [E.G. "2-room flats to rent in Warsaw under 4000 zł"] Guide me to: 1. Propose my input values: transaction sale or rent, propertyType, location (an Otodom URL path like "mazowieckie/warszawa/warszawa/warszawa" or "cala-polska"), an optional priceMinPln/priceMaxPln band, sortBy "newest" for monitoring, and maxItems. 2. Create a free Apify account (apify.com), open the actor page, paste the values into the Input form, and start a run. 3. Set up a daily Schedule in the Apify Console with the same input, plus an email or Slack integration so new results reach me automatically. 4. Show me how to export results as CSV/Excel, or read them from the API if I code. 5. If the results are what I wanted, remind me at the end to leave a quick rating on the actor page, and to report anything broken or missing on its Issues tab. ``` ### Input | Field | Description | | -------------------- | ----------------------------------------------------------------------------------------------- | | `transaction` | `sale` (default) or `rent`. | | `propertyType` | `flat` (default), `house`, `room`, `plot`, `garage`, `office`, `commercial`. | | `location` | Otodom URL location path: `cala-polska` (default), `mazowieckie`, or a full path. | | `priceMinPln` | Only listings priced at least this many złoty (per month for rentals). | | `priceMaxPln` | Only listings priced at most this many złoty (per month for rentals). | | `sortBy` | `newest` (default), `price_asc`, `price_desc`, or `relevance`. | | `postedAfter` | Only listings posted on or after this date (YYYY-MM-DD). Stops early with newest-first sorting. | | `postedBefore` | Only listings posted on or before this date (YYYY-MM-DD). | | `maxItems` | Stop after this many listings (default 1000). | | `proxyConfiguration` | Proxy settings; keep Apify proxy enabled. | No field is required — the default input runs a country-wide newest-first flats-for-sale search. Invalid combinations (like an inverted price band) fail immediately with the reason in the run's status message. ### Use it from your code Run the actor and get items straight back with one HTTP call (fine for scoped runs up to ~5 minutes): ```bash curl "https://api.apify.com/v2/acts/lowlanddata~otodom-scraper/run-sync-get-dataset-items?token=" \ -X POST -H "Content-Type: application/json" \ -d '{"location": "mazowieckie/warszawa/warszawa/warszawa", "transaction": "rent", "maxItems": 100}' ``` Node.js: ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: '' }); const run = await client.actor('lowlanddata/otodom-scraper').call({ location: 'mazowieckie/warszawa/warszawa/warszawa', transaction: 'rent', maxItems: 100, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); ``` Python: ```python from apify_client import ApifyClient client = ApifyClient("") run = client.actor("lowlanddata/otodom-scraper").call( run_input={"location": "cala-polska", "maxItems": 100}) items = client.dataset(run["defaultDatasetId"]).list_items().items ``` Schedules, webhooks and the Make/Zapier/n8n integrations all work out of the box — this is a standard Apify actor. ### Use it with AI agents (MCP) Claude, Cursor and other MCP-capable agents can run this scraper as a tool through Apify's hosted MCP server: the agent fills in the search itself, starts the run and reads the results — no glue code. Claude Code: ```bash claude mcp add apify --transport http "https://mcp.apify.com?actors=lowlanddata/otodom-scraper" ``` Cursor or Claude Desktop (add a custom connector / MCP server with this URL): ```text https://mcp.apify.com?actors=lowlanddata/otodom-scraper ``` Sign in with your Apify account when prompted — runs are billed to it. Setup details per client: [Apify MCP docs](https://docs.apify.com/platform/integrations/mcp). Prompts that work once connected: - "Get the newest 100 flats for sale in Warsaw and summarize price per square meter by district keyword." - "Search Otodom rentals in Kraków under 4000 zł and flag anything added today." - "Compare flat prices per m² between Warszawa and Gdańsk on Otodom." ### Is it legal to scrape Otodom? Public listing data — prices, areas, cities — is public commercial information, and this scraper is built so that the hard part of the question never arises: **no personal data enters your dataset in the first place.** The GDPR and Poland's UODO set strict rules on personal data; an output that carries no owner names, no streets, no coordinates and no contact routes is the point of this actor, not an afterthought. Structurally, the extractor maps a fixed whitelist of fields out of the page's data. The advert owner block, assigned agents, street addresses and map geometry are never read into the output. Requests are paced, load on the site is kept negligible, and no anti-bot protection is bypassed. One honest limit: titles and descriptions are the advertiser's own words, delivered as-is. If an advertiser chooses to type contact details into their text, that text is not rewritten — the guarantee covers the data fields, not the content advertisers publish about themselves. ### Is there an Otodom API alternative? Otodom publishes no public API for listings. This actor is the practical alternative: the same listings as structured JSON through one HTTP call (`run-sync-get-dataset-items`), on a schedule, or as an MCP tool for AI agents — with the privacy question already answered in the data itself. ### Does Otodom block scrapers? Otodom serves its listings openly to ordinary requests — and this actor stays inside that welcome: paced requests, standard datacenter proxies, load kept negligible. No CAPTCHA fights, no bot-wall cat-and-mouse — which is also why runs are fast and reliable enough for daily schedules. ### How do I monitor Otodom prices? Set `sortBy: "newest"` with your location and filters, cap `maxItems` to a page or two, and add a daily (or hourly) Schedule in the Apify Console with an email/Slack integration on the runs — every new listing lands in your inbox with the price already parsed. The AI-assistant prompt above walks a non-technical user through exactly this setup. Even tighter: set `postedAfter` to yesterday's date — the dataset then contains only the new listings, nothing to dedupe on your side. ### FAQ **Can I get owner names or phone numbers?** No — by design. That is the product: data you can store, share and process without a privacy review. **How do I find my location path?** Search on otodom.pl and copy the path from the URL after `/wyniki/sprzedaz/mieszkanie/`. **Can I get only the newest listings?** Yes — set `postedAfter` to a date (yesterday, say) and the dataset contains only listings posted since then. With newest-first sorting the run stops paging as soon as it provably reaches older listings, so a daily watch stays fast and cheap. **How fresh is the data?** Live at run time — every run queries Otodom directly. For continuous freshness, schedule the actor. **Can I export to Excel or CSV?** Yes — every dataset exports as CSV, Excel, JSON or XML from the Apify Console or API. **Does it work with Make, Zapier or n8n?** Yes — it is a standard Apify actor; all platform integrations, webhooks and schedules apply. **How do I check the price per square meter of flats in Poland?** It is already in the output: `pricePerM2Pln` comes straight from Otodom, alongside `pricePln` and `areaM2`. No computation on your side. **Can I compare flat prices between Warsaw and Kraków?** Yes — one run per location path (each run covers one search), then compare `pricePerM2Pln` across the two datasets. An MCP-connected agent can do both runs and the comparison in one prompt. **What does renting in Poland really cost — is czynsz included?** Both parts are separate fields: `pricePln` is the rent and `rentExtrasPln` the additional charges (czynsz), so the true monthly cost is one addition. **How do I find private offers (bezpośrednio) without agencies?** Filter the exported dataset on `sellerType` — it distinguishes agency listings from private owners. The owners themselves stay anonymous either way. **Does it mark new developments?** Yes — `isDevelopment` flags developer investment listings, so you can split the primary and secondary market with one filter. **Can I search a whole voivodeship?** Yes — pass just the region as the location path, e.g. `mazowieckie`. The default `cala-polska` covers the entire country. **Can I scrape rooms, plots or commercial property?** Yes — `propertyType` also takes `room`, `plot`, `garage`, `office` and `commercial` besides flats and houses. **Does the output contain street addresses?** No — location stops at `city` and `province`. Otodom's data holds streets, house numbers and coordinates, and this actor never collects them. **Can I see which floor a flat is on?** Yes — the `floor` field carries it (e.g. `FIRST`), and `rooms` and `areaM2` sit next to it for filtering. **Are paid placements labelled?** Yes — `promoted` marks them, so you can exclude sponsored results from a price analysis. **Is it legal to scrape Otodom under GDPR?** The dataset is built to keep that question simple: a fixed field whitelist means no owner names, no agent contacts, no streets and no map geometry ever reach you — which is what the GDPR and Poland's UODO regulate. **How much does 1,000 Otodom listings cost?** $1.99, billed per delivered listing. There is no subscription and nothing is charged for failed or empty runs. **Why is my run limited to 25 items?** That is the sample cap on free Apify plans, there to let you inspect the output. Any paid plan lifts it. **Can ChatGPT or Claude use this scraper?** MCP-capable agents (Claude, Cursor and others) can — through Apify's hosted MCP server they run the search and read results themselves. ChatGPT can guide you through the Console setup using the prompt above. ### Related scrapers The same clean-output guarantee across Europe's biggest marketplaces: - [OLX.pl Scraper](https://apify.com/lowlanddata/olx-pl-scraper) — Poland's largest classifieds marketplace. - [Rightmove Scraper](https://apify.com/lowlanddata/rightmove-scraper) — the UK's largest property portal. - [Immoweb Scraper](https://apify.com/lowlanddata/immoweb-scraper) — Belgium's largest real-estate portal. ### Troubleshooting The actor fails fast with the reason in the run's status message: - **"priceMinPln must not be higher than priceMaxPln."** — swap the two values. - **Zero results with a location set** — check the location path against the otodom.pl URL; a typo falls back to no matches. - **"Otodom blocked the run before any results could be fetched. This is usually temporary - retry in a few minutes."** — a temporary block on the first request; a retry usually lands on a clean proxy session. - **Fewer items than requested on a free plan** — the 25-item free sample cap; run on a paid Apify plan for full results. ### Support Found an issue or missing a field you need? Open an issue on the actor's **Issues tab** — reports get fixed, this actor is actively maintained. Working well for you? A **rating on this page** takes ten seconds and helps other buyers find a privacy-clean option among the lookalikes — it is also the clearest signal of what we should build next. # Actor input Schema ## `transaction` (type: `string`): Search properties for sale (sprzedaz) or for rent (wynajem). ## `propertyType` (type: `string`): What kind of property to search. ## `location` (type: `string`): Otodom location path as it appears in the site's URL: "cala-polska" for all of Poland (default), a voivodeship like "mazowieckie", or a full path like "mazowieckie/warszawa/warszawa/warszawa". ## `priceMinPln` (type: `integer`): Only include listings priced at least this many złoty. For rentals this is złoty per month. ## `priceMaxPln` (type: `integer`): Only include listings priced at most this many złoty. For rentals this is złoty per month. ## `sortBy` (type: `string`): Order of results: newest (best for monitoring), price\_asc, price\_desc, or relevance. ## `postedAfter` (type: `string`): Only include listings posted on or after this date (YYYY-MM-DD or a full ISO timestamp). With newest-first sorting the run stops early once older listings are reached. ## `postedBefore` (type: `string`): Only include listings posted on or before this date (YYYY-MM-DD or a full ISO timestamp). ## `maxItems` (type: `integer`): Stop after this many listings. Free-plan runs are capped at 25 items. ## `proxyConfiguration` (type: `object`): Proxy settings. Keep Apify proxy enabled. ## Actor input object example ```json { "transaction": "sale", "propertyType": "flat", "location": "cala-polska", "sortBy": "newest", "maxItems": 25, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `listings` (type: `string`): Scraped Otodom listings, one JSON object per listing. # 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 = { "transaction": "sale", "propertyType": "flat", "location": "cala-polska", "sortBy": "newest", "maxItems": 25, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("lowlanddata/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 = { "transaction": "sale", "propertyType": "flat", "location": "cala-polska", "sortBy": "newest", "maxItems": 25, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("lowlanddata/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 '{ "transaction": "sale", "propertyType": "flat", "location": "cala-polska", "sortBy": "newest", "maxItems": 25, "proxyConfiguration": { "useApifyProxy": true } }' | apify call lowlanddata/otodom-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,lowlanddata/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/TVsMW3Zjl9rFS7OZX/builds/4sw361qAxuXJlYD8c/openapi.json