Sign in Get API key
Supercasa API

Portuguese Property Search, Agency Data, and Market Insights via REST API

Search Supercasa property listings for sale and rent, fetch listing details, resolve Portuguese locations, look up real estate agencies and their published listings, read price-per-m\u00b2 market history, and query listings inside a map polygon. Supercasa is Portugal\u2019s national property portal and publishes no public API; Scrappa provides programmatic access.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
Start for free View documentation
Browse endpoints Try first endpoint
8
Endpoints
Portugal
Coverage
$0.20
Per 1k requests

Try it now

Make one request. Inspect structured JSON.

Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.

Get free API key Try in Playground Open docs
Request preview
Request 
curl -X GET "https://scrappa.co/api/supercasa/search?location=Lisboa&business=sale&max_price=350000" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
JSON response 
{
  "success": true,
  "properties": [
    {
      "listingId": 2165197,
      "listingReference": "SuperCasa QRHR2395",
      "title": "Apartamento T2 \u00e0 venda em Benfica",
      "propertyType": "Apartamento",
      "business": "Comprar",
      "price": 395000,
      "location": "Benfica, Lisboa",
      "bedrooms": 2,
      "bathrooms": 2,
      "grossAreaSqm": 120,
      "firstPhoto": "https://images.egorealestate.com/Z720x540/S5/C10197/P29637360/Tphoto/IDf03ac401.jpg",
      "url": "https://supercasa.pt/venda-apartamento-t2-lisboa/i2165197"
    }
  ],
  "total": 7254,
  "page": 1,
  "page_size": 25,
  "has_more": true
}

What you can build

Structured data for real applications. Here are some ideas.

Portuguese Market Monitoring

Track sale and rental supply, asking prices and price-per-m\u00b2 movement across Portuguese districts from one repeatable feed instead of scraping portals page by page.

Agency Coverage Analysis

Map which agencies operate in each locality, how much inventory they publish and their listing counts, to size local competition.

Map and Territory Tools

Query the listings inside a drawn polygon, then join each marker onto its full record to build viewport-driven property search.

Cross-Portal Deduplication

Combine Supercasa with other Portuguese property sources and deduplicate by coordinates, listing URL and price.

Available endpoints

Everything you need in one API.

Scrappa vs Supercasa (no public API)

See how Scrappa compares to the official API.

API available
Scrappa: Yes (8 endpoints)
Supercasa (no public API): No public API
Sale and rental search
Scrappa: Programmatic
Supercasa (no public API): Manual only
New-build developments
Scrappa: Same search endpoint
Supercasa (no public API): Separate browsing
Agency directory and profiles
Scrappa:
Supercasa (no public API): On-site only
Market price history
Scrappa:
Supercasa (no public API): Not available
Map polygon search
Scrappa:
Supercasa (no public API): On-site only
Bulk access
Scrappa:
Supercasa (no public API):
Integration ready
Scrappa: REST API
Supercasa (no public API):

Key features

Search listings for sale and for rent
New-build developments (empreendimentos) in the same query
Full listing records with normalised prices and areas
Location autocomplete with ambiguity resolution
Agency directory and agency profiles with listing inventories
Price-per-m2 market history with raw and display values
Map polygon search that joins onto listing detail
Photo URLs rewritten to a host that serves directly
No official Supercasa API exists \u2014 Scrappa fills the gap

Frequently asked questions

Supercasa publishes no public API. Scrappa exposes 8 structured endpoints covering search, listing detail, filters, location resolution, agencies, price reports and map search, so you can build applications and run market analysis without maintaining a scraper.

Yes. One endpoint covers all three: set business to sale or rent for ordinary supply, and set category to new_construction for empreendimentos. The response shape is identical across them.

Just a Scrappa API key sent as an X-API-KEY header. No Supercasa account, no partner programme, no OAuth.

No. It returns agency names, handles, logos, listing inventories and published licence identifiers, but no phone numbers or email addresses.

Scrappa never rate limits a client and never charges credits for a failed request. Upstream degradation is reported as an error, not as a 429.

Yes. Every Scrappa account gets 500 free credits per month with no credit card required, enough to test all 8 endpoints.

Start using the Supercasa API

Sign up and get 500 free credits. No credit card required.

Create Free Account View Documentation