Imovirtual Scraper - Portugal Real Estate Listings avatar

Imovirtual Scraper - Portugal Real Estate Listings

Pricing

from $2.00 / 1,000 result scrapeds

Go to Apify Store
Imovirtual Scraper - Portugal Real Estate Listings

Imovirtual Scraper - Portugal Real Estate Listings

Scrape property listings from Imovirtual.com, Portugal's leading real estate portal. Extract prices, locations, areas, rooms, images, and agency details for apartments, houses, rooms, land, and commercial properties for sale or rent. No login or cookies required.

Pricing

from $2.00 / 1,000 result scrapeds

Rating

0.0

(0)

Developer

Studio Amba

Studio Amba

Maintained by Community

Actor stats

0

Bookmarked

1

Total users

0

Monthly active users

9 days ago

Last modified

Categories

Features

Limited permissions

Share

Imovirtual Scraper — Portugal Real Estate Listings

Scrape property listings from Imovirtual.com, Portugal's leading real estate portal (part of the OLX Group). Search apartments, houses, rooms, land, garages, and commercial properties for sale or rent, and get clean structured JSON with prices, areas, rooms, locations, photos, and agency details.

No login, no cookies, no API keys required.

What does this actor do?

You give it a Portuguese location (any district, city, parish, or neighborhood), a transaction type (buy or rent), and a property type. It searches Imovirtual and returns every matching listing as a flat JSON object, up to the limit you set.

It reads the same data the Imovirtual website itself renders, so you get exactly what a visitor sees: asking price, price per square meter, living area, number of rooms, floor, full location hierarchy, publication date, photos, and whether the seller is an agency or a private owner.

Why use it?

  • Market research — track asking prices per city, parish, or neighborhood over time.
  • Investment analysis — compare price per m² across regions before buying.
  • Lead generation — find new listings from private owners or specific agencies the moment they appear.
  • Portfolio monitoring — agencies can watch competitor listings and pricing in their area.
  • Data science — build datasets of the Portuguese housing market for modeling and dashboards.

Input options

FieldTypeDefaultDescription
locationstringlisboaDistrict, city, parish, or neighborhood. Free text like vila nova de gaia or cascais is resolved automatically. todo-o-pais (or portugal) is the whole country.
transactionstringcomprarcomprar (buy) or arrendar (rent).
propertyTypestringapartamentoOne of apartamento, moradia, quarto, terreno, garagem, imoveis-comerciais, armazens, empreendimento, or todos for every type in one run.
priceMininteger—Minimum price in EUR (monthly rent for arrendar).
priceMaxinteger—Maximum price in EUR (monthly rent for arrendar).
maxResultsinteger50Maximum number of listings to return.
trackChangesbooleanfalseSave only listings that are new, changed or removed since the previous run of the same search. See "Track changes between runs".
trackingKeystringfrom the filtersName of the tracked search. Runs with the same name compare against each other.
includeUnchangedbooleanfalseWith trackChanges, also save listings that did not change.
proxyConfigurationobjectPT residentialApify proxy settings. Portuguese residential proxies recommended.

Example input

{
"location": "porto",
"transaction": "comprar",
"propertyType": "apartamento",
"priceMax": 300000,
"maxResults": 100
}

Output fields

FieldTypeExample
listingIdinteger19205349
listingTitlestring"Apartamento T1 para venda"
transactionTypestring"sale"
propertyTypestring"apartment"
pricenumber420000
currencystring"EUR"
pricePerSqmnumber3595.9
areaM2number76
roomsinteger2
floorinteger5 (0 = ground floor)
streetstring"Praça São Francisco de Assis"
citystring"Carnide"
provincestring"Lisboa"
locationFullstring"Telheiras, Carnide, Lisboa, Lisboa"
agencyNamestring"Remax Ideal Mor"
isPrivateOwnerbooleanfalse
summarystringShort listing description
imageUrlstringMain photo URL
imageUrlsarrayAll photo URLs
datePublishedstring"2026-07-09 23:10:51"
urlstringFull listing URL
scrapedAtstringISO timestamp
changeTypestringOnly with trackChanges: new, price_changed, updated, removed or unchanged
previousPricenumberOnly with trackChanges: price in the previous run
priceChangenumberOnly with trackChanges: new price minus previous price
changedFieldsarrayOnly with trackChanges: fields that changed, for example ["price", "areaM2"]
firstSeenAtstringOnly with trackChanges: when the tracked search first saw the listing
lastSeenAtstringOnly with trackChanges: when the tracked search last saw the listing
removedAtstringOnly with trackChanges: when the listing was found missing (removed rows)

Example output

{
"listingId": 19205349,
"listingTitle": "Apartamento T1 para venda",
"transactionType": "sale",
"propertyType": "apartment",
"price": 420000,
"currency": "EUR",
"pricePerSqm": 359.59,
"areaM2": 76,
"rooms": 2,
"floor": 5,
"street": "Praça São Francisco de Assis",
"city": "Carnide",
"province": "Lisboa",
"locationFull": "Telheiras, Carnide, Lisboa, Lisboa",
"agencyName": "Remax Ideal Mor",
"isPrivateOwner": false,
"summary": "Apartamento T1 com varanda em Telheiras...",
"imageUrl": "https://ireland.apollo.olxcdn.com/v1/files/...",
"imageUrls": ["https://ireland.apollo.olxcdn.com/v1/files/..."],
"datePublished": "2026-07-09 23:10:51",
"url": "https://www.imovirtual.com/pt/anuncio/apartamento-t1-para-venda-ID1iAbH",
"scrapedAt": "2026-07-10T09:00:00.000Z"
}

Track changes between runs

For now change tracking works on searches of up to 20,000 listings. A larger search stops at the start, without charging for listings. Narrow it by location, property type or sale/rent.

Turn on trackChanges when you run the same search on a schedule and only want to know what changed. The actor still reads every page of the search, but it only saves the listings that changed since the previous run. You pay per saved listing, so a daily run of a large search costs a fraction of a full export.

The first run with trackChanges saves every listing with changeType: "new". That is your complete starting dataset. Every later run of the same search saves:

  • new for listings that were not there in the previous run.
  • price_changed for listings with a different price. previousPrice and priceChange show the old price and the difference.
  • updated for listings where the title, area, rooms, number of photos, agency or description changed. changedFields lists which ones.
  • removed for listings that are gone from the search. These rows have the listing ID, URL, title, last known price and removedAt. The other fields are empty.

Set includeUnchanged to also save the listings that did not change, with changeType: "unchanged".

Each search keeps its own history. By default the name of the history is made from the filters (transaction, property type, location and price range), so changing a filter starts a new history. Give a trackingKey if you want to choose the name yourself. The history is kept in a key-value store called imovirtual-tracking in your Apify account.

Removed listings are only reported when the run read the whole search. If the run stopped early (Max Results reached, the run's cost limit, or a page that failed), the actor reports no removed listings for that run, keeps the listings it did not see in the history, and says so in the log and the run status. So set Max Results high enough to cover the whole search, for example 300000 for all of Portugal. Max Results counts the listings read, not the listings saved.

Every tracking run ends with a line like Tracking search-5c81c651c71e: 103 read, 1 new, 1 price changes, 0 updated, 1 removed in the log and in the run status.

Example input for a daily run of all apartments for sale in Portugal:

{
"location": "portugal",
"transaction": "comprar",
"propertyType": "apartamento",
"maxResults": 300000,
"trackChanges": true
}

How to scrape Imovirtual data

  1. Open the actor on Apify and click Try for free (or run it via the Apify API).
  2. Set location to any Portuguese place: lisboa, porto, faro, braga, cascais, vila nova de gaia, or even a parish like alvalade. The actor resolves free text to the right Imovirtual location automatically.
  3. Pick the transaction: comprar for sales listings, arrendar for rentals.
  4. Pick a property type: apartments, houses, rooms, land, garages, commercial spaces, warehouses, or new developments.
  5. Optionally set priceMin / priceMax to narrow the price band.
  6. Set maxResults and press Start. Results land in the run's dataset, ready to download as JSON, CSV, or Excel, or to fetch via API.

The actor paginates through search results automatically (72 listings per page) and deduplicates listings by ID, so you get each property once.

Cost estimate

The actor uses plain HTTP requests (no browser), so it is fast and cheap to run. One search page returns up to 72 listings in a single request. It charges $0.02 per run (start fee, based on its 4 GB memory allocation) plus $0.002 per result scraped. 1,000 results costs about $2.02. A run's usage cost only settles after it reports SUCCEEDED.

Limitations and known issues

  • The actor scrapes search result cards. They contain price, area, rooms, floor, location, photos, and agency, but not the full listing description or the advertiser's phone number.
  • Listings with a hidden price (hidePrice) return price: null on purpose.
  • floor uses numbers: 0 is the ground floor (rés-do-chão), -1 a basement, 99 an attic.
  • Imovirtual serves Portuguese property data only. For Polish real estate from the same OLX platform family, see our Otodom scraper.
  • Very broad searches (all of Portugal, no filters) can match tens of thousands of listings — use maxResults to keep runs fast.

FAQ

Do I need an Imovirtual account? No. The actor reads public search results only.

Which locations are supported? Anything Imovirtual knows: districts (Lisboa, Porto, Faro...), councils, parishes, and neighborhoods. Free text is resolved through Imovirtual's own location autocomplete, so accents and spacing don't matter.

Can I get rental prices? Yes. Set transaction to arrendar and price becomes the monthly rent in EUR.

Is this legal? The actor only collects publicly available listing data, the same information any visitor sees in a browser. You are responsible for how you use the data — respect Imovirtual's terms of service and applicable data protection laws.