Imovirtual.com Property Search Scraper: Extract Portuguese Real Estate Listings

Understanding Imovirtual.com and Its Real Estate Market Value

Imovirtual.com is Portugal's premier property listing platform, connecting buyers, sellers, and renters across Portuguese real estate markets. The platform aggregates listings from agencies and private owners, covering residential, commercial, and investment properties throughout Portugal's major cities and coastal regions.

Search result pages contain essential property data—prices, locations, sizes, room counts, and agency information. For real estate professionals, investors, and market researchers, this data reveals pricing trends, inventory availability, and competitive landscapes across Portuguese property markets.

This scraper automates data collection from search pages, transforming multiple property listings into structured datasets for analysis, price comparison, and market intelligence.

What This Scraper Extracts and Target Users

The scraper processes Imovirtual.com search result URLs (not individual property pages), capturing multiple listings per page. It extracts property identifiers, pricing, specifications, location data, images, and agency details.

Primary Users:

• Real Estate Agencies: Monitor competitor listings, track market inventory, analyze pricing strategies
• Property Investors: Identify investment opportunities, compare yields, track market trends
• Market Analysts: Research pricing patterns, supply dynamics, regional variations
• PropTech Companies: Build property databases, power recommendation engines, aggregate market data

Input Configuration

The scraper processes search result page URLs from Imovirtual.com filters (location, property type, transaction type).

{
  "proxy": {
    "useApifyProxy": false
  },
  "max_items_per_url": 20,
  "ignore_url_failures": true,
  "urls": [
    "https://www.imovirtual.com/pt/resultados/comprar/apartamento/porto/porto/bonfim/heroismo--nova-sintra--soares-dos-reis?distanceRadius=50&page=2"
  ]
}

Example Screenshot:

Parameters:

proxy: Set useApifyProxy: true with residential proxies for large-scale scraping. For small runs, proxies may be optional.

max_items_per_url: Limits properties extracted per page. Imovirtual displays ~20-30 listings per page; set to 20-50 based on needs.

ignore_url_failures: Enable (true) when scraping multiple URLs to continue despite individual page errors.

urls: Array of search result URLs. Build URLs by filtering on Imovirtual.com (location, property type, price range), then copy the URL. Include pagination parameters (&page=2, &page=3) for multi-page extraction.

URL Collection Tip: Perform manual searches on Imovirtual.com with desired filters, copy resulting URLs. For comprehensive datasets, increment page numbers systematically.

Output Structure and Field Definitions

ID: Unique property listing identifier. Use for tracking, deduplication, database primary keys.

Title: Property headline/name as displayed. Primary description field, searchable text.

Slug: URL-friendly identifier. Construct direct property URLs, alternative ID.

Estate: Property category (apartment, house, land). Classification and filtering.

Development: Boolean indicating if part of a real estate development. Identify new construction projects.

Development ID/Title/URL: Development project identifiers and links. Track project-level data, link related properties.

Transaction: Sale type (buy, rent, lease). Segment by transaction intent.

Location: Geographic data object with address details. Location-based analysis, mapping, regional filtering.

Images: Array of property image URLs. Visual assets for listings, image analysis.

Total Possible Images: Count of available images. Quality indicator (more images = better listings).

Exclusive Offer: Boolean for exclusive agency representation. Premium listing indicator.

Private Owner: Boolean indicating direct owner listing (vs. agency). Distinguish FSBO from agency properties.

Promoted: Boolean for paid promotion status. Identify premium-placed listings.

Source: Listing origin/platform. Track data provenance.

Agency: Real estate agency object with name and details. Agency performance tracking, competitive analysis.

Open Days: Scheduled viewing dates array. Availability tracking, buyer interest signals.

Total Price: Full property purchase/rental price. Primary pricing field for analysis.

Rent Price: Monthly rental price (for rental properties). Rental market analysis.

Price Per Square Meter: Unit price calculation. Standardized price comparison across properties.

Price From Per Square Meter: Minimum unit price (for developments). Entry price analysis for projects.

Area in Square Meters: Usable property area. Size-based filtering, yield calculations.

Terrain Area in Square Meters: Land/plot size. Important for houses, land parcels.

Number of Rooms: Bedroom count. Property categorization (T1, T2, T3 in Portuguese notation).

Hide Price: Boolean if price is hidden. Identify negotiable/undisclosed pricing.

Floor Number: Property floor level. Preference filtering (ground floor, top floor).

Investment State: Development construction status (planned, under construction, completed). Investment timing analysis.

Investment Units Area in Square Meters: Total development area. Project scale indicator.

People Per Room: Occupancy ratio. Relevant for student housing, shared accommodations.

Date Created: Original listing creation timestamp. Freshness tracking.

Created At First: Initial publication date. Track listing age, identify stale inventory.

Investment Units Number: Count of units in development. Project size analysis.

Investment Units Rooms Number: Bedroom distribution in development. Unit mix analysis.

Estimated Delivery: Expected completion date for developments. Investment timeline planning.

Pushed Up At: Last promoted/refreshed timestamp. Active marketing indicator.

Special Offer: Promotional flag. Identify price reductions, incentives.

Short Description: Brief property description. Quick overview text, keyword extraction.

Show Premium Tile: Premium display flag. UI prominence indicator.

Organisation Assigned Member: Agency contact assigned to listing. Lead routing information.

Advert Owner: Listing creator/owner details. Contact information.

Type Name: Detailed property type. Granular categorization.

Images Hashes: Image fingerprints. Duplicate detection, image tracking.

Row Index: Position in search results. Ranking analysis, visibility tracking.

Href: Direct link to property page. Navigation, detail scraping reference.

Sample Output:

[
  {
  "id": 18932859,
  "title": "Apartamento T3 em construção com grande terraço a 400 Metros da Praia",
  "slug": "apartamento-t3-em-construcao-com-grande-terraco-a-400-metros-da-praia-ID1hriH",
  "estate": "FLAT",
  "development": null,
  "development_id": 0,
  "development_title": "",
  "development_url": "",
  "transaction": "SELL",
  "location": {
    "map_details": {
      "radius": 100,
      "__typename": "MapDetails"
    },
    "address": {
      "street": null,
      "city": {
        "name": "São Felix da Marinha",
        "__typename": "City"
      },
      "province": {
        "name": "Porto",
        "__typename": "Province"
      },
      "__typename": "Address"
    },
    "reverse_geocoding": {
      "locations": [
        {
          "id": "porto",
          "full_name": "Porto",
          "name": "Porto",
          "location_level": "district",
          "__typename": "BasicLocationObject"
        },
        {
          "id": "porto/vila-nova-de-gaia",
          "full_name": "Vila Nova de Gaia, Porto",
          "name": "Vila Nova de Gaia",
          "location_level": "council",
          "__typename": "BasicLocationObject"
        },
        {
          "id": "porto/vila-nova-de-gaia/sao-felix-da-marinha",
          "full_name": "São Félix da Marinha, Vila Nova de Gaia, Porto",
          "name": "São Félix da Marinha",
          "location_level": "parish",
          "__typename": "BasicLocationObject"
        },
        {
          "id": "porto/vila-nova-de-gaia/sao-felix-da-marinha/praia-de-brito--sao-felix-da-marinha",
          "full_name": "Praia de Brito - São Félix da Marinha, São Félix da Marinha, Vila Nova de Gaia, Porto",
          "name": "Praia de Brito - São Félix da Marinha",
          "location_level": "neighborhood",
          "__typename": "BasicLocationObject"
        }
      ],
      "__typename": "ReverseGeocoding"
    },
    "__typename": "LocationDetails"
  },
  "images": [
    {
      "medium": "https://ireland.apollo.olxcdn.com/v1/files/eyJmbiI6InM5aW96MXQxdDBzNTMtRUNPU1lTVEVNIiwidyI6W3siZm4iOiI2OW5scGE3ZWNxbTcxLUFQVCIsInMiOiIxNCIsInAiOiIxMCwtMTAiLCJhIjoiMCJ9XX0.DMMfCjHr1FsWjGduo5zeOhOhxZi9jh05j2bSY-OMF1A/image;s=655x491;q=80",
      "large": "https://ireland.apollo.olxcdn.com/v1/files/eyJmbiI6InM5aW96MXQxdDBzNTMtRUNPU1lTVEVNIiwidyI6W3siZm4iOiI2OW5scGE3ZWNxbTcxLUFQVCIsInMiOiIxNCIsInAiOiIxMCwtMTAiLCJhIjoiMCJ9XX0.DMMfCjHr1FsWjGduo5zeOhOhxZi9jh05j2bSY-OMF1A/image;s=1280x1024;q=80",
      "__typename": "AdImage"
    },
    {
      "medium": "https://ireland.apollo.olxcdn.com/v1/files/eyJmbiI6ImdvbnptaDZmajJubjEtRUNPU1lTVEVNIiwidyI6W3siZm4iOiI2OW5scGE3ZWNxbTcxLUFQVCIsInMiOiIxNCIsInAiOiIxMCwtMTAiLCJhIjoiMCJ9XX0.ljW7A0vb9SqQpLrynljqTEReHjmJMd5J2r1dC3Q4pQA/image;s=655x491;q=80",
      "large": "https://ireland.apollo.olxcdn.com/v1/files/eyJmbiI6ImdvbnptaDZmajJubjEtRUNPU1lTVEVNIiwidyI6W3siZm4iOiI2OW5scGE3ZWNxbTcxLUFQVCIsInMiOiIxNCIsInAiOiIxMCwtMTAiLCJhIjoiMCJ9XX0.ljW7A0vb9SqQpLrynljqTEReHjmJMd5J2r1dC3Q4pQA/image;s=1280x1024;q=80",
      "__typename": "AdImage"
    },
    {
      "medium": "https://ireland.apollo.olxcdn.com/v1/files/eyJmbiI6InRtMWw3dDNhM21pMzEtRUNPU1lTVEVNIiwidyI6W3siZm4iOiI2OW5scGE3ZWNxbTcxLUFQVCIsInMiOiIxNCIsInAiOiIxMCwtMTAiLCJhIjoiMCJ9XX0.pPSkFbwLLMM4Ge3EnctvwRBTQgtZHgAx8HgBE0LEJes/image;s=655x491;q=80",
      "large": "https://ireland.apollo.olxcdn.com/v1/files/eyJmbiI6InRtMWw3dDNhM21pMzEtRUNPU1lTVEVNIiwidyI6W3siZm4iOiI2OW5scGE3ZWNxbTcxLUFQVCIsInMiOiIxNCIsInAiOiIxMCwtMTAiLCJhIjoiMCJ9XX0.pPSkFbwLLMM4Ge3EnctvwRBTQgtZHgAx8HgBE0LEJes/image;s=1280x1024;q=80",
      "__typename": "AdImage"
    }
  ],
  "total_possible_images": 24,
  "is_exclusive_offer": false,
  "is_private_owner": false,
  "is_promoted": false,
  "source": "urn:partner:ego",
  "agency": {
    "id": 5141125,
    "name": "Namorada - Mediação Imobiliária Unip. Lda",
    "slug": "namorada-mediacao-imobiliaria-unip-lda-ID5141125",
    "image_url": "https://ireland.apollo.olxcdn.com/v1/files/eyJmbiI6InY3dXRzYWt6aXdkdDMtQVBUIn0.zRKK6y8TLUYeOj9Midxo9TWvEJTJ18cYmk1f04nyjRM/image;s=800x600;q=90",
    "type": "AGENCY",
    "branding_visible": true,
    "highlighted_ads": false,
    "enhanced_branding_features": [],
    "__typename": "AgencyListingDetails"
  },
  "open_days": "",
  "total_price": {
    "value": 450000,
    "currency": "EUR",
    "__typename": "Money"
  },
  "rent_price": null,
  "price_from_per_square_meter": null,
  "price_per_square_meter": {
    "value": 4278,
    "currency": "EUR",
    "__typename": "Money"
  },
  "area_in_square_meters": 105.2,
  "terrain_area_in_square_meters": null,
  "rooms_number": "FOUR",
  "hide_price": false,
  "floor_number": "GROUND",
  "investment_state": null,
  "investment_units_area_in_square_meters": null,
  "people_per_room": null,
  "date_created": "2025-12-19 23:34:59",
  "created_at_first": "2025-11-01T11:48:38Z",
  "investment_units_number": null,
  "investment_units_rooms_number": null,
  "investment_estimated_delivery": null,
  "pushed_up_at": "2025-12-19T23:34:59Z",
  "special_offer": null,
  "short_description": "Em São Félix da Marinha, nasce um condomínio fechado diferenciado!\r\n\r\nNo piso zero, temos este apartamento T3 com um terraço enorme, linhas modernas, a escassos 400 metros da praia. Um espaço onde o d...",
  "show_premium_tile": false,
  "organisation_assigned_member": null,
  "advert_owner": {
    "name": "Namorada - Mediação Imobiliária Unip. Lda",
    "image_url": "",
    "contacts": [],
    "__typename": "LegacyAdvertOwner"
  },
  "images_hashes": [
    "https://ireland.apollo.olxcdn.com/v1/files/eyJmbiI6InM5aW96MXQxdDBzNTMtRUNPU1lTVEVNIiwidyI6W3siZm4iOiI2OW5scGE3ZWNxbTcxLUFQVCIsInMiOiIxNCIsInAiOiIxMCwtMTAiLCJhIjoiMCJ9XX0.DMMfCjHr1FsWjGduo5zeOhOhxZi9jh05j2bSY-OMF1A/image",
    "https://ireland.apollo.olxcdn.com/v1/files/eyJmbiI6ImdvbnptaDZmajJubjEtRUNPU1lTVEVNIiwidyI6W3siZm4iOiI2OW5scGE3ZWNxbTcxLUFQVCIsInMiOiIxNCIsInAiOiIxMCwtMTAiLCJhIjoiMCJ9XX0.ljW7A0vb9SqQpLrynljqTEReHjmJMd5J2r1dC3Q4pQA/image",
    "https://ireland.apollo.olxcdn.com/v1/files/eyJmbiI6InRtMWw3dDNhM21pMzEtRUNPU1lTVEVNIiwidyI6W3siZm4iOiI2OW5scGE3ZWNxbTcxLUFQVCIsInMiOiIxNCIsInAiOiIxMCwtMTAiLCJhIjoiMCJ9XX0.pPSkFbwLLMM4Ge3EnctvwRBTQgtZHgAx8HgBE0LEJes/image"
  ],
  "row_index": 0,
  "href": "[lang]/ad/apartamento-t3-em-construcao-com-grande-terraco-a-400-metros-da-praia-ID1hriH",
  "from_url": "https://www.imovirtual.com/pt/resultados/comprar/apartamento/porto/porto/bonfim/heroismo--nova-sintra--soares-dos-reis?distanceRadius=50"
}
]

Step-by-Step Usage Guide

1. Define Search Criteria: Decide target properties—location (Porto, Lisbon, Algarve), type (apartments, houses), transaction (buy/rent), price range.

2. Build Search URLs: Use Imovirtual.com filters to create searches matching criteria. Copy resulting URLs. For deep extraction, note pagination and create URL list with page increments.

3. Configure Input: Create JSON with URLs, set max_items_per_url (20-50), enable ignore_url_failures for robustness. Add proxies for large runs.

4. Execute Scraper: Launch in Apify console. Monitor progress. Typical run: 5-10 pages with 20 items each completes in 2-4 minutes.

5. Export Data: Download as JSON (databases), CSV (spreadsheets), or Excel (reporting). Filter by criteria (price ranges, locations, property types).

6. Handle Pagination: For extensive data, either list multiple page URLs or increase max_items_per_url beyond page display to trigger auto-pagination.

Strategic Applications

Pricing Intelligence: Analyze price per square meter across neighborhoods. Identify undervalued properties, track appreciation rates, benchmark agency pricing strategies.

Inventory Tracking: Monitor new listings daily. Calculate market velocity (days on market), identify seasonal patterns, track supply in target areas.

Investment Opportunity Screening: Filter by yield potential (rent price vs. total price), development stage, location appreciation trends. Identify emerging neighborhoods before price spikes.

Competitive Agency Analysis: Track competitor agencies—listing volume, pricing strategies, exclusive offers, market positioning. Analyze promoted listings frequency to gauge marketing investment.

Market Segmentation: Compare private owner vs. agency listings—pricing differences, time on market, description quality. Identify FSBO opportunities.

Development Pipeline Monitoring: Track new developments—estimated delivery, unit counts, pricing, locations. Forecast supply influx, assess competition for investors.

Best Practices

Regular Scraping: Property markets move rapidly. Weekly scraping captures new listings and price changes. Daily scraping for hot markets (Lisbon, Porto centers).

Targeted Searches: Create separate URL groups by criteria rather than one broad search. Examples: "Lisbon T2 under 300k," "Porto coastal houses," "Algarve investment properties."

Data Enrichment: Combine with property detail scrapers for full descriptions. Cross-reference with Portuguese census data, tourism statistics, or rental yield calculators.

Quality Checks: Validate price ranges (flag outliers), ensure locations are populated, verify image counts. Filter stale listings using created_at_first and pushed_up_at dates.

Historical Analysis: Store scrapes with timestamps. Track price evolution, listing turnover, seasonal trends. Identify properties with multiple price reductions.

Respect Platform: Space large runs over hours, avoid excessive concurrent requests. Sustainable scraping ensures continued data access.

Conclusion

The Imovirtual.com Property Search Scraper transforms Portugal's leading real estate platform into actionable market intelligence. Whether identifying investment opportunities, analyzing pricing trends, or monitoring competitive landscapes, this tool delivers comprehensive property data across Portuguese markets. Start extracting real estate insights today.