Otodom.pl Scraper

Overview

Extract public Otodom.pl listing pages. This is a standalone Apify Actor for Otodom.pl with its own input schema, source adapter, dataset, run summary, diagnostics, and output files.

Features

• Extracts publicly visible listing fields and structured page data.
• Opens detail pages when available to enrich title, price, address, features, media, and facts.
• Deduplicates records by source listing URL or identifier.
• Emits only source-backed live records with dataOrigin: "live-page".
• Omits unknown values instead of inventing them or inserting JSON null values.
• Saves per-run status and access-block diagnostics in storage/key_value_stores/default.

Default source URL

https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/cala-polska

Input

Field	Type	Default	Description
startUrls	array	source default	Public search, listing, or detail URLs for this portal.
maxItemsPerActor	integer	10	Maximum detailed records.
maxPagesPerActor	integer	2	Maximum list/search pages.
includeDetails	boolean	true	Enrich records from detail pages.
includeRawData	boolean	true	Keep selected structured source data.
proxyEnabled	boolean	false	Use an authorized Apify or user-supplied proxy.
maxRequestRetries	integer	3	Bounded retry/backoff for transient failures.

Sample live output

{
    "actorName": "otodom-scraper",
    "sourcePortal": "Otodom.pl",
    "recordType": "property",
    "listingId": "2-pokojowe-mieszkanie-53m2-loggia-bezposrednio-ID4z4Qx",
    "listingUrl": "https://www.otodom.pl/pl/oferta/2-pokojowe-mieszkanie-53m2-loggia-bezposrednio-ID4z4Qx",
    "title": "2-pokojowe mieszkanie 53m2 + loggia Bezpośrednio",
    "description": "<ul><li>2-pokojowe mieszkanie<strong> numer AB.01.03</strong> na 1. piętrze w Inwestycji Ptasia Vita Dewelopera DEVELIA</li><li>Reprezentacyjny hol wejściowy z dużymi przeszkleniami</li><li>System zagospodarowania wody deszczowej, panele fotowoltaiczne</li><li>Tuż obok Lasku Marcelińskiego</li><li>Przystanek autobusowy (10 min pieszo), przystanek tramwajowy (15 min pieszo)</li><li>Centrum Poznania (13 min samochodem), Port Lotniczy Poznań-Ławica (7 min samochodem)</li><li>CH King Cross Marcelin (5 min samochodem)</li></ul><br/><strong>Ptasia Vita - poznaj inwestycję</strong><br/><p><strong>Ptasia Vita – komfort życia tuż przy Lasku Marcelińskim</strong></p><p>Ptasia Vita to kameralna inwestycja mieszkaniowa na poznańskim Grunwaldzie, położona bezpośrednio przy Lasku Marcelińskim. To miejsce dla osób, które chcą korzystać z miejskich udogodnień, a jednocześnie mieć naturę i tereny rekreacyjne dosłownie na wyciągnięcie ręki. W sześciopiętrowym budynku powstanie 116 mieszkań od 1 do 4 pokoi, o powierzchni od 29 do 124 m².</p><p><strong>Atuty inwestycji:</strong></p><ul><li>Tuż przy Lasku Marcelińskim – codzienny dostęp do zieleni, spacerów i aktywnego wypoczynku</li><li>116 mieszkań od 1 do 4 pokoi – przestrzeń dopasowana do różnych potrzeb</li><li>Balkon, loggia, taras lub ogródek – własne miejsce na świeżym powietrzu</li><li>Blisko miejskich udogodnień – sklepy, szkoły, przedszkola i usługi w okolicy</li><li>Wygodny dojazd – tramwaj w zasięgu ok. 10 minut spacerem</li><li>Aktywnie blisko domu – korty tenisowe Olimpii i ścieżki rekreacyjne w pobliżu</li><li>Blisko lotniska – szybki dojazd do Portu Lotniczego Poznań-Ławica</li><li>Nowoczesne i ekologiczne rozwiązania – panele fotowoltaiczne i system zagospodarowania wody deszczowej</li><li>Wygoda mieszkańców – garaż, boksy, komórki lokatorskie i rowerownia</li></ul><p><strong>Termin realizacji:</strong></p><p>IV kwartał 2027 r.</p><p><strong>Biuro sprzedaży </strong><strong>Ptasia Vita</strong></p><p>Mieczysława Niedziałkowskiego 11, 61-578, Poznań</p><p>Pon.–Pt.:&nbsp;10:00-18:00</p><br/><strong>Ptasia Vita - lokalizacja</strong><br/><br/>Grunwald, ul. Ptasia<br/><ul><li>5,5 km do centrum</li><li>10 min. spacerem do przystanku autobusowego</li><li>9 min. samochodem do przystanku tramwajowego</li><li>dojazd do centrum: 24 min samochodem</li></ul>Istotne punkty w okolicy inwestycji<ul><li>Przystanek autobusowy (717 m, 10 minut spacerem)</li></ul><br/>",
    "listingType": "sale",
    "propertyType": "apartment",
    "address": {
        "full": "ul. Ptasia",
        "street": "ul. Ptasia",
        "locality": "Poznań",
        "region": "wielkopolskie",
        "country": "Polska",
        "latitude": 52.402157,
        "longitude": 16.85464
    },
    "features": {
        "area": {
            "display": "Z chęcią dowiem się więcej na temat tego mieszkania na sprzedaż. Proszę o kontakt.",
            "value": 0
        }
    },
    "photos": [
        "https://ireland.apollo.olxcdn.com/v1/files/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmbiI6InV0M251eWlhaWE3ejItRUNPU1lTVEVNIiwidyI6W3siZm4iOiJlbnZmcXFlMWF5NGsxLUFQTCIsInMiOiIxNiIsImEiOiIwIiwicCI6IjEwLC0xMCJ9XX0.GVLbcHG2X-0am0QGUc-JhIu4kHglU-7gah9VFsWyBxM/image;s=2048x1536;q=80"
    ],
    "facts": [
        {
            "@type": "PropertyValue",
            "name": "Powierzchnia",
            "value": "53.46 m²"
        },
        {
            "@type": "PropertyValue",
            "name": "Liczba pokoi",
            "value": "2 "
        },
        {
            "@type": "PropertyValue",
            "name": "Ogrzewanie",
            "value": "miejskie"
        },
        {
            "@type": "PropertyValue",
            "name": "Piętro",
            "value": "1/6"
        },
        {
            "@type": "PropertyValue",
            "name": "Stan wykończenia",
            "value": "do wykończenia"
        },
        {
            "@type": "PropertyValue",
            "name": "Rynek",
            "value": "pierwotny"
        },
        {
            "@type": "PropertyValue",
            "name": "Forma własności",
            "value": "pełna własność"
        },
        {
            "@type": "PropertyValue",
            "name": "Dostępne od",
            "value": "2027-11-25"
        },
        {
            "@type": "PropertyValue",
            "name": "Typ ogłoszeniodawcy",
            "value": "deweloper"
        },
        {
            "@type": "PropertyValue",
            "name": "Informacje dodatkowe",
            "value": "garaż/miejsce parkingowe,  winda"
        },
        {
            "@type": "PropertyValue",
            "name": "Rok budowy",
            "value": "2027"
        },
        {
            "@type": "PropertyValue",
            "name": "Winda",
            "value": "tak"
        },
        {
            "@type": "PropertyValue",
            "name": "Rodzaj zabudowy",
            "value": "blok"
        },
        {
            "@type": "PropertyValue",
            "name": "Zabezpieczenia",
            "value": "domofon / wideofon"
        }
    ],
    "missingFields": [
        "price",
        "bedrooms",
        "bathrooms",
        "agent",
        "amenities"
    ],
    "scrapedAt": "2026-09-10T13:11:44.331Z",
    "dataOrigin": "live-page"
}

Local development

Run this folder as its own Actor:

$apify run --input-file storage/key_value_stores/default/INPUT.json

Validate the Actor contract and stored live records:

apify validate-schema
node dataset-validator.js

Access and compliance

If the source portal returns a challenge or access denial, the Actor records diagnostics and omits that page rather than fabricating output. Use only public pages and an authorized purpose. Proxy access can incur account costs and does not authorize bypassing CAPTCHA, authentication, robots directives, or other access controls.

Output files

• .actor: Actor metadata and schemas.
• src: This portal's standalone adapter and shared extraction runtime.
• storage/datasets/default: Apify-style local result records.
• storage/key_value_stores/default/RUN_SUMMARY.json: run result and diagnostics summary.
• output/dataset.json and output/dataset.jsonl: exported live-only result files.