# Adresowo.pl Real Estate Scraper (`trev0n/adresowo-scraper`) Actor Fast scraper for Adresowo.pl — Poland's largest base of direct-from-owner (no-agent) real estate listings. Extracts property offers with prices, GPS coordinates, full photo galleries and descriptions. Supports sale and rent for apartments, houses and plots. - **URL**: https://apify.com/trev0n/adresowo-scraper.md - **Developed by:** [Paweł](https://apify.com/trev0n) (community) - **Categories:** Real estate, Automation, Developer tools - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 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 ## 🏠 Adresowo.pl Real Estate Scraper 🎯 **Tap into Poland's largest base of direct-from-owner property listings — no agents, no middlemen, just clean data.** This scraper collects property offers from Adresowo.pl — the Polish portal famous for its "bez pośredników" (no intermediaries) listings. For every offer you get the price, area, number of rooms, floor, GPS coordinates, full photo gallery, complete description and the seller type — structured and ready to use. ### 🚀 What Does It Do? This scraper automatically searches Adresowo.pl and collects **structured, ready-to-use data** about apartments, houses and plots for sale or rent. No manual browsing needed — just set your filters and hit Start. 💡 **Two modes of operation:** 1. **🔍 Discovery Mode** — Pick a city, property type, sale/rent and optional price, area and room filters; the scraper walks the search results for you 2. **📋 Direct URL Mode** — Paste specific Adresowo.pl search or offer URLs and scrape exactly those ### 👥 Who Is This For? | 🏢 Use Case | 💬 How It Helps | | --------------------------- | ------------------------------------------------------------------------------------------ | | 🔎 **Property Hunters** | Find owner-listed properties before agencies do — negotiate directly, skip commission fees | | 📊 **Real Estate Agencies** | Source fresh private listings for acquisition outreach | | 💼 **Investors & Flippers** | Track below-market direct-from-owner deals across whole cities | | 🏗️ **Proptech Platforms** | Feed your app or CRM with a stream of private-market inventory | | 🧾 **Market Analysts** | Study the private segment of the Polish housing market — pricing, supply, seller behavior | | 🌍 **Relocation Services** | Offer clients no-agent properties with exact locations and full photo galleries | ### ✨ Features - 🤝 **Direct-From-Owner Focus** — Adresowo specializes in private, no-agent listings; every record tells you if it's private or from an agency - 📍 **GPS Coordinates** — Latitude and longitude for every offer, perfect for maps and commute analysis - 📸 **Full Photo Galleries** — Direct links to every photo of the property - 📝 **Complete Descriptions** — Full listing text, not just teasers - 🏘️ **All Property Types** — Apartments, houses and plots - 💰 **Sale & Rent** — Both transaction types supported - 🗺️ **Any Polish City** — Kraków, Warszawa, Wrocław, Poznań, Gdańsk, Łódź and every smaller town - 🎛️ **Smart Filters** — Price, area and rooms ranges applied to every offer - 🧹 **Deduplication** — Every offer appears exactly once per run - ⚡ **Fast & Scalable** — Hundreds of listings per run in a couple of minutes - 📤 **Export Anywhere** — Download results as JSON, CSV, Excel, or push to Google Sheets, Zapier, Make, or your CRM ### 🎛️ Filters & Options | Option | What It Does | | --------------------------- | -------------------------------------------------------------------- | | 🏙️ **City** | Choose any Polish city or town | | 🏘️ **Property Type** | Apartments, houses or plots | | 💼 **Search Type** | Sale or rent | | 💰 **Price Range** | Minimum and maximum price in PLN | | 📐 **Area Range** | Minimum and maximum area in m² | | 🚪 **Rooms Range** | Minimum and maximum number of rooms | | 🔬 **Extract Full Details** | Visit each offer page for GPS, full gallery and complete description | | 🔢 **Max Items** | Control how many offers to extract per run | | 🔗 **Direct URLs** | Optionally provide specific search or offer URLs to scrape | ### 📦 What You Get (Output Fields) Every property offer includes: #### 🏠 Property Info | Field | Example | | ------------- | ---------------------------------------------------------------- | | title | `Kraków Podgórze, ul. Strycharska Mieszkanie - 2 pokoje - 41 m²` | | price | `849000` | | priceCurrency | `PLN` | | area | `41.16` | | numberOfRooms | `2` | | floor | `4` | #### 📍 Location | Field | Example | | --------- | ----------------------------------------------- | | location | `ul. Strycharska, Kraków Podgórze, małopolskie` | | street | `ul. Strycharska` | | latitude | `50.042788` | | longitude | `19.974959` | #### 👤 Seller & Media | Field | Example | | ----------- | ---------------------------------------------------------------------------- | | sellerType | `private` | | images | `["https://s2.adresowa.pl/oi/37/4b/3f3d52_db24_xbig-2-pokojowe-....jpg", …]` | | imageCount | `21` | | description | `Na sprzedaż wyjątkowe, 2-pokojowe mieszkanie o powierzchni 41,16 m²…` | #### 🔗 Reference | Field | Example | | ----------- | -------------------------------------------------------------------- | | id | `4115396` | | propertyUrl | `https://adresowo.pl/o/mieszkanie-krakow-podgorze-2-pokojowe-k0h6w5` | | scrapedAt | `2026-07-02T14:30:00.000Z` | ### 📊 Example Output ```json { "id": "4115396", "offerId": "4115396", "title": "Kraków Podgórze, ul. Strycharska Mieszkanie - 2 pokoje - 41 m² - 4 piętro", "price": 849000, "priceCurrency": "PLN", "area": 41.16, "numberOfRooms": 2, "floor": 4, "location": "ul. Strycharska, Kraków Podgórze, małopolskie", "street": "ul. Strycharska", "latitude": 50.042788, "longitude": 19.974959, "description": "Na sprzedaż wyjątkowe, 2-pokojowe mieszkanie o powierzchni 41,16 m², położone na 4. piętrze przy ul. Strycharskiej w Krakowie…", "sellerType": "private", "images": [ "https://s2.adresowa.pl/oi/37/4b/3f3d52_db24_xbig-2-pokojowe-mieszkanie-krakow-podgorze-ul-strycharska.jpg" ], "imageCount": 21, "mainImage": "https://s2.adresowa.pl/oi/37/4b/3f3d52_db24_xbig-2-pokojowe-mieszkanie-krakow-podgorze-ul-strycharska.jpg", "propertyUrl": "https://adresowo.pl/o/mieszkanie-krakow-podgorze-ul-strycharska-2-pokojowe-k0h6w5", "scrapedAt": "2026-07-02T14:30:00.000Z" } ```` ### 📋 Dataset Views The Apify Console gives you **2 ready-made table views** to quickly browse your results: | View | What It Shows | | -------------------- | --------------------------------------------------------------------- | | 📊 **Overview** | Title, price, area, rooms, location, seller type and link | | 📋 **Detailed View** | Every single field — GPS, photos, floor, street, the complete dataset | ### ❓ FAQ **🤔 What makes Adresowo different from other Polish property portals?** Adresowo specializes in direct-from-owner listings — the majority of offers are posted by private sellers, not agencies. The `sellerType` field tells you which is which, so you can target owner-listed properties only. **🤔 Do I get exact locations?** Yes — every offer includes GPS coordinates (latitude and longitude), plus the street and district, so you can plot results on a map. **🤔 Why do some offers have no price?** A small share of developer offers are listed as "ask for price". When you set a price filter, those offers are automatically excluded; without a price filter they're included with an empty price field. **🤔 Can I export the data?** Yes — JSON, CSV, Excel, XML, HTML, RSS. You can also push data directly to Google Sheets, Zapier, Make, or any webhook/API endpoint. **🤔 How often should I run this?** For fresh data, run daily or weekly. You can schedule automatic runs on Apify with just a few clicks. **🤔 Does it work with proxies?** Yes — the scraper works with Apify's built-in proxy service, though it usually runs fine without any proxy at all. ### 🛠️ Need Custom Filters or Features? **I'm happy to customize this scraper for your specific needs!** 🤝 Whether you need: - 🎯 Additional filters (district-level search, floor, market type, keyword matching in descriptions) - 📊 Extra data fields or custom output formats (e.g., price-per-square-meter reports) - 🔄 Integration with your CRM, Google Sheets, or database - ⏰ Scheduled scraping with automatic deduplication - 🌐 Scraping from other Polish real estate platforms alongside Adresowo (Otodom, Morizon, Gratka, OLX, Domiporta — or all of them at once with cross-portal deduplication) 👉 **Don't hesitate to reach out via private message** — I respond quickly and I'm always open to building exactly what you need. No request is too small or too specific! ### ⚖️ Legal & Ethical Use This scraper collects **only publicly available information** from Adresowo.pl. It does not access private data, bypass authentication, or reveal hidden contact details. Please use the data responsibly and in compliance with applicable laws and platform terms of service. # Actor input Schema ## `startUrls` (type: `array`): List of Adresowo.pl URLs to scrape. Can be search result pages (e.g., https://adresowo.pl/mieszkania/krakow/) or individual offer URLs (https://adresowo.pl/o/...). If provided, search filters below are ignored. ## `searchType` (type: `string`): Type of search: sale or rent. ## `propertyType` (type: `string`): Type of property to search for. ## `city` (type: `string`): City name (e.g., 'Kraków', 'Warszawa', 'Wrocław'). ## `priceMin` (type: `integer`): Minimum price in PLN. Offers without a public price ('ask for price') are excluded when a price limit is set. ## `priceMax` (type: `integer`): Maximum price in PLN. Offers without a public price ('ask for price') are excluded when a price limit is set. ## `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. ## `maxItems` (type: `integer`): Maximum number of property listings to scrape (0 = unlimited). ## `extractDetails` (type: `boolean`): When enabled, visits each offer page for full details (GPS coordinates, full photo gallery, complete description). When disabled, extracts listing-card data only (faster). ## `maxConcurrency` (type: `integer`): Maximum number of parallel requests. ## `maxRequestRetries` (type: `integer`): Maximum number of retries for failed requests. ## `maxRequestsPerMinute` (type: `integer`): Maximum number of requests per minute to avoid rate limiting. ## `proxyConfiguration` (type: `object`): Proxy settings. Usually not required — portal has no aggressive anti-bot. ## Actor input object example ```json { "searchType": "sprzedaz", "propertyType": "mieszkanie", "city": "Kraków", "maxItems": 50, "extractDetails": true, "maxConcurrency": 10, "maxRequestRetries": 2, "maxRequestsPerMinute": 120 } ``` # Actor output Schema ## `overview` (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 = { "city": "Kraków" }; // Run the Actor and wait for it to finish const run = await client.actor("trev0n/adresowo-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 = { "city": "Kraków" } # Run the Actor and wait for it to finish run = client.actor("trev0n/adresowo-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 '{ "city": "Kraków" }' | apify call trev0n/adresowo-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=trev0n/adresowo-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Adresowo.pl Real Estate Scraper", "description": "Fast scraper for Adresowo.pl — Poland's largest base of direct-from-owner (no-agent) real estate listings. Extracts property offers with prices, GPS coordinates, full photo galleries and descriptions. Supports sale and rent for apartments, houses and plots.", "version": "1.0", "x-build-id": "4PYyyjple7sPUY6ab" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/trev0n~adresowo-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-trev0n-adresowo-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/trev0n~adresowo-scraper/runs": { "post": { "operationId": "runs-sync-trev0n-adresowo-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/trev0n~adresowo-scraper/run-sync": { "post": { "operationId": "run-sync-trev0n-adresowo-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "List of Adresowo.pl URLs to scrape. Can be search result pages (e.g., https://adresowo.pl/mieszkania/krakow/) or individual offer URLs (https://adresowo.pl/o/...). If provided, search filters below are ignored.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchType": { "title": "Search Type", "enum": [ "sprzedaz", "wynajem" ], "type": "string", "description": "Type of search: sale or rent.", "default": "sprzedaz" }, "propertyType": { "title": "Property Type", "enum": [ "mieszkanie", "dom", "dzialka" ], "type": "string", "description": "Type of property to search for.", "default": "mieszkanie" }, "city": { "title": "City", "type": "string", "description": "City name (e.g., 'Kraków', 'Warszawa', 'Wrocław')." }, "priceMin": { "title": "Price Min (PLN)", "minimum": 0, "type": "integer", "description": "Minimum price in PLN. Offers without a public price ('ask for price') are excluded when a price limit is set." }, "priceMax": { "title": "Price Max (PLN)", "minimum": 0, "type": "integer", "description": "Maximum price in PLN. Offers without a public price ('ask for price') are excluded when a price limit is set." }, "areaMin": { "title": "Area Min (m²)", "minimum": 0, "type": "integer", "description": "Minimum area in square meters." }, "areaMax": { "title": "Area Max (m²)", "minimum": 0, "type": "integer", "description": "Maximum area in square meters." }, "roomsMin": { "title": "Rooms Min", "minimum": 1, "maximum": 10, "type": "integer", "description": "Minimum number of rooms." }, "roomsMax": { "title": "Rooms Max", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum number of rooms." }, "maxItems": { "title": "Max Items", "minimum": 0, "type": "integer", "description": "Maximum number of property listings to scrape (0 = unlimited).", "default": 50 }, "extractDetails": { "title": "Extract Full Details", "type": "boolean", "description": "When enabled, visits each offer page for full details (GPS coordinates, full photo gallery, complete description). When disabled, extracts listing-card data only (faster).", "default": true }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of parallel requests.", "default": 10 }, "maxRequestRetries": { "title": "Max Request Retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "Maximum number of retries for failed requests.", "default": 2 }, "maxRequestsPerMinute": { "title": "Max Requests Per Minute", "minimum": 10, "maximum": 300, "type": "integer", "description": "Maximum number of requests per minute to avoid rate limiting.", "default": 120 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Usually not required — portal has no aggressive anti-bot." } } }, "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 } } } } } } } } } } ```