# Otodom Scraper (Cheap) (`data_api/otodom-scraper-cheap`) Actor Otodom property scraper that extracts detailed real estate listings, prices, and high-resolution images, giving you structured market data without the hassle of manual copying. - **URL**: https://apify.com/data\_api/otodom-scraper-cheap.md - **Developed by:** [Data API](https://apify.com/data_api) (community) - **Categories:** Real estate, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.99 / 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/platform/actors/running/actors-in-store#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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Property Scraper ![Otodom Property Scraper](cover.jpg) Watching the Polish housing market usually means clicking through otodom.pl and copying details off one advert at a time: price, area, location, agency. This scraper does it for you. Paste an otodom.pl search URL and every listing comes back as a clean row, with the price, size, location, and photos already split into fields and ready for a spreadsheet or a model. It is fast, cheap, and code-free, and you only pay for what you scrape. ### What you get Each listing comes back as one row with three kinds of data: - **Identity and link** — `listingId`, `listingTitle`, `listingUrl`, `propertyKind`, `dealType` - **Price and size** — `priceValue`, `currencyCode`, `pricePerSqm`, `areaSqm`, `roomCount`, `floorLevel` - **Detail and context** — `publishedAt`, `summary`, `locationDetails`, `imageLinks`, `agencyTitle`, `featureTags` ### Quick start 1. Open otodom.pl, set your filters (city, price, rooms), and copy the URL from the address bar. 2. Hit **Try for free** and paste that URL into **Search URLs**. 3. Set a **Results limit** to control how many listings you pull per URL. 4. Press **Start**, then export the results as JSON, CSV, Excel, or XML. ![How it works](how-it-works.jpg) ### Use cases - **Price tracking** — follow asking prices and price per m² across Warsaw, Krakow, or Gdansk - **Investment sourcing** — gather for-sale or rental stock to score against your buy criteria - **Agency monitoring** — see which agencies list what, where, and at what price - **Market dashboards** — feed live otodom.pl data into your own sheet, BI tool, or app - **Dataset building** — collect photos and descriptions for valuation or research models ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `searchUrls` | array of objects | Yes | otodom.pl search URLs to scrape; each one runs with full pagination. Prefilled with a Warsaw for-sale search. | | `resultsLimit` | integer | No | How many listings to pull per search URL. Default `50`. | | `timeoutSeconds` | integer | No | Seconds to wait on each request before it times out. Default `45`. | #### Example input ```json { "searchUrls": [ { "url": "https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/mazowieckie/warszawa/warszawa/warszawa?limit=36" } ], "resultsLimit": 50, "timeoutSeconds": 45 } ```` ### Output Every listing on the search results becomes one row, paginated automatically up to your limit. Fields that otodom.pl does not publish for a given advert come back absent rather than guessed. #### Example output ```json { "listingId": 55325476, "listingTitle": "MIESZKANIE Z WIDOKIEM NA PARK KASPROWICZA", "listingUrl": "https://www.otodom.pl/pl/oferta/mieszkanie-z-widokiem-na-park-kasprowicza-ID3K8Go", "propertyKind": "FLAT", "dealType": "RENT", "priceValue": 3600, "currencyCode": "PLN", "pricePerSqm": 37, "areaSqm": 96.12, "roomCount": "THREE", "floorLevel": "FOURTH", "publishedAt": "2026-05-29 10:41:13", "summary": "Oferuję do wynajęcia przestronne mieszkanie o powierzchni 96,12 m². Znajduje się na 4. piętrze w kamienicy z cegły, w bardzo dobrym stanie.", "locationDetails": { "address": { "street": { "name": "ul. Juliusza Słowackiego", "number": "" }, "city": { "name": "Szczecin" }, "province": { "name": "zachodniopomorskie" } } }, "imageLinks": [ "https://ireland.apollo.olxcdn.com/v1/files/example-1/image;s=1280x1024;q=80", "https://ireland.apollo.olxcdn.com/v1/files/example-2/image;s=1280x1024;q=80" ], "agencyTitle": null, "featureTags": [ "AIR_CONDITIONING", "TOP_FLOOR", "SECURE_BUILDING" ] } ``` #### Output fields | Field | Type | Description | |-------|------|-------------| | `listingId` | integer | Otodom identifier for the advert | | `listingTitle` | string | Headline the advertiser gave the listing | | `listingUrl` | string | Direct link to the advert on otodom.pl | | `propertyKind` | string | Category of real estate, e.g. FLAT or HOUSE | | `dealType` | string | RENT or SELL | | `priceValue` | number | Full asking price as a number | | `currencyCode` | string | Currency the price is quoted in, usually PLN | | `pricePerSqm` | number | Worked-out price per square metre | | `areaSqm` | number | Floor area in square metres | | `roomCount` | string | How many rooms the property has | | `floorLevel` | string | Which floor the property sits on | | `publishedAt` | string | Date and time the advert went live | | `summary` | string | Short blurb describing the property | | `locationDetails` | object | Nested location data: city, province, street | | `imageLinks` | array | URLs of the listing photos | | `agencyTitle` | string | Name of the estate agency, when there is one | | `featureTags` | array | Amenity and feature labels on the listing | ### Tips for best results - **Filter on otodom.pl first.** The tighter your search URL (city, price band, property type), the cleaner your dataset. - **Use `resultsLimit` for test runs.** Start with 50 to confirm the output fits your pipeline, then raise it for the full pull. - **Both rent and sale work.** A sprzedaz URL returns for-sale stock and a wynajem URL returns rentals; `dealType` tells them apart. - **Some fields are sparse.** Private sellers leave `agencyTitle` empty and a few adverts skip the floor or price; those rows still carry everything else. - **Raise `timeoutSeconds`** if you see timeouts on broad searches that page through many results. ### How can I use Otodom property data? **How can I use the Otodom Property Scraper to track Polish house prices?** Paste an otodom.pl search URL for your target city and run it on a schedule. Each row carries `priceValue`, `pricePerSqm`, `listingTitle`, and `publishedAt`, so you can chart asking prices over time and spot fresh adverts the day they land. **How can I compare Otodom neighbourhoods by price per square metre?** Pull listings for several areas, then read `pricePerSqm` straight off each row. With `areaSqm`, `roomCount`, and `locationDetails` alongside, you get a side-by-side view of where the value sits. **How can I build a Poland real estate dataset for investment research?** Feed in one or more search URLs, set `resultsLimit` to the volume you need, and export to CSV or Excel. The result is a structured property database (title, price, area, location, photos, agency) you can score against your own criteria. ### Is it legal to scrape data? Our actors are ethical and do not extract any private user data, such as email addresses or private contact information. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). ### Support Questions, feature requests, or a field you'd like added? Reach out at and we'll get back to you. # Actor input Schema ## `searchUrls` (type: `array`): One or more otodom.pl search URLs to scrape. Each link runs on its own and pages through results automatically. ## `resultsLimit` (type: `integer`): How many listings to pull per search URL. ## `timeoutSeconds` (type: `integer`): Seconds to wait on each request before it times out. ## Actor input object example ```json { "searchUrls": [ { "url": "https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/mazowieckie/warszawa/warszawa/warszawa?limit=36" } ], "resultsLimit": 25, "timeoutSeconds": 45 } ``` # 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 = { "searchUrls": [ { "url": "https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/mazowieckie/warszawa/warszawa/warszawa?limit=36" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("data_api/otodom-scraper-cheap").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 = { "searchUrls": [{ "url": "https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/mazowieckie/warszawa/warszawa/warszawa?limit=36" }] } # Run the Actor and wait for it to finish run = client.actor("data_api/otodom-scraper-cheap").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 '{ "searchUrls": [ { "url": "https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/mazowieckie/warszawa/warszawa/warszawa?limit=36" } ] }' | apify call data_api/otodom-scraper-cheap --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=data_api/otodom-scraper-cheap", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Otodom Scraper (Cheap)", "description": "Otodom property scraper that extracts detailed real estate listings, prices, and high-resolution images, giving you structured market data without the hassle of manual copying.", "version": "0.0", "x-build-id": "0zlsfWIyGoeFCpCLG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_api~otodom-scraper-cheap/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_api-otodom-scraper-cheap", "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/data_api~otodom-scraper-cheap/runs": { "post": { "operationId": "runs-sync-data_api-otodom-scraper-cheap", "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/data_api~otodom-scraper-cheap/run-sync": { "post": { "operationId": "run-sync-data_api-otodom-scraper-cheap", "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": [ "searchUrls" ], "properties": { "searchUrls": { "title": "Search URLs", "type": "array", "description": "One or more otodom.pl search URLs to scrape. Each link runs on its own and pages through results automatically.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "resultsLimit": { "title": "Results limit", "minimum": 1, "maximum": 5000, "type": "integer", "description": "How many listings to pull per search URL.", "default": 25 }, "timeoutSeconds": { "title": "Timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Seconds to wait on each request before it times out.", "default": 45 } } }, "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 } } } } } } } } } } ```