Otodom.pl Property Scraper

Pull property listings from Otodom.pl, the largest property portal in Poland (OLX Group). Apartments, houses, plots, commercial, garages, new developments, rooms; sale and rent. Search builder (city + transaction + property type + filters) and URL-paste modes, with auto forward pagination across SERP pages.

Output is one flat JSON record per listing: id, title, price, area, rooms, full address, GPS coordinates, description, agent contact, building year, ownership, market type, and full feature list.

Why This Scraper?

• Polish portal coverage: top-80 cities + all 16 voivodeships recognized by name (Warszawa, Kraków, Wrocław, Gdańsk, Łódź, Sopot, ...). For unknown cities, drop a URL into URL mode.
• 30 fields per listing: SERP fields (price, area, rooms, city, agency, photo) plus detail-page enrichment (lat/lng, description, full feature list, build year, ownership, market type, agent phone).
• Two input modes: structured search (transaction, property type, price/area/rooms ranges, market type, sort) or paste any otodom.pl URL refined in your browser.
• Forward pagination by default: configurable maxPages per search; per-search budget cap so multi-city searches return balanced results.
• HTTP-only: no headless browser. ~80 MB peak memory, ~36 listings/page.
• Resilient session management: automatic 3-tier proxy preflight (chosen proxy → default Apify proxy → no proxy), so free-tier accounts get a graceful fallback instead of a hard fail.

Data You Get

Sample shape, values are illustrative placeholders, not from a live listing.

Field	Example
id	"00000001"
url	"https://www.otodom.pl/pl/oferta/sample-listing-ID00000"
title	"Sample Apartment Title"
transaction	"sprzedaz"
estate	"mieszkanie"
priceTotal	750000
priceCurrency	"PLN"
pricePerSquareMeter	15000
rentPrice	null
rentAdditional	null
deposit	null
areaInSquareMeters	50.0
rooms	2
floor	"3"
buildingFloors	5
buildYear	2010
marketType	"secondary"
ownership	"full_ownership"
buildingType	"block"
buildingMaterial	"concrete"
heating	"urban"
windowsType	"plastic"
city	"Warszawa"
province	"mazowieckie"
district	"Mokotów"
street	"ul. Sample"
postalCode	"00-000"
latitude	52.0000
longitude	21.0000
agencyName	"Sample Agency"
advertiserType	"agency"
contactName	"Agent Name"
phone	"+48000000000"
contactDetails	full upstream ad.contactDetails block (verbatim — includes email, all phones, types)
agency	full upstream ad.agency block (verbatim — id, address, license, slug, branding)
owner	full upstream ad.owner block (verbatim — id, profile URL, role)
referenceId	"REF-0001"
description	"Full seller description text appears here when fetchDetails=true."
features	["meble", "balkon", "winda"]
isPromoted	false
isExclusive	false
isPrivateOwner	false
imageCount	12
imageUrl	"https://ireland.apollo.olxcdn.com/v1/files/000000000-OTODOM/image"
dateCreated	"2026-01-01T00:00:00.000Z"
investmentEstimatedDelivery	null
scrapedAt	"2026-04-28T00:00:00.000Z"

How to Use

Search mode, basic Warsaw apartments for sale

{
  "mode": "search",
  "transaction": "sprzedaz",
  "estate": "mieszkanie",
  "locations": ["Warszawa"],
  "maxPages": 3,
  "maxListings": 50,
  "fetchDetails": true,
  "proxy": { "useApifyProxy": true }
}

Search mode, rentals in three cities, filtered

{
  "mode": "search",
  "transaction": "wynajem",
  "estate": "mieszkanie",
  "locations": ["Warszawa", "Krakow", "Wroclaw"],
  "minPrice": 2000,
  "maxPrice": 4500,
  "minRooms": 2,
  "maxRooms": 3,
  "sortBy": "PRICE_ASC",
  "maxPages": 2,
  "maxListings": 60,
  "fetchDetails": true,
  "proxy": { "useApifyProxy": true }
}

Search mode, new developments only (primary market)

{
  "mode": "search",
  "transaction": "sprzedaz",
  "estate": "mieszkanie",
  "locations": ["Warszawa"],
  "marketType": "primary",
  "maxPages": 2,
  "maxListings": 30,
  "fetchDetails": true,
  "proxy": { "useApifyProxy": true }
}

URL mode, paste any otodom.pl search URL

{
  "mode": "url",
  "urls": [
    "https://www.otodom.pl/pl/wyniki/sprzedaz/mieszkanie/mazowieckie/warszawa/warszawa/warszawa/mokotow",
    "https://www.otodom.pl/pl/wyniki/wynajem/dom/malopolskie/krakow/krakow/krakow"
  ],
  "maxPages": 5,
  "maxListings": 100,
  "fetchDetails": true,
  "proxy": { "useApifyProxy": true }
}

URL mode is the recommended path when you need filters not exposed above (district, neighborhood, building type), or for cities outside the built-in lookup table. Open Otodom.pl, refine your search in the browser, copy the URL.

Input Parameters

Parameter	Type	Default	Description
mode	string	"search"	"search" (use filters below) or "url" (paste URLs)
transaction	string	"sprzedaz"	"sprzedaz" (sale) or "wynajem" (rent)
estate	string	"mieszkanie"	mieszkanie, dom, dzialka, lokal, garaz, inwestycja, pokoj
locations	string[]	["Warszawa"]	Polish city names (built-in lookup for top 80 cities + 16 voivodeships)
marketType	string	"all"	all, primary (rynek pierwotny), secondary (rynek wtórny)
minPrice, maxPrice	integer	none	PLN range on totalPrice
minArea, maxArea	integer	none	m² range on areaInSquareMeters
minRooms, maxRooms	integer	none	Room count range, 1 to 10
sortBy	string	"DEFAULT"	DEFAULT, LATEST, PRICE_ASC, PRICE_DESC, AREA_ASC, AREA_DESC
urls	string[]	example	Full otodom.pl URLs (URL mode only)
maxPages	integer	3	Pages to walk per search (each page ~36 listings)
maxListings	integer	0	Stop after N total. 0 = no cap
fetchDetails	boolean	true	Fetch detail page for GPS, description, agent phone, features
proxy	object	datacenter	Apify proxy config

Output Example

Sample shape, values are illustrative placeholders, not from a live listing.

{
  "id": "00000001",
  "url": "https://www.otodom.pl/pl/oferta/sample-listing-ID00000",
  "title": "Sample Apartment Title",
  "transaction": "sprzedaz",
  "estate": "mieszkanie",
  "priceTotal": 750000,
  "priceCurrency": "PLN",
  "pricePerSquareMeter": 15000,
  "rentPrice": null,
  "rentAdditional": null,
  "deposit": null,
  "areaInSquareMeters": 50.0,
  "rooms": 2,
  "floor": "3",
  "buildingFloors": 5,
  "buildYear": 2010,
  "marketType": "secondary",
  "ownership": "full_ownership",
  "buildingType": "block",
  "buildingMaterial": "concrete",
  "heating": "urban",
  "windowsType": "plastic",
  "city": "Warszawa",
  "province": "mazowieckie",
  "district": "Mokotów",
  "street": "ul. Sample",
  "postalCode": "00-000",
  "latitude": 52.0000,
  "longitude": 21.0000,
  "agencyName": "Sample Agency",
  "advertiserType": "agency",
  "contactName": "Agent Name",
  "phone": "+48000000000",
  "referenceId": "REF-0001",
  "description": "Full seller description text appears here when fetchDetails=true.",
  "features": ["meble", "balkon", "winda"],
  "isPromoted": false,
  "isExclusive": false,
  "isPrivateOwner": false,
  "imageCount": 12,
  "imageUrl": "https://ireland.apollo.olxcdn.com/v1/files/000000000-OTODOM/image",
  "dateCreated": "2026-01-01T00:00:00.000Z",
  "investmentEstimatedDelivery": null,
  "scrapedAt": "2026-04-28T00:00:00.000Z"
}

Plan Requirement

• Default proxy is Apify residential with country=PL. Gives clean first-try fetches and the fastest end-to-end wall time.
• Bring your own proxy URLs: paste them into the proxy field instead. Make sure they reach Poland for stable routing.
• fetchDetails ON: roughly 1 extra HTTP request per listing. Latitude / longitude, full description, agent phone, build year, and the full feature list only appear on the detail page; turn it OFF only if you do not need any of these.