Otodom, Storia & Imovirtual Real Estate Scraper (Poland, Romania & Portugal)

Extract structured real estate listings from OLX Group's three flagship European property portals in a single fast, low-memory (128 MB) Actor:

• Poland (otodom.pl) — Apartments, houses, rooms, plots, commercial properties, and garages for sale (sprzedaz) or rent (wynajem).
• Romania (storia.ro) — Residential and commercial real estate across Bucharest, Cluj-Napoca, Timișoara, Iași, and all of Romania (vanzare & inchiriere).
• Portugal (imovirtual.com) — Property listings across Lisbon, Porto, Algarve, Setúbal, and nationwide (comprar & arrendar).

---

Key Features

• Seller Phone Numbers & Lead Generation (phones, primaryPhone) — Automatically extracts direct owner (PRIVATE / FSBO / Bezpośrednio) and agency phone numbers from Next.js property data payloads without requiring a headless browser.
• Exact GPS Coordinates & Full Address Hierarchy — Captures latitude, longitude, province, county, city, district, subdistrict, street, and fullAddress.
• 55+ Normalized Real Estate Fields — Total price, pricePerSqm (price/m²), monthly administrative rentPrice, areaSqm, terrainAreaSqm, rooms, floor, buildingFloors, buildYear, buildingType, constructionStatus, heating, ownership, energyCertificate, floorPlans, 3D virtual tours, high-resolution photos, equipment, extras, and security.
• Direct URLs or Structured Filters — Paste any search URL or individual offer URL from otodom.pl, storia.ro, or imovirtual.com, or build a query using structured filters (country, transactionType, propertyType, locationSlug, priceMin, priceMax, areaMin, areaMax, sellerType, marketType, sortBy).
• Bypass Pagination Caps (splitByPrice) — Automatically bisects large searches by price range when a search exceeds 3,600 listings.
• Cross-Run Price-Drop & Price-Change Tracking (trackPriceChanges) — Automatically tracks historical property prices across runs in otodom-scraper-monitor-state and populates previousPrice, priceDelta, and priceChangePercent whenever an owner or agency lowers or raises the asking price.
• Incremental Deal & Price-Drop Monitoring (onlyNewListings + includePriceDrops) — Remembers previously scraped property IDs so scheduled runs only return newly listed properties and existing properties whose price dropped since the last run.

---

Quick Start Examples

1. Scrape Warsaw Private Owner (FSBO) Apartments on Otodom.pl

{
  "country": "pl",
  "transactionType": "SELL",
  "propertyType": "FLAT",
  "locationSlug": "mazowieckie/warszawa",
  "sellerType": "PRIVATE",
  "sortBy": "LATEST",
  "includeFullDetails": true,
  "maxListings": 100
}

2. Paste Any Otodom.pl, Storia.ro, or Imovirtual.com URLs

{
  "searchUrls": [
    { "url": "https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/malopolskie/krakow" },
    { "url": "https://www.storia.ro/ro/rezultate/vanzare/apartament/bucuresti" },
    { "url": "https://www.imovirtual.com/pt/resultados/comprar/apartamento/lisboa" }
  ],
  "includeFullDetails": true,
  "maxListings": 250
}

3. 15-Minute New Property Alert (Incremental Monitoring)

{
  "country": "pl",
  "transactionType": "SELL",
  "propertyType": "FLAT",
  "locationSlug": "mazowieckie/warszawa",
  "sellerType": "PRIVATE",
  "sortBy": "LATEST",
  "onlyNewListings": true,
  "maxListings": 50
}

---

Sample Output Record

{
  "id": "68598012",
  "slug": "bemowo-47-81-m-ogrodek-64-m-garaz-w-cenie-metro-bezposrednio-ID4DPty",
  "url": "https://www.otodom.pl/pl/oferta/bemowo-47-81-m-ogrodek-64-m-garaz-w-cenie-metro-bezposrednio-ID4DPty",
  "portal": "www.otodom.pl",
  "country": "PL",
  "title": "Bemowo| 47,81 m² | Ogródek 64 m²| Garaż w cenie | Metro | Bezpośrednio",
  "transactionType": "SELL",
  "estateType": "FLAT",
  "marketType": "SECONDARY",
  "price": 974990,
  "currency": "PLN",
  "pricePerSqm": 20393.01,
  "rentPrice": 960,
  "hidePrice": false,
  "areaSqm": 47.81,
  "terrainAreaSqm": null,
  "rooms": 2,
  "floor": 0,
  "floorRaw": "ground_floor",
  "buildingFloors": 4,
  "buildYear": 2017,
  "buildingType": "block",
  "buildingMaterial": null,
  "constructionStatus": "ready_to_use",
  "heating": "urban",
  "ownership": "full_ownership",
  "windowsType": "plastic",
  "energyCertificate": null,
  "availableFrom": "2026-11-04",
  "isPrivateOwner": true,
  "sellerType": "private",
  "sellerId": "10394678",
  "sellerName": "Marcel T",
  "phones": ["+48518031104"],
  "primaryPhone": "+48518031104",
  "agencyId": null,
  "agencyName": null,
  "agencySlug": null,
  "developmentTitle": null,
  "developmentUrl": null,
  "province": "mazowieckie",
  "county": null,
  "city": "Warszawa",
  "district": "Wola",
  "subdistrict": "Ulrychów",
  "street": "ul. Jana Olbrachta",
  "fullAddress": "ul. Jana Olbrachta, Ulrychów, Wola, Warszawa, mazowieckie",
  "latitude": 52.233852,
  "longitude": 20.928814,
  "description": "Na sprzedaż nowoczesne, dwupokojowe mieszkanie o powierzchni 47,81 m²...",
  "thumbnailUrl": "https://ireland.apollo.olxcdn.com/v1/files/.../image;s=314x236;q=80",
  "photos": [
    "https://ireland.apollo.olxcdn.com/v1/files/.../image;s=2048x1536;q=80"
  ],
  "photosCount": 14,
  "floorPlans": [
    "https://ireland.apollo.olxcdn.com/v1/files/.../image"
  ],
  "videoUrl": null,
  "view3dUrl": null,
  "walkaroundUrl": null,
  "equipment": ["furniture", "washing_machine", "dishwasher", "fridge", "stove", "oven"],
  "extras": ["garage", "garden", "air_conditioning", "lift", "terrace"],
  "security": ["entryphone", "monitoring", "closed_area", "anti_burglary_door"],
  "tags": ["SEPARATE_KITCHEN", "PARKING_SPOT", "SECURE_BUILDING"],
  "isPromoted": false,
  "isExclusiveOffer": false,
  "createdAt": "2026-11-03T21:27:28Z",
  "modifiedAt": "2026-11-03T21:38:39Z",
  "scrapedAt": "2026-11-04T06:20:00+00:00"
}