Supercasa.pt Scraper - Portuguese Real Estate Data Extractor

Supercasa Scraper

Extract real estate listings from Supercasa.pt, one of Portugal's leading property portals. This actor pulls prices, addresses, bedrooms, bathrooms, surface area, geo-coordinates, photos, and agency details for houses and apartments for sale or rent, across every Portuguese municipality.

Why use this actor?

Supercasa covers the full Portuguese market, from Lisbon and Porto to small inland municipalities, with structured data on every listing (not just a headline price and a photo). That makes it useful for market analysis, price-per-m² benchmarking by neighbourhood, relocation research, and lead generation for proptech and real estate agency tools.

Use cases include investment due diligence, competitor tracking for agencies, academic housing studies, and feeding a property search app or price alert tool with fresh Portuguese listings.

How to scrape Supercasa.pt data

1. Go to the actor's page on the Apify Store
2. Choose a city or municipality (defaults to Lisboa) and listing type (buy or rent)
3. Or paste a Supercasa.pt search URL (e.g. https://supercasa.pt/comprar/porto) or individual listing URLs into Start URLs
4. Set Max Results — the actor paginates automatically until it's reached
5. Click "Start" to run the scraper
6. Download results as JSON, CSV, or Excel when complete

The actor opens one browser session that passes Supercasa's Cloudflare check, then reads every page inside that session. Data comes from the site's own schema.org structured data on search pages and detail pages. Searches with more than 1,875 results (the most the site pages through) are split into price ranges automatically, so a district or the whole country is read completely.

Input

Field	Type	Required	Description
listingType	String	No	comprar (for sale, default) or arrendar (for rent)
city	String	No	City or municipality URL slug, e.g. lisboa (default), porto, cascais, braga. portugal reads every listing in the country (all 29 district pages).
startUrls	Array	No	Supercasa.pt search result pages or individual listing URLs. Overrides City/Listing Type
maxResults	Integer	No	Maximum listings to return (up to 200,000). Search pages hold 25 listings each; the actor paginates and splits large searches by price automatically
includeDetails	Boolean	No	Default true. Fetch each listing's detail page for coordinates, address, description, agency and all photos. Set false for fast runs with search-result fields only (title, price, URL, type, bedrooms, bathrooms, floor area, year built, publication date, up to 10 photos).
proxyConfiguration	Object	No	Proxy for the browser session. The default Apify automatic proxy works and is the cheapest.
brightDataApiKey	String	No	Your own Bright Data API key for the Web Unlocker zone, used only when the browser session cannot pass the Cloudflare check. Leave empty to use the built-in unlocking service

Output

Each result contains:

Field	Type	Example
title	String	"Apartamento T3 c/ garagem e arrecadação na Estrada da Luz"
price	Number	735000
currency	String	"EUR"
listingType	String	"sale" or "rent"
propertyType	String	"apartamento", "moradia", "terreno"
address	String	"São Domingos de Benfica, Lisboa"
city	String	"Lisboa"
province	String	"Lisboa"
latitude / longitude	Number	38.7457466 / -9.175513
bedrooms	Number	3
bathrooms	Number	2
surface	Number	147 (m²)
imageUrl	String	Primary listing photo URL
imageUrls	Array	All listing photo URLs
description	String	Full listing description text
agencyName	String	"Hall Rede Imobiliária"
agencyUrl	String	Agency profile URL on Supercasa.pt
supercasaId	String	"2195233"
url	String	Full Supercasa.pt listing URL
scrapedAt	String	ISO 8601 timestamp

Example output

{
    "title": "Apartamento T3 c/ garagem e arrecadação na Estrada da Luz",
    "price": 735000,
    "currency": "EUR",
    "listingType": "sale",
    "propertyType": "apartamento",
    "address": "São Domingos de Benfica, Lisboa",
    "city": "Lisboa",
    "province": "Lisboa",
    "latitude": 38.7457466,
    "longitude": -9.175513,
    "bedrooms": 3,
    "bathrooms": 2,
    "surface": 147,
    "imageUrl": "https://imagens.supercasa.pt/Z720x540/OAYES/S5/C96/P30032552/Tphoto/IDa842ca01-0000-0500-0000-000019520947.JPG",
    "description": "Apartamento T3 Área bruta 147 m², Apartamento T3 à venda, Apartamento T3 em Estrada da Luz, São Domingos de Benfica, Lisboa",
    "agencyName": "Hall Rede Imobiliária",
    "agencyUrl": "https://supercasa.pt/agencia/3940",
    "supercasaId": "2195233",
    "url": "https://supercasa.pt/venda-apartamento-t3-lisboa/i2195233",
    "scrapedAt": "2026-08-30T09:24:52.291Z"
}

Cost estimate

Measured on 2026-11-10 with the default Apify automatic proxy and 2 GB memory:

• Search results only (includeDetails: false): about 1,400 listings per minute. The whole Porto district (22,964 sale listings) took 17 minutes and $0.20 in platform usage. The whole country (about 110,000 listings) takes roughly 1.5 hours, about $1.
• With detail pages (includeDetails: true): about 330-400 listings per minute. The whole country takes roughly 5-6 hours, about $4-5 in platform usage. Set the run timeout accordingly.
• Individual listing URLs (startUrls): one page per listing.

Platform usage is mostly compute (the browser session); the automatic proxy has no per-GB charge.

Actual usage cost only settles once the run reports SUCCEEDED — reading the dataset from a still-running run will undercount what you'll actually be charged.

Tips for best results

• Start small — test with maxResults: 20 before running large scrapes.
• Use arrendar for rentals — the same city/municipality coverage applies to both for-sale and rental listings.
• City slugs cover every Portuguese municipality — not just the big cities. Browse supercasa.pt and read the last URL segment of a /comprar/{slug} page to find any municipality's slug.
• Direct listing URLs work too — paste a /venda-{type}-{city}/i{id} or /arrendar-{type}-{city}/i{id} URL into Start URLs to scrape a single known listing.

Limitations

• Supercasa.pt fronts every page with a Cloudflare managed challenge. The actor passes it with one browser session and falls back to Bright Data's Web Unlocker (much slower) only when the browser cannot pass it on several proxy sessions.
• When a detail page cannot be fetched before the run timeout, the listing is still returned from its search result with detailScraped: false, so a short timeout gives you fewer detail fields, not an empty run.
• Coordinates, street-level address, description and agency are only on detail pages. Rows built from search results alone carry the municipality from the listing URL (without accents) instead.
• The actor reads houses and apartments (casas). Land, garages, offices and buildings are separate sections on supercasa.pt; paste those search URLs (e.g. https://supercasa.pt/comprar-terrenos/lisboa-distrito) into Start URLs.
• Supercasa.pt pages through at most 75 pages (1,875 results) per search. Larger searches are split by price range; the log shows the site's counter next to the number of rows read.
• Price reflects Supercasa's own listed asking price, not a guaranteed final sale price.
• The actor scrapes the public website. No login or authentication is used.

Related scrapers

• Idealista Scraper — Spain and Portugal's leading real estate portal
• Storia.ro Scraper — Romanian real estate listings
• Booli Scraper — Swedish real estate listings and sold prices
• Boligsiden Scraper — Danish real estate listings and sold prices
• MyHome.ie Scraper — Irish real estate listings
• Morizon Scraper — Polish real estate listings