Portugal Property Listings Database — Imovirtual Scraper

Scrapes property listings from Imovirtual, Portugal's largest real estate marketplace. Returns pricing, typology, location, energy certificate, and agent contact details for apartments, houses, land, garages, warehouses, commercial units, and room rentals — sale and rent, nationwide.

---

Imovirtual Scraper Features

• Covers the full national matrix — every deal type (comprar/sale, arrendar/rent) across seven property categories, not just one search URL
• Returns Portugal-native fields: T-typology (T0, T1, T2…), área útil, distrito/concelho/freguesia, and the A+ through F energy certificate scale
• Extracts agent and agency contact details, including phone numbers, where the listing exposes them
• Pulls GPS coordinates, construction year, floor, and condition on top of the standard price and area fields
• Filterable by deal type and property type, so a run can target just rentals in one category instead of the whole country
• Handles pagination across thousands of result pages per category automatically — you point it at Portugal, not at page 1

---

Who Uses Imovirtual Property Data?

• Cross-border property investors — screen the Portuguese market by district and price band before ever booking a flight
• Short-let and rental underwriters — compare asking rents against the sale-price data from the same run, or build a yield model from both sides of the market
• Price-index builders — track price-per-square-metre trends by typology and distrito over time
• Relocation and golden-visa advisors — pull current inventory for clients instead of screenshotting a search page
• Market researchers — measure inventory mix (new build vs. existing, agency vs. private) across regions

---

How Imovirtual Scraper Works

1. Pick your deal types (sale, rent, or both) and property types — or leave the defaults to cover everything Imovirtual lists.
2. The scraper walks every matching category nationwide, page by page, and visits each listing it finds for the fields a search results page doesn't show.
3. Records stream into the dataset as they're collected, so a large run is usable before it finishes.
4. Hit your item cap or a spend limit mid-crawl? Resume it later without paying twice for what you already have — see below.

---

Input

{
  "maxItems": 500,
  "dealTypes": ["comprar", "arrendar"],
  "propertyTypes": ["apartamento", "moradia"]
}

Field	Type	Default	Description
maxItems	Integer	10	Maximum number of listings to scrape. 0 runs the full national matrix — roughly 220,000+ listings across all categories.
dealTypes	Array	["comprar", "arrendar"]	Sale (comprar), rent (arrendar), or both.
propertyTypes	Array	["apartamento", "moradia", "terreno", "garagem", "armazem", "comercial", "quarto"]	Which of Imovirtual's own property categories to crawl. comercial covers offices, shops and other commercial space as one bucket — Imovirtual doesn't expose a machine-readable subtype split for those. quarto (room rentals) only applies when arrendar is selected.
resumeCursor	String	—	Cursor from a previous run's Output. Leave empty for a fresh crawl.

Narrowing to one or two categories is a lot faster than the full default — a run scoped to arrendar + garagem, for instance, covers a few thousand listings instead of the full corpus.

---

Imovirtual Scraper Output Fields

{
  "listing_id": "19083651",
  "listing_url": "https://www.imovirtual.com/pt/anuncio/maravilhoso-t3-parque-das-nacoes-ID1i4vP",
  "title": "Maravilhoso T3 | Parque das Nações",
  "deal_type": "comprar",
  "property_type": "apartamento",
  "price_eur": 1595000,
  "price_raw": "1 595 000 €",
  "price_period": "sale",
  "price_per_sqm_eur": 8055.56,
  "typology": "T2",
  "rooms": 3,
  "bathrooms": 2,
  "area_useful_sqm": 198,
  "area_gross_sqm": 198,
  "land_area_sqm": null,
  "floor": "3º andar (de 5)",
  "has_elevator": true,
  "energy_certificate": "B",
  "condition": "usado",
  "construction_year": 1988,
  "district": "Lisboa",
  "municipality": "Lisboa",
  "parish": "Parque das Nações",
  "address": "Rua das Musas - Expo",
  "latitude": 38.768,
  "longitude": -9.094,
  "features": ["ar condicionado", "varanda", "elevador"],
  "description": "Apartamento T3 com vista rio, totalmente remodelado...",
  "advertiser_type": "agency",
  "agency_name": "ZÉNITE IMOVEIS",
  "agency_id": "5199464",
  "agency_url": "https://www.imovirtual.com/pt/empresas/agencias-imobiliarias/zenite-imoveis-ID5199464",
  "agent_name": "Nuno Silveira",
  "agent_phone": "+351937594409",
  "is_exclusive": false,
  "is_promoted": true,
  "image_urls": ["https://..."],
  "images_count": 12,
  "created_at": "2026-03-19T10:56:34Z",
  "pushed_up_at": "2026-10-01T20:00:34+01:00",
  "scraped_at": "2026-10-01T19:33:22.753Z"
}

Field	Type	Description
listing_id	String	Imovirtual's own ad ID
listing_url	String	Direct link to the listing
title	String	Listing headline
deal_type	String	comprar (sale) or arrendar (rent)
property_type	String	apartamento, moradia, terreno, garagem, armazem, comercial, or quarto
price_eur	Number	Asking price (or monthly rent) in EUR
price_raw	String	Formatted price as shown on the listing
price_period	String	sale or month
price_per_sqm_eur	Number	Price per square metre — sale listings only
typology	String	Portuguese T-typology (T0 = studio, T1, T2…)
rooms	Number	Total divisions (assoalhadas)
bathrooms	Number	Bathroom count
area_useful_sqm	Number	Área útil in square metres
area_gross_sqm	Number	Área bruta in square metres
land_area_sqm	Number	Plot/land area — terreno listings only
floor	String	Floor, in Portuguese (e.g. "3º andar (de 5)", "Rés-do-chão")
has_elevator	Boolean	Whether the building has a lift
energy_certificate	String	A+ through F, or "Isento" (exempt)
condition	String	novo, usado, em construção, or para recuperar
construction_year	Number	Year built, where disclosed
district	String	Distrito
municipality	String	Concelho
parish	String	Freguesia
address	String	Street-level address, where disclosed
latitude	Number	GPS latitude
longitude	Number	GPS longitude
features	Array	Amenities in Portuguese (varanda, garagem, piscina, ar condicionado…)
description	String	Full listing description, as plain text
advertiser_type	String	private, agency, or developer
agency_name	String	Listing agency's name, where applicable
agency_id	String	Imovirtual's agency ID
agency_url	String	Link to the agency's storefront
agent_name	String	Named contact on the listing
agent_phone	String	Contact phone number, where disclosed
is_exclusive	Boolean	Flagged as an exclusive listing
is_promoted	Boolean	Flagged as promoted/featured
image_urls	Array	Full-size photo URLs
images_count	Number	Number of photos on the listing
created_at	String	When the listing was first published
pushed_up_at	String	Last time the seller refreshed the listing's ranking
scraped_at	String	When this record was collected

---

Resuming a large crawl

Every run emits a resumeCursor in its Output. If a large crawl stops before it finishes — because it hit maxItems, your spend cap (maxTotalChargeUsd), or was aborted — start a new run with the same input plus that resumeCursor to continue from where it left off. The crawl resumes from the queued work the previous run didn't reach.

• You are not re-charged for records the earlier run already delivered.
• Resume within your account's run-retention window — on the free tier, roughly your 10 most recent runs. Once the source run is pruned, its resumeCursor is no longer valid.
• resumeCursor is opaque — supply it unmodified.

---

FAQ

How do I scrape Imovirtual property listings?

Imovirtual Scraper needs no account, login, or API key. Set maxItems and your deal/property type filters, run it, and listings stream into your dataset as they're found.

What data can I get from Imovirtual?

Pricing, typology, area, energy certificate, location down to the freguesia, GPS coordinates, and agent contact details — 38 fields per listing, covering both the sale and rental markets.

Can I filter by deal type or property type?

Yes. Set dealTypes to ["comprar"] or ["arrendar"], and propertyTypes to any combination of apartamento, moradia, terreno, garagem, armazem, comercial, or quarto. Narrow runs finish faster — the default covers everything.

How much does Imovirtual Scraper cost to run?

Pricing follows the pay-per-event model shown on this page, charged per record saved. There's no separate charge for pages visited to find those records.

Does this cover rentals as well as sales?

Both. comprar is the sale market, arrendar is rentals — including room rentals (quarto), which don't exist on the sale side.

---

Need More Features?

Need custom fields, filters, or a different target site? File an issue or get in touch.

Why Use Imovirtual Scraper?

• National coverage — walks every deal type and property category Imovirtual publishes, not a single search URL
• Portugal-native schema — T-typology, área útil, distrito/concelho/freguesia, and the real energy certificate scale, instead of a generic listing record translated badly
• Resumable — a crawl that stops partway picks back up without re-billing records you already have