Otodom Property Details Scraper

Scrapes detailed property listings from Otodom.pl, Poland's largest real estate platform. Transforms individual listing pages into structured JSON data for analysis, research, or integration into applications.

Overview

This actor is a targeted scraper for extracting comprehensive data from specific property listing URLs on Otodom.pl. It's built for reliability, handling retries and using proxies to avoid blocking. You provide the direct links to listings; it returns clean, structured data for each one.

Key Features

• Focused Data Extraction: Pulls over 30 attributes from a property page (price, location, size, features, etc.).
• Built for Reliability: Includes configurable retry logic and integrated Apify Proxy support to minimize failures and avoid detection.
• Structured Output: Returns data in a consistent JSON format, ready for analysis or database import.
• Simple Configuration: Run by providing a JSON input with your target URLs and settings.

How to Use

Configure the actor using a JSON input object. The core requirement is the urls array containing the full Otodom.pl listing links you want to scrape.

Input/Output

Input Format

The actor accepts a JSON configuration. Here is the structure with explanations:

{
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "SG"
  },
  "urls": [
    "https://www.otodom.pl/pl/oferta/sprzedam-nowe-4-pokojowe-mieszkanie-z-ogodem-i-m-parkingowym-ID4vVwq",
    "https://www.otodom.pl/pl/oferta/sloneczny-nowy-otok-mieszkanie-3-pok-13e-ID4vK20"
  ]
}

Parameters:
* urls (Required): An array of full Otodom.pl property listing URLs.
* max_retries_per_url: Number of retry attempts if a page fetch fails (default is 2).
* proxy: Configuration for using Apify Proxy. Using residential proxies (RESIDENTIAL) and setting the country is recommended to avoid blocks.

Output Format

The results are stored in the actor's dataset. Each item in the dataset is a JSON object representing one scraped property. The output includes fields such as:
* title: The listing title.
* price: The property price.
* location: Full address and district information.
* property_details: Size (square meters), number of rooms, building type, etc.
* description: The full text description.
* agent_info: Contact details for the listing agent or agency.
* url: The source URL of the listing.

For issues or questions, contact the developer via My profile.