OLX-Group Real-Estate Scraper (PL/PT)

Collect property listings from two European portals in one Actor: Otodom (otodom.pl, Poland: mieszkania and domy for sale or rent, sprzedaż / wynajem) and Imovirtual (imovirtual.com, Portugal: apartamentos and moradias to buy or rent, comprar / arrendar). Each row has the asking price and currency (PLN or EUR), area in m², rooms, bedrooms, bathrooms, address, photos and the listing link, in the same format for both countries. Built for investors, agents, relocation services and housing-market researchers.

What you can do with it

• Price per m² research: compare asking prices for flats in Poland or in Lisbon by area and room count.
• Rent vs. buy comparisons: run the same search for sale and for rent and estimate gross yields.
• Cross-country datasets: stack Polish and Portuguese listings in one table; the fields are identical, and country and currency tell them apart.
• Inventory monitoring: schedule a search and track new and removed listings by listingKey.

Quick start

The Console form is prefilled with flats for sale across Poland, one page. An empty input ({}) does the same. Written out:

{"country": "PL", "operation": "buy", "propertyType": "apartments", "maxResults": 10}

Apartments for rent in Lisbon, three pages:

{"country": "PT", "operation": "rent", "propertyType": "apartments", "location": "lisboa", "maxPages": 3, "maxResults": 100}

Houses for sale in the Mazowieckie region (Warsaw area):

{"country": "PL", "operation": "buy", "propertyType": "houses", "location": "mazowieckie", "maxPages": 2, "maxResults": 60}

Input

Name	Type	Default	What it does
country	string	PL	PL (Otodom, prices in PLN) or PT (Imovirtual, prices in EUR).
operation	string	buy	buy (sale) or rent.
propertyType	string	apartments	apartments (flats) or houses.
location	string	empty	Poland: cala-polska (whole country, the default) or mazowieckie. Portugal: lisboa (the default). Other values are rejected before any search.
maxPages	integer	1	Result pages to read, 1 to 5.
maxResults	integer	50	Maximum listings, 1 to 200.
requestDelaySecs	number	1.0	Pause between pages, 0.5 to 10 seconds.

Output example

One row per listing. Illustrative Otodom record from the Actor's test data (the values show the format, not a current listing; collectedAt is an example time):

{
  "id": "4dQ000",
  "listingKey": "otodom.pl:4dQ000",
  "url": "https://www.otodom.pl/pl/oferta/mieszkanie-2-pokojowe-warszawa-ID4dQ000",
  "name": "Mieszkanie 2-pokojowe, 45 m², Warszawa",
  "price": 600000.0,
  "currency": "PLN",
  "areaM2": 45.0,
  "rooms": 2,
  "bedrooms": 1,
  "bathrooms": 1,
  "address": "ul. Przykładowa 1, Warszawa, mazowieckie, 00-001",
  "imageUrl": "https://ireland.apollo.olxcdn.com/v1/files/otodom0/image;s=1000x700",
  "images": ["https://ireland.apollo.olxcdn.com/v1/files/otodom0/image;s=1000x700"],
  "operation": "buy",
  "propertyType": "apartments",
  "location": "cala-polska",
  "portal": "otodom",
  "country": "PL",
  "source": "otodom.pl",
  "collectedAt": "2026-10-01T12:00:00+00:00"
}

• price and currency are the asking price (or monthly rent) as advertised; nothing is converted.
• rooms is the room count the portal shows (pokoje, assoalhadas); bedrooms and bathrooms are filled when given.
• listingKey is the portal plus its listing ID. Join and deduplicate on listingKey, not the bare id.

Fields a listing does not show are null. Download the dataset as JSON, CSV, Excel, XML or HTML, or read it through the Apify API.

Pricing

Pay per result:

• $0.0006 per listing delivered.
• $0.00005 per run start. The start event is charged per GB of memory; the default 512 MB run is one start event.

Worked costs: 50 listings cost about $0.03; the 200-listing maximum about $0.12. Only delivered listings are charged.

FAQ

Which areas are supported? All of Poland or the Mazowieckie region on Otodom, and Lisbon on Imovirtual. Filter the address field for a city within those areas.

How many listings can I get? Up to 5 pages and 200 listings per run.

How fresh is the data? Each run reads the listings online at that moment.

Can I collect rentals? Yes. Set operation to rent.

What happens if a page cannot be read? Temporary problems are retried. If a page stays unavailable, the run fails with a status message that explains why, and no listings from that run are delivered or charged. Keep maxPages small for frequent scheduled runs.

Are other OLX Group sites covered? No, only Otodom (Poland) and Imovirtual (Portugal).

Limits

Collects what the search results show; it does not open each listing for descriptions, floor, year built or agent contacts. Prices are asking prices.

For help, use the Actor's Issues tab and include the run ID.