Imovirtual Portugal Rent & Sale Listing Scraper avatar

Imovirtual Portugal Rent & Sale Listing Scraper

Pricing

from $0.49 / 1,000 results

Go to Apify Store
Imovirtual Portugal Rent & Sale Listing Scraper

Imovirtual Portugal Rent & Sale Listing Scraper

Search Imovirtual.com for apartments, houses, land, garages and commercial properties to rent or buy across Portugal, filtered by city, price, area and room count, with agency details, images and location.

Pricing

from $0.49 / 1,000 results

Rating

0.0

(0)

Developer

crawlyth forge

crawlyth forge

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

6 hours ago

Last modified

Features

Limited permissions

Share

Imovirtual is one of Portugal's largest real-estate portals. This actor collects its public rent and sale listings: apartments, houses, land, garages, commercial property, offices, warehouses, rooms and new developments. Build a search from a location and filters, use a keyword, or paste Imovirtual search and listing URLs.

What this actor does

  • Browse rent or sale listings by location and property type without constructing a URL.
  • Search by keyword in listing descriptions, such as piscina, varanda or garagem.
  • Scrape your own Imovirtual URLs: search-result URLs are paginated from page to page, and individual listing URLs produce one record each.
  • Apply the site's own filters for price, area, typology, features, private-owner status, listing age, build year and building floors, plus sort order.
  • Avoid duplicate rows when pages, sponsored placements or multiple URLs overlap.
  • Enrich every listing with its detail page by default: description, bathrooms, energy certificate, construction year, building details, amenities, equipment, GPS coordinates, floor plans and agency contact details.
  • Returns one flat record per listing with prices as numbers, ISO dates, absolute URLs and omit-empty fields.

Input

FieldTypeDefaultDescription
modeselectforRentforRent, forSale, search or byUrl.
propertyTypeselectapartmentany, apartment, house, land, garage, commercial, office, warehouse, room or development.
transactionTypeselectrentrent or sale; used by search mode.
locationtextLisboaCouncil or city, e.g. Porto, faro. Use faro/* for a whole district and a full path for a parish, e.g. lisboa/lisboa/benfica. Empty means all Portugal.
searchQuerytext–Words to find in listing descriptions. Also used by search mode.
minPriceinteger–Minimum monthly rent or total sale price in EUR.
maxPriceinteger–Maximum monthly rent or total sale price in EUR.
minAreainteger–Minimum usable area in m2.
maxAreainteger–Maximum usable area in m2.
roomsmulti-select[]Typologies to include: T0, T1, T2, T3, T4, T5+.
extrasmulti-select[]Features to require: private owner, lift, garage, air conditioning, balcony, terrace, photos, internet, garden, cable TV, separate kitchen.
privateOwnerOnlybooleanfalseKeep only private-owner listings.
daysSinceCreatedselectanyany, 1, 3 or 7 days.
buildYearMininteger–Minimum construction year.
buildYearMaxinteger–Maximum construction year.
floorsNumberMininteger–Minimum number of floors in the building.
floorsNumberMaxinteger–Maximum number of floors in the building.
sortByselectrelevancerelevance, newest, oldest, priceAsc, priceDesc, areaAsc or areaDesc.
listingUrlsstring list[]Imovirtual search or listing URLs for byUrl mode.
includeDetailsbooleantrueOpen each listing page for the full record. Turn off for faster bulk collection.
maxItemsinteger20Maximum number of listings to save, up to 50,000.

Example: apartments for rent in Lisbon under EUR 2,000

{
"mode": "forRent",
"propertyType": "apartment",
"location": "Lisboa",
"maxPrice": 2000,
"rooms": ["T1", "T2"],
"sortBy": "priceAsc",
"maxItems": 100
}

Example: houses for sale in Porto with three or more bedrooms

{
"mode": "forSale",
"propertyType": "house",
"location": "Porto",
"rooms": ["T3", "T4", "T5+"],
"includeDetails": true,
"maxItems": 50
}

Example: keyword search for swimming pools in the Algarve

{
"mode": "search",
"transactionType": "sale",
"propertyType": "house",
"location": "faro",
"searchQuery": "piscina",
"maxItems": 50
}

Example: scrape search and listing URLs directly

{
"mode": "byUrl",
"listingUrls": [
"https://www.imovirtual.com/pt/resultados/arrendar/apartamento/lisboa/lisboa?priceMin=1000&priceMax=1500",
"https://www.imovirtual.com/pt/anuncio/apartamento-t3-em-areeiro-de-126-00-m2-ID1iXZM"
],
"maxItems": 40
}

Output per listing

  • listingId, title, listingUrl
  • propertyType, transactionType, isDevelopment, developmentTitle, developmentUrl
  • price, currency, pricePerSqm, priceType, rentPrice
  • area, terrainArea
  • rooms, bedrooms, typology, floor, floorLabel, bathrooms
  • address, city, council, district, parish, neighborhood, postalCode
  • latitude, longitude
  • energyCertificate, buildYear, buildingFloors, buildingType, constructionStatus, usageLicense, market, availableFrom
  • description
  • features, amenities, equipment, security
  • imageUrls, imageCount, floorPlanUrls, videoUrl, virtualTourUrl
  • agencyName, agencyId, agencyUrl, agencyType, agencyLicenseNumber, agentName, advertiserType, advertiserAddress
  • isPrivateOwner, isPromoted, isExclusiveOffer, isCrossListed, hasVideo, hasVirtualTour, hasFloorPlan
  • dateCreated, firstListedAt, modifiedAt, pushedUpAt
  • sourceUrl, recordType, scrapedAt

Fields a listing does not carry are omitted rather than returned as null or empty.

Use cases

  • Track asking prices and price per square metre across districts, councils and parishes.
  • Shortlist rentals by budget, typology and features before contacting agents.
  • Collect private-owner listings for lead generation.
  • Monitor new listings by listing age and sort order.
  • Compare resale and new-development inventory.
  • Build a repeatable Portugal housing-market dataset for analysis or valuation models.

FAQ

Do I need an account, cookies or an API key? No. The actor reads Imovirtual's public listing pages and detail pages without login.

What is the difference between the modes? forRent and forSale build the search from location, propertyType and the filters. search adds a description keyword and uses transactionType. byUrl ignores the builder fields and scrapes the URLs you provide.

Why are some fields missing on some listings? Imovirtual only publishes what the seller supplied. A listing without an energy certificate has no energyCertificate; a private-owner listing has no agency fields. The actor omits those fields instead of inventing values.

Why does rooms differ from bedrooms? Imovirtual's room count includes the living room, so a Portuguese T2 usually has rooms: 3 and bedrooms: 2. typology gives the familiar T number directly.

How many listings can one search return? The site paginates 36 listings at a time and exposes thousands of pages in broad searches. The actor keeps paging until maxItems is reached or the search is exhausted, and removes duplicate listings across pages and URLs.

How do I search a whole district instead of one council? Use a slash and asterisk, e.g. faro/* for the Faro district or lisboa/* for the Lisbon district. A plain Lisboa searches the Lisbon council.

What does propertyType: any do? It visits every compatible Imovirtual category in turn and mixes the results: apartments, houses, land, garages, commercial property, offices, warehouses and rooms for rent, or new developments for sale. Rooms are rent-only and developments are sale-only on Imovirtual.

Does the actor use a proxy? It normally connects directly. If Imovirtual blocks a request, it retries and can fall back to Apify Proxy automatically; no proxy setup is required from you.

Are phone numbers included? No. Phone numbers are not part of the public listing data returned by the pages this actor reads.

Is this affiliated with Imovirtual? No. This is an independent, third-party actor that reads publicly available Imovirtual listing pages.

Limitations

  • Some Imovirtual filters (heating type, building type, floor level, availability window and map radius) are not exposed as actor inputs.
  • A plain location value resolves as a council. Use faro/* for a whole district and the site's path form for a parish, e.g. lisboa/lisboa/benfica.
  • English location aliases are provided for Lisbon and Oporto; other locations should use their Portuguese names.
  • Detail fields such as bathrooms, reference ID, build year, floor plans and video are present only when the seller or agency published them.