# Otodom Scraper - Polish Real Estate Listings (`rigelbytes/otodom-scraper`) Actor Scrapes property listings from Otodom.pl, Poland's leading real estate marketplace. Supports filters for transaction type, property type, location, price, area, rooms, building type, extras, and more. - **URL**: https://apify.com/rigelbytes/otodom-scraper.md - **Developed by:** [Rigel Bytes](https://apify.com/rigelbytes) (community) - **Categories:** News, 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.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 Scraper - Polish Real Estate Listings Extract property listings from **Otodom.pl**, Poland's leading real estate marketplace. Capture prices, locations, property details, agent info, and images for market research, price monitoring, and investment analysis — from **$1 per 1,000 listings**. --- ### What can Otodom Scraper do for you? - **Build a Polish property database** — Collect thousands of listings from Otodom with prices, floor plans, and location data for any city or region in Poland. - **Monitor rental and sale prices** — Track price trends, price per square meter, and listing volume across transactions, property types, and markets. - **Generate real estate leads** — Capture agent names, agency details, and private owner contacts from active listings. - **Export structured data** — Download clean JSON, CSV, or Excel datasets ready for dashboards, spreadsheets, or CRM integration. - **Filter by every relevant criteria** — Transaction type, property type, location, price range, area, rooms, building type, amenities, floor number, build year, and more. ### What data can you extract? | Field | Description | |-------|-------------| | 🏷️ Title & URL | Listing title, slug, and direct Otodom link | | 💰 Price | Total price (PLN), price per m², currency | | 📐 Area | Living area and terrain area in m² | | 🛏️ Rooms | Number of rooms (ONE through SIX+) | | 📍 Location | Street, city, province, and full address | | 🏢 Property type | FLAT, HOUSE, ROOM, COMMERCIAL_PROPERTY, etc. | | 🔄 Transaction | SELL or RENT | | 🖼️ Images | Primary image + all gallery image URLs, image count | | 🏛️ Agent data | Agency name, type, and ID where available | | 👤 Owner | Owner name and private owner flag | | 📅 Listing age | Date created, days since posted | | ⭐ Flags | Is exclusive offer, is promoted, has photos, hide price | ### Why use this scraper? - **📊 Market research** — Analyze Polish real estate trends across cities and regions. Compare prices per m², listing volumes, and property types. - **🔍 Price monitoring** — Track how listing prices change over time. Set up recurring runs to detect price drops and new inventory. - **🤖 Automation** — Schedule the scraper to run daily or weekly. Get alerts when new listings matching your criteria appear. - **📈 Investment analysis** — Evaluate rental yields, price distribution, and market saturation in specific Polish neighborhoods. ### Pricing - **$1/1,000 listings** - No hidden fees or limits on usage. ### How to use Otodom Scraper 1. **Create an Apify account** at [console.apify.com](https://console.apify.com) if you don't have one. 2. **Open the Otodom Scraper** on Apify Store. 3. **Paste your search URL** from Otodom.pl, or configure filters (transaction, location, price, rooms, etc.). 4. **Set a limit** — choose max items or max pages to control the run volume. 5. **Click Start** — the scraper will extract all matching listings. 6. **Download** your data as JSON, CSV, or Excel from the Apify dataset. ### Input The scraper accepts two modes of input: #### Option A: Full Search URL (preferred) Paste any Otodom search results URL directly. All filters below are ignored when a URL is provided. #### Option B: Individual Filters | Field | Type | Required | Description | |-------|------|----------|-------------| | `availability` | string | optional | Immediate availability: empty (Any) or NOW | | `locationQuery` | string | optional | City, region, or Otodom domain path (e.g. `dolnoslaskie/dzierzoniowski/bielawa/bielawa`) | | `transaction` | string (SELL/RENT) | optional | For sale or for rent (default: SELL) | | `estate` | string | optional | Property type: FLAT, HOUSE, ROOM, etc. (default: FLAT) | | `market` | string | optional | PRIMARY, SECONDARY, or ALL (default: ALL) | | `ownerType` | string | optional | PRIVATE, DEVELOPER, AGENCY, or ALL (default: ALL) | | `priceMin` | integer | optional | Minimum price in PLN | | `priceMax` | integer | optional | Maximum price in PLN | | `areaMin` | integer | optional | Minimum area in m² | | `areaMax` | integer | optional | Maximum area in m² | | `roomsNumber` | array | optional | Room count filter (ONE, TWO, THREE, etc.) | | `buildingType` | array | optional | Building construction type | | `extras` | array | optional | Amenities: BALCONY, GARAGE, LIFT, AIR_CONDITIONING, etc. | | `heating` | array | optional | Heating type: URBAN, GAS, ELECTRICAL, etc. | | `floorNumber` | array | optional | Floor position filter | | `floorsNumberMin` | integer | optional | Min building floors | | `floorsNumberMax` | integer | optional | Max building floors | | `buildYearMin` | integer | optional | Min construction year | | `buildYearMax` | integer | optional | Max construction year | | `daysSinceCreated` | string | optional | Listing age: 1, 3, 7, 14, 30 | | `hasPhotos` | boolean | optional | Only listings with photos (default: false) | | `isExclusiveOffer` | boolean | optional | Only exclusive offers (default: false) | | `sortBy` | string | optional | DEFAULT, PRICE, DATE, AREA | | `sortDirection` | string | optional | DESC or ASC | | `maxPages` | integer | optional | Max result pages (~36 listings/page, 0 = unlimited) | | `maxItems` | integer | optional | Max listings (0 = unlimited, takes precedence over maxPages) | | `proxyConfiguration` | object | optional | Proxy settings for anti-bot protection | #### 📝 Copy for Use: ```json { "searchUrl": "https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/dolnoslaskie/dzierzoniowski/bielawa/bielawa?priceMin=0&priceMax=500000", "maxItems": 20, "proxyConfiguration": { "useApifyProxy": false } } ```` ### Why Choose This Scraper? - **Affordable**: Pay only **$1 per 1,000 listings** scraped. - **Comprehensive**: Extract 30+ data points per listing — price, area, rooms, location, images, agent info, and more. - **Easy to Use**: Paste a search URL or configure filters in the input form. No coding required. - **Reliable**: Uses the Otodom GraphQL API directly for consistent, structured data extraction. ### Recommended Proxy Providers - ## **Shifter** - Reliable residential proxies all over the world. - Cheap rates - [Order Shifter Now](https://shifter.io/r/YoBB/order) - Get 10% Off any product, use coupan `rigelbytes-YoBB`. - ## **OxyLabs** - **100M+ Proxies** - Fastest proxies in the market - Real profile, human-like Residential IPs - Quality assurance framework for most reliable IPs - [Get Proxies](https://oxylabs.go2cloud.org/aff_c?offer_id=7\&aff_id=1366\&url_id=7) - ## **DataImpulse** - Covers **200+ Counties** - Reliable Residential Proxies for just $1/GB - [Get Residential Proxies](https://dataimpulse.com/?aff=89421) ### [![Learn More About Proxies](https://img.shields.io/badge/Learn_More-About_Proxies-blue?style=for-the-badge)](#understanding-proxies) ### 🙌 Why Buy Through Our Affiliate Link? - Exclusive Deals: Some providers may offer special discounts or bonuses when you use our link. - Support Our Work: Each purchase helps us maintain and improve the tools and services we provide. - No Extra Cost: You pay the same price, but part of it goes to supporting our efforts. #### Running via Apify Console You can run this actor from the Apify Console by providing the necessary input parameters. #### Running via API You can trigger this actor using the Apify API, passing the required input in the request body. *** ### API Examples #### Python ```shell from apify_client import ApifyClient client = ApifyClient("YOUR_API_TOKEN") run = client.actor("rigelbytes/otodom-scraper").call( run_input={ "searchUrl": "https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/dolnoslaskie/dzierzoniowski/bielawa/bielawa?priceMin=0&priceMax=500000", "maxItems": 20 } ) dataset = client.dataset(run["defaultDatasetId"]).list_items().items ``` #### JavaScript ```shell import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_API_TOKEN' }); const run = await client.actor('rigelbytes/otodom-scraper').call({ searchUrl: 'https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/dolnoslaskie/dzierzoniowski/bielawa/bielawa?priceMin=0&priceMax=500000', maxItems: 20 }); const dataset = await client.dataset(run.defaultDatasetId).listItems(); ``` #### cURL ```shell curl -X POST https://api.apify.com/v2/acts/rigelbytes/otodom-scraper/runs \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -d '{ "searchUrl": "https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/dolnoslaskie/dzierzoniowski/bielawa/bielawa?priceMin=0&priceMax=500000", "maxItems": 20 }' ``` *** ### 🚀 Other Tools by Rigel Bytes Explore **71** more scraping tools by Rigel Bytes, organized by use case: #### 📱 Social Media Scrape Instagram, TikTok, LinkedIn, and more for content research and marketing intelligence. - **[Export Instagram Reels](https://apify.com/rigelbytes/export-instagram-reels)** — Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Facebook Ads Scraper](https://apify.com/rigelbytes/facebook-ads-scraper)** — Extract posts, profiles, and engagement data from Facebook for content research, influencer tracking, and marketing analytics. - **[Instagram Analytics Tool](https://apify.com/rigelbytes/instagram-analytics-tool)** — Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Instagram Comment Scraper](https://apify.com/rigelbytes/instagram-comment-scraper)** — Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Instagram Creator Stats](https://apify.com/rigelbytes/instagram-creator-stats)** — Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Instagram Engagement Tool](https://apify.com/rigelbytes/instagram-engagement-tool)** — Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Instagram Post Scraper](https://apify.com/rigelbytes/instagram-post-scraper)** — Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[instagram-posts](https://apify.com/rigelbytes/instagram-posts)** — Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Instagram Profile Scraper](https://apify.com/rigelbytes/instagram-profile-scraper)** — Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Instagram Reel Scraper](https://apify.com/rigelbytes/instagram-reel-scraper)** — Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[linkedin-company-details](https://apify.com/rigelbytes/linkedin-company-details)** — Extract posts, profiles, and engagement data from LinkedIn for content research, influencer tracking, and marketing analytics. - **[Linkedin Company Scraper](https://apify.com/rigelbytes/linkedin-company-scraper)** — Extract posts, profiles, and engagement data from LinkedIn for content research, influencer tracking, and marketing analytics. - **[LinkedIn Profile Scraper](https://apify.com/rigelbytes/linkedin-profile-scraper)** — Extract posts, profiles, and engagement data from LinkedIn for content research, influencer tracking, and marketing analytics. - **[Scrape Instagram Creators](https://apify.com/rigelbytes/scrape-instagram-creators)** — Extract posts, profiles, and engagement data from Instagram for content research, influencer tracking, and marketing analytics. - **[Tiktok Comment Scraper](https://apify.com/rigelbytes/tiktok-comment-scraper)** — Extract posts, profiles, and engagement data from TikTok for content research, influencer tracking, and marketing analytics. - **[Tiktok Creator Stats](https://apify.com/rigelbytes/tiktok-creator-stats)** — Extract posts, profiles, and engagement data from TikTok for content research, influencer tracking, and marketing analytics. - **[Tiktok Engagement Rate](https://apify.com/rigelbytes/tiktok-engagement-rate)** — Extract posts, profiles, and engagement data from TikTok for content research, influencer tracking, and marketing analytics. - **[TikTok Profile Scraper](https://apify.com/rigelbytes/tiktok-profile-scraper)** — Extract posts, profiles, and engagement data from TikTok for content research, influencer tracking, and marketing analytics. #### 🏠 Real Estate Extract property listings, prices, and agent data from top real estate platforms. - **[Airbnb Address Finder](https://apify.com/rigelbytes/airbnb-address-finder)** — Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Availability Calendar](https://apify.com/rigelbytes/airbnb-availability-calendar)** — Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Detailed Scraper - Search & Listing Details](https://apify.com/rigelbytes/airbnb-detailed-scraper)** — Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Images Downloader](https://apify.com/rigelbytes/airbnb-images-downloader)** — Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Listing](https://apify.com/rigelbytes/airbnb-listing)** — Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Listing Urls](https://apify.com/rigelbytes/airbnb-listing-urls)** — Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Property Details](https://apify.com/rigelbytes/airbnb-property-details)** — Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Reviews](https://apify.com/rigelbytes/airbnb-reviews)** — Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Airbnb Scraper - Search & Listing Details](https://apify.com/rigelbytes/airbnb-scraper)** — Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Bayut Scraper](https://apify.com/rigelbytes/bayut-scraper)** — Scrape property listings and market data from Bayut for market research, price monitoring, and investment analysis. - **[Boligsiden.dk Scraper](https://apify.com/rigelbytes/boligsiden-dk-scraper)** — Scrape Danish real estate listings from Boligsiden.dk — for sale, sold, and rental properties with pricing, details,... - **[Daft.ie Property Scraper](https://apify.com/rigelbytes/daft-ie-scraper)** — Scrapes property listings from Daft.ie including residential, rental, commercial, and new homes across Ireland. - **[dubai-listing-scraper](https://apify.com/rigelbytes/dubai-listing-scraper)** — Extract unlimited property listings from Bayut.com — the UAE's largest real estate platform. Get detailed property... - **[Export Airbnb Calendar](https://apify.com/rigelbytes/export-airbnb-calendar)** — Scrape property listings and market data from Airbnb for market research, price monitoring, and investment analysis. - **[Furnished Finder Fast](https://apify.com/rigelbytes/furnished-finder-fast)** — Scrape property listings and market data from Furnished Finder for market research, price monitoring, and investment analysis. - **[Extract Furnished Finder Hosts](https://apify.com/rigelbytes/furnished-finder-hosts)** — Scrape property listings and market data from Furnished Finder for market research, price monitoring, and investment analysis. - **[FurnishedFinder](https://apify.com/rigelbytes/furnishedfinder)** — Scrape property listings and market data from Furnished Finder for market research, price monitoring, and investment analysis. - **[Hemnet.se Scraper - Swedish Real Estate Listings](https://apify.com/rigelbytes/hemnet-se-scraper)** — Scrape property listings from Hemnet.se including for-sale, upcoming, and sold homes. Search by URL or location... - **[Immobiliare Italy Real Estate Scraper](https://apify.com/rigelbytes/immobiliare-it-scraper)** — Scrape property listings and market data from real estate portals for market research, price monitoring, and investment analysis. - **[Immobilienscout24](https://apify.com/rigelbytes/immobilienscout24)** — Scrape property listings and market data from real estate portals for market research, price monitoring, and investment analysis. - **[Immobilienscout24-scraper](https://apify.com/rigelbytes/immobilienscout24-scraper)** — Scrape property listings and market data from real estate portals for market research, price monitoring, and investment analysis. - **[Immoweb Scraper - Belgium Property Listings](https://apify.com/rigelbytes/immoweb-scraper)** — Scrapes property listings from Immoweb.be. Supports search result extraction with optional property detail enrichment. - **[Immowelt Property Scraper](https://apify.com/rigelbytes/immowelt-property-scraper)** — The Immowelt Scraper helps you extract unlimited real estate listings from Immowelt with complete details including... - **[Immowelt Scraper](https://apify.com/rigelbytes/immowelt-scraper)** — The Immowelt Scraper helps you extract unlimited real estate listings from Immowelt with complete details including... - **[Land.com Scraper](https://apify.com/rigelbytes/landdotcom-scraper)** — Scrape property listings and market data from Land.com for market research, price monitoring, and investment analysis. - **[Outdoorsy Scraper](https://apify.com/rigelbytes/outdoorsy-scraper)** — Scrape property listings and market data from Outdoorsy for market research, price monitoring, and investment analysis. - **[Propertyfinder Scraper](https://apify.com/rigelbytes/propertyfinder-scraper)** — Scrape property listings and market data from Property Finder for market research, price monitoring, and investment analysis. - **[Redfin Scraper](https://apify.com/rigelbytes/redfin-scraper)** — Scrape property listings and market data from Redfin for market research, price monitoring, and investment analysis. - **[Rightmove Scraper](https://apify.com/rigelbytes/rightmove-scraper)** — Scrape property listings and market data from Rightmove for market research, price monitoring, and investment analysis. - **[RVshare Scraper](https://apify.com/rigelbytes/rvshare-scraper)** — Scrape property listings and market data from RVshare for market research, price monitoring, and investment analysis. - **[Unlimited Redfin Scraper](https://apify.com/rigelbytes/unlimited-redfin-scraper)** — Scrape property listings and market data from Redfin for market research, price monitoring, and investment analysis. - **[Zillow Detail Scraper](https://apify.com/rigelbytes/zillow-detail-scraper)** — Scrape property listings and market data from Zillow for market research, price monitoring, and investment analysis. - **[Zillow Scraper](https://apify.com/rigelbytes/zillow-scraper)** — Scrape property listings and market data from Zillow for market research, price monitoring, and investment analysis. - **[Zoopla Scraper](https://apify.com/rigelbytes/zoopla-scraper)** — Scrape property listings and market data from Zoopla for market research, price monitoring, and investment analysis. #### ✈️ Travel & Hospitality Monitor rentals, bookings, and travel listings at scale. - **[Ticketmaster Scraper](https://apify.com/rigelbytes/ticketmaster-scraper)** — Collect rental and travel listings from Ticketmaster for pricing intelligence and availability tracking. #### 🛒 E-commerce Scrape products, prices, and marketplace data for competitive research. - **[Amazon Product Scraper](https://apify.com/rigelbytes/amazon-product-scraper)** — Scrape products, prices, and seller data from Amazon for competitor monitoring, pricing, and product research. - **[Amazon Search Scraper](https://apify.com/rigelbytes/amazon-scraper)** — Scrape products, prices, and seller data from Amazon for competitor monitoring, pricing, and product research. - **[Daraz](https://apify.com/rigelbytes/daraz)** — Scrape products, prices, and seller data from Daraz for competitor monitoring, pricing, and product research. - **[Etsy Scraper](https://apify.com/rigelbytes/etsy-scraper)** — Scrape products, prices, and seller data from Etsy for competitor monitoring, pricing, and product research. - **[Homedepot Scraper](https://apify.com/rigelbytes/homedepot-scraper)** — HomeDepot Products Scraper lets you extract product data from homedepot.com using a collection URL and delivery ZIP.... #### 📩 Lead Generation Find business contacts, leads, and company data for sales and outreach. - **[Company Service Finder](https://apify.com/rigelbytes/company-service-finder)** — The Company Service Finder uses AI to extract and analyze company services from Google Search & Maps. Get detailed... - **[Doctify Scraper](https://apify.com/rigelbytes/doctify-scraper)** — Doctify Scraper lets you extract doctor and practice data from doctify.com using a search results URL. Collect... - **[FindLaw Law Firm Scraper - Attorney & Law Firm Data Extraction](https://apify.com/rigelbytes/findlaw-scraper)** — Scrape law firm profiles from FindLaw.com. Extract detailed attorney and firm information including contact details,... - **[Google Maps Scraper](https://apify.com/rigelbytes/google-maps-scraper)** — Find business leads and contact details from Google Maps for outbound sales, prospecting, and CRM enrichment. - **[Website Services Finder](https://apify.com/rigelbytes/website-services-finder)** — Automatically extract and analyze company services from any business website using advanced AI. Choose from 5 AI... - **[Zillow Agents](https://apify.com/rigelbytes/zillow-agents)** — Find business leads and contact details from Zillow for outbound sales, prospecting, and CRM enrichment. - **[Zillow Agents Phone](https://apify.com/rigelbytes/zillow-agents-phone)** — Find business leads and contact details from Zillow for outbound sales, prospecting, and CRM enrichment. #### ⭐ Reviews & Ratings Monitor reviews and reputation data across review platforms. - **[Airbnb Listing Reviews](https://apify.com/rigelbytes/airbnb-listing-reviews)** — Collect reviews and ratings from Airbnb for reputation monitoring and customer insights. - **[BBB Scraper](https://apify.com/rigelbytes/bbb-scraper)** — Collect reviews and ratings from BBB for reputation monitoring and customer insights. - **[Rottentomatoes Reviews Scraper](https://apify.com/rigelbytes/rottentomatoes-reviews-scraper)** — Collect reviews and ratings from Rotten Tomatoes for reputation monitoring and customer insights. - **[Trustpilot Reviews Scraper](https://apify.com/rigelbytes/trustpilot-reviews)** — Collect reviews and ratings from Trustpilot for reputation monitoring and customer insights. #### 🍔 Food & Delivery Extract restaurant, grocery, and delivery platform data. - **[Instacart Scraper](https://apify.com/rigelbytes/instacart-scraper)** — Scrape menus, stores, and delivery data from Instacart for data-driven research and automation. - **[Publix Scraper](https://apify.com/rigelbytes/publix-scraper)** — Scrape menus, stores, and delivery data from Publix for data-driven research and automation. #### 🛠️ Developer Tools General-purpose scraping and automation tools. - **[Web Crawler](https://apify.com/rigelbytes/webcrawler)** — This web crawler is designed to provide users with complete flexibility by allowing them to use their \*\*own... ### Understanding Proxies: When scraping data or browsing anonymously, proxies are essential. They act as intermediaries, masking your original IP address and allowing you to send requests from another location. #### Why Use Proxies? - Avoid IP Blocks: By routing requests through proxies, you prevent the target website from recognizing your IP as a scraper or spammer. - Access Geo-restricted Content: Proxies let you access content or websites restricted by location. - Enhance Anonymity: Hide your actual IP, ensuring privacy while scraping or browsing. #### Types of Proxies 1. Residential Proxies - Real IP addresses provided by ISPs to home users. - They mimic regular users, making them harder to detect. - Best for: Long-term, undetectable scraping, and avoiding blocks. 2. Data Center Proxies - IP addresses from servers in data centers. - Faster and cheaper than residential proxies but easier to detect and block. - Best for: High-speed scraping, but with a higher risk of detection. 3. Mobile Proxies - IPs provided by mobile carriers (3G/4G/5G networks). - Very difficult to detect, as they appear as regular mobile users. - Best for: Mobile-related scraping or avoiding sophisticated blocks. #### Rotating Proxies vs. Straight Proxies - Rotating Proxies: Every request you send goes through a different proxy, making it harder for websites to detect patterns. - Straight Proxies: All requests are sent through the same proxy, making it easier to track your IP. ### About Rigel Bytes Rigel Bytes specializes in web scraping, automation, and data analytics. We help businesses extract and leverage valuable data for informed decision-making. ### Contact Us Ready to unlock the power of data? Reach out to us at (contact@rigelbytes.com) or [book an appointment](https://cal.com/faizanali/appointments) with us to learn more about how we can help you achieve your data goals. ### Detailed Data ```json [ { "id": 68126450, "title": "3-POKOJOWE MIESZKANIE – BIELAWA, UL. REYMONTA", "url": "https://www.otodom.pl/pl/ad/3-pokojowe-mieszkanie-bielawa-ul-reymonta-ID4BQNI", "estate": "FLAT", "transaction": "RENT", "totalPrice": 1900, "priceCurrency": "PLN", "pricePerSquareMeter": 29, "areaInSquareMeters": 65, "roomsNumber": "THREE", "floorNumber": "SECOND", "dateCreated": "2026-06-20 10:06:56", "isPrivateOwner": true, "city": "Bielawa", "province": "dolnośląskie", "location": "ul. Władysława Stanisława Reymonta, Bielawa, dolnośląskie", "imageCount": 11 }, { "id": 68118657, "title": "Przytulne 2 pokoje z ogródkiem po remoncie, Bielawa, ul. 11 Listopada", "url": "https://www.otodom.pl/pl/ad/przytulne-2-pokoje-z-ogrodkiem-po-remoncie-bielawa-ul-11-listopada-ID4BOM1", "estate": "FLAT", "transaction": "RENT", "totalPrice": 1600, "priceCurrency": "PLN", "pricePerSquareMeter": 42, "areaInSquareMeters": 38, "roomsNumber": "TWO", "floorNumber": "SECOND", "dateCreated": "2026-06-17 19:31:40", "isPrivateOwner": false, "agencyName": "RG PROPERTY", "agencyType": "AGENCY", "city": "Bielawa", "province": "dolnośląskie", "imageCount": 1 } ] ``` # Actor input Schema ## `searchUrl` (type: `string`): Full URL copied from otodom.pl search results. When provided, this URL is preferred and all filter fields below are ignored (only Max Items, Max Pages, and Proxy apply). ## `locationQuery` (type: `string`): City or region name (e.g. 'Bielawa', 'Warszawa') or full Otodom domain path (e.g. 'dolnoslaskie/dzierzoniowski/bielawa/bielawa'). Free-text names are resolved automatically via Otodom autocomplete. Ignored when Search URL is provided. ## `transaction` (type: `string`): For sale or for rent. Ignored when Search URL is provided. ## `estate` (type: `string`): Type of property. Ignored when Search URL is provided. ## `market` (type: `string`): Primary (new developments) or Secondary (resale). Ignored when Search URL is provided. ## `ownerType` (type: `string`): Filter by seller type. Ignored when Search URL is provided. ## `availability` (type: `string`): When the property is available from. Ignored when Search URL is provided. ## `priceMin` (type: `integer`): Minimum total price in PLN. Ignored when Search URL is provided. ## `priceMax` (type: `integer`): Maximum total price in PLN. Ignored when Search URL is provided. ## `areaMin` (type: `integer`): Minimum living area in square meters. Ignored when Search URL is provided. ## `areaMax` (type: `integer`): Maximum living area in square meters. Ignored when Search URL is provided. ## `roomsNumber` (type: `array`): Filter by number of rooms. Ignored when Search URL is provided. ## `buildingType` (type: `array`): Type of building construction. Ignored when Search URL is provided. ## `heating` (type: `array`): Heating type. Ignored when Search URL is provided. ## `floorNumber` (type: `array`): Floor position of the property. Ignored when Search URL is provided. ## `floorsNumberMin` (type: `integer`): Minimum number of floors in the building. Ignored when Search URL is provided. ## `floorsNumberMax` (type: `integer`): Maximum number of floors in the building. Ignored when Search URL is provided. ## `buildYearMin` (type: `integer`): Minimum construction year. Ignored when Search URL is provided. ## `buildYearMax` (type: `integer`): Maximum construction year. Ignored when Search URL is provided. ## `extras` (type: `array`): Property amenities (multi-select). Ignored when Search URL is provided. ## `daysSinceCreated` (type: `string`): Filter listings by how recently they were posted. Ignored when Search URL is provided. ## `hasPhotos` (type: `boolean`): Only show listings that have photos. Ignored when Search URL is provided. ## `isExclusiveOffer` (type: `boolean`): Only show exclusive offers (private listings). Ignored when Search URL is provided. ## `sortBy` (type: `string`): How to sort the results. Ignored when Search URL is provided. ## `sortDirection` (type: `string`): Ascending or descending order. Ignored when Search URL is provided. ## `maxPages` (type: `integer`): Maximum number of result pages to scrape (0 = unlimited, ~36 listings per page). maxItems takes precedence. ## `maxItems` (type: `integer`): Maximum number of listings to scrape (0 = unlimited). Takes precedence over maxPages. ## `proxyConfiguration` (type: `object`): Proxy settings for anti-bot protection ## Actor input object example ```json { "searchUrl": "https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/dolnoslaskie/dzierzoniowski/bielawa/bielawa?priceMin=0&priceMax=500000", "locationQuery": "dolnoslaskie/dzierzoniowski/bielawa/bielawa", "transaction": "SELL", "estate": "FLAT", "market": "ALL", "ownerType": "ALL", "availability": "", "daysSinceCreated": "", "hasPhotos": false, "isExclusiveOffer": false, "sortBy": "DEFAULT", "sortDirection": "DESC", "maxPages": 0, "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): Dataset containing scraped property listings # 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 = { "searchUrl": "https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/dolnoslaskie/dzierzoniowski/bielawa/bielawa?priceMin=0&priceMax=500000", "locationQuery": "dolnoslaskie/dzierzoniowski/bielawa/bielawa", "maxItems": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("rigelbytes/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 = { "searchUrl": "https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/dolnoslaskie/dzierzoniowski/bielawa/bielawa?priceMin=0&priceMax=500000", "locationQuery": "dolnoslaskie/dzierzoniowski/bielawa/bielawa", "maxItems": 20, } # Run the Actor and wait for it to finish run = client.actor("rigelbytes/otodom-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 '{ "searchUrl": "https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/dolnoslaskie/dzierzoniowski/bielawa/bielawa?priceMin=0&priceMax=500000", "locationQuery": "dolnoslaskie/dzierzoniowski/bielawa/bielawa", "maxItems": 20 }' | apify call rigelbytes/otodom-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=rigelbytes/otodom-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Otodom Scraper - Polish Real Estate Listings", "description": "Scrapes property listings from Otodom.pl, Poland's leading real estate marketplace. Supports filters for transaction type, property type, location, price, area, rooms, building type, extras, and more.", "version": "1.0", "x-build-id": "zMDVbY3qUiADhKg5T" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rigelbytes~otodom-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rigelbytes-otodom-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/rigelbytes~otodom-scraper/runs": { "post": { "operationId": "runs-sync-rigelbytes-otodom-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/rigelbytes~otodom-scraper/run-sync": { "post": { "operationId": "run-sync-rigelbytes-otodom-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": { "searchUrl": { "title": "Search URL", "type": "string", "description": "Full URL copied from otodom.pl search results. When provided, this URL is preferred and all filter fields below are ignored (only Max Items, Max Pages, and Proxy apply)." }, "locationQuery": { "title": "Location", "type": "string", "description": "City or region name (e.g. 'Bielawa', 'Warszawa') or full Otodom domain path (e.g. 'dolnoslaskie/dzierzoniowski/bielawa/bielawa'). Free-text names are resolved automatically via Otodom autocomplete. Ignored when Search URL is provided." }, "transaction": { "title": "Transaction Type", "enum": [ "SELL", "RENT" ], "type": "string", "description": "For sale or for rent. Ignored when Search URL is provided.", "default": "SELL" }, "estate": { "title": "Property Type", "enum": [ "FLAT", "STUDIO_FLAT", "HOUSE", "INVESTMENT", "ROOM", "TERRAIN", "AGRICULTURAL", "COMMERCIAL_PROPERTY", "HALL", "GARAGE", "OFFICE" ], "type": "string", "description": "Type of property. Ignored when Search URL is provided.", "default": "FLAT" }, "market": { "title": "Market", "enum": [ "ALL", "PRIMARY", "SECONDARY" ], "type": "string", "description": "Primary (new developments) or Secondary (resale). Ignored when Search URL is provided.", "default": "ALL" }, "ownerType": { "title": "Owner Type", "enum": [ "ALL", "PRIVATE", "DEVELOPER", "AGENCY" ], "type": "string", "description": "Filter by seller type. Ignored when Search URL is provided.", "default": "ALL" }, "availability": { "title": "Availability", "enum": [ "", "NOW" ], "type": "string", "description": "When the property is available from. Ignored when Search URL is provided.", "default": "" }, "priceMin": { "title": "Minimum Price (PLN)", "minimum": 0, "type": "integer", "description": "Minimum total price in PLN. Ignored when Search URL is provided." }, "priceMax": { "title": "Maximum Price (PLN)", "minimum": 0, "type": "integer", "description": "Maximum total price in PLN. Ignored when Search URL is provided." }, "areaMin": { "title": "Minimum Area (m²)", "minimum": 0, "type": "integer", "description": "Minimum living area in square meters. Ignored when Search URL is provided." }, "areaMax": { "title": "Maximum Area (m²)", "minimum": 0, "type": "integer", "description": "Maximum living area in square meters. Ignored when Search URL is provided." }, "roomsNumber": { "title": "Number of Rooms", "uniqueItems": true, "type": "array", "description": "Filter by number of rooms. Ignored when Search URL is provided.", "items": { "type": "string", "enum": [ "ONE", "TWO", "THREE", "FOUR", "FIVE", "SIX", "MORE" ], "enumTitles": [ "1", "2", "3", "4", "5", "6", "6+" ] } }, "buildingType": { "title": "Building Type", "uniqueItems": true, "type": "array", "description": "Type of building construction. Ignored when Search URL is provided.", "items": { "type": "string", "enum": [ "BLOCK", "HOUSE", "TENEMENT", "INFILL", "RIBBON", "APARTMENT", "LOFT", "TERRACED", "SEMI_DETACHED", "PREFAB" ], "enumTitles": [ "Apartment block", "House", "Tenement", "Infill", "Ribbon", "Apartment building", "Loft", "Terraced house", "Semi-detached", "Prefabricated" ] } }, "heating": { "title": "Heating", "uniqueItems": true, "type": "array", "description": "Heating type. Ignored when Search URL is provided.", "items": { "type": "string", "enum": [ "URBAN", "TILED_STOVE", "ELECTRICAL", "OTHER", "GAS", "BOILER_ROOM" ], "enumTitles": [ "Urban gas", "Tile stove", "Electric boiler", "Other", "Gas", "Boiler room" ] } }, "floorNumber": { "title": "Floor", "uniqueItems": true, "type": "array", "description": "Floor position of the property. Ignored when Search URL is provided.", "items": { "type": "string", "enum": [ "CELLAR", "GROUND", "FIRST", "SECOND", "THIRD", "FOURTH", "FIFTH", "SIXTH", "SEVENTH", "EIGHTH", "NINTH", "TENTH", "HIGHER", "ATTIC" ], "enumTitles": [ "Basement", "Ground floor", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "Higher than 10", "Attic" ] } }, "floorsNumberMin": { "title": "Min Building Floors", "minimum": 1, "type": "integer", "description": "Minimum number of floors in the building. Ignored when Search URL is provided." }, "floorsNumberMax": { "title": "Max Building Floors", "minimum": 1, "type": "integer", "description": "Maximum number of floors in the building. Ignored when Search URL is provided." }, "buildYearMin": { "title": "Year Built (From)", "minimum": 1800, "maximum": 2026, "type": "integer", "description": "Minimum construction year. Ignored when Search URL is provided." }, "buildYearMax": { "title": "Year Built (To)", "minimum": 1800, "maximum": 2026, "type": "integer", "description": "Maximum construction year. Ignored when Search URL is provided." }, "extras": { "title": "Extras / Amenities", "uniqueItems": true, "type": "array", "description": "Property amenities (multi-select). Ignored when Search URL is provided.", "items": { "type": "string", "enum": [ "BALCONY", "TERRACE", "GARAGE", "PARKING_SPACE", "GARDEN", "BASEMENT", "SEPARATE_KITCHEN", "LIFT", "TWO_STOREY", "AIR_CONDITIONING", "UTILITY_ROOM", "FURNISHED", "SECURITY", "MONITORING" ], "enumTitles": [ "Balcony", "Terrace", "Garage", "Parking space", "Garden", "Basement", "Separate kitchen", "Elevator", "Two-storey", "Air conditioning", "Utility room", "Furnished", "Security", "Monitoring" ] } }, "daysSinceCreated": { "title": "Listing Age", "enum": [ "", "1", "3", "7", "14", "30" ], "type": "string", "description": "Filter listings by how recently they were posted. Ignored when Search URL is provided.", "default": "" }, "hasPhotos": { "title": "Only with Photos", "type": "boolean", "description": "Only show listings that have photos. Ignored when Search URL is provided.", "default": false }, "isExclusiveOffer": { "title": "Only Exclusive Offers", "type": "boolean", "description": "Only show exclusive offers (private listings). Ignored when Search URL is provided.", "default": false }, "sortBy": { "title": "Sort By", "enum": [ "DEFAULT", "PRICE", "DATE", "AREA" ], "type": "string", "description": "How to sort the results. Ignored when Search URL is provided.", "default": "DEFAULT" }, "sortDirection": { "title": "Sort Direction", "enum": [ "DESC", "ASC" ], "type": "string", "description": "Ascending or descending order. Ignored when Search URL is provided.", "default": "DESC" }, "maxPages": { "title": "Max Pages", "minimum": 0, "type": "integer", "description": "Maximum number of result pages to scrape (0 = unlimited, ~36 listings per page). maxItems takes precedence.", "default": 0 }, "maxItems": { "title": "Max Items", "minimum": 0, "type": "integer", "description": "Maximum number of listings to scrape (0 = unlimited). Takes precedence over maxPages.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for anti-bot protection", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```