# ERA Portugal Scraper - era.pt Property Listings (`studio-amba/era-pt-scraper`) Actor

Scrape every property listing from ERA Portugal (era.pt), the real-estate franchise network. Sale, rent and transfer. Get price, typology, useful, gross and land areas, district, municipality, parish, coordinates, description, photos, energy certificate, agent and agency. No login required.

- **URL**: https://apify.com/studio-amba/era-pt-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** Real estate
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 76.2% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 result scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## ERA Portugal Scraper

Scrape property listings from [ERA Portugal](https://www.era.pt), the real estate franchise network with agencies in every district of the country. You get every listing with price, typology, useful, gross and land areas, district, municipality and parish, map coordinates, the full description, all photos, energy certificate, features, divisions, the consultant and the agency. Sale, rent and business transfer (trespasse), all property types. No login required.

### Why use this actor?

- **The complete ERA catalogue in one run.** Leave the location empty and set max items to 0: the actor reads all of era.pt, about 33,000 listings, and checks the count against the site's own counter. A shortfall fails the run instead of looking like a success.
- **Detail data, not just the list cards.** Description, municipality, parish and zone, condition, grouped features, divisions with area, energy certificate note, price per m² and the consultant handling the listing.
- **The site's own categories.** Property type comes from ERA's own filter (Apartamentos, Moradias, Terrenos, ...), so a type count matches the website.
- **Clean numbers.** Prices and areas are numbers, typology is `T0`, `T2`, `T3`, coordinates are decimal degrees.
- **Honest prices.** When the website shows "Sob Consulta", `price` is `null` and `priceOnRequest` is `true`. The actor never invents a price.
- **Restarts safely.** Long runs save their progress per district, so a platform migration resumes where it stopped instead of starting over.

Typical uses: feeding a real estate CRM or data hub, market and price analysis per municipality, monitoring new listings and price changes, and lists of ERA agencies and consultants.

### How to scrape ERA Portugal data

1. Open the actor and choose **Sale**, **Rent**, **Business transfer** or all of them.
2. Optionally type a district, municipality or "Parish, Municipality" in **Location** (for example `Lisboa`, `Sintra` or `Cedofeita, Porto`), and pick property types.
3. Set **Max items**. For the whole site, set it to 0 and leave the location empty.
4. Click **Start**. Download the results as JSON, CSV or Excel, or read them through the Apify API.

Example input for every apartment for rent in Lisbon district:

```json
{
    "transactionType": "rent",
    "location": "Lisboa",
    "propertyTypes": ["apartment"],
    "maxItems": 500
}
```

Example input for the whole site (sale, rent and transfer, all types, all of Portugal):

```json
{
    "transactionType": "all",
    "maxItems": 0
}
```

Example input for houses for sale between 150,000 and 300,000 EUR with at least 3 bedrooms in Braga:

```json
{
    "transactionType": "sale",
    "location": "Braga",
    "propertyTypes": ["house"],
    "minPrice": 150000,
    "maxPrice": 300000,
    "minBedrooms": 3,
    "maxItems": 1000
}
```

### Input

| Field | Type | Description |
|---|---|---|
| `transactionType` | string | `sale`, `rent`, `transfer` or `all` (default `all`) |
| `location` | string | District, municipality or "Parish, Municipality". Accents optional. Empty = all of Portugal. An unknown name fails the run with examples instead of silently searching the whole country |
| `propertyTypes` | array | `apartment`, `house`, `land`, `farm`, `building`, `room`, `shop`, `office`, `warehouse`, `garage`, `business`. Empty = all |
| `minPrice` / `maxPrice` | integer | Price range in EUR (monthly rent for rentals) |
| `minBedrooms` | integer | At least this many bedrooms. 5 = T5 or more |
| `sortBy` | string | `newest` (default), `oldest`, `price_desc`, `price_asc` |
| `maxItems` | integer | Maximum listings to return. 0 = no limit. Default 100, hard cap 100,000 |
| `includeDetails` | boolean | ON by default and load-bearing. Turning it OFF skips one call per listing: rows then carry only list data (price, typology, areas, district, coordinates, photos, energy class, agency) and description, municipality, parish, condition, features, divisions and agent stay empty |
| `maxConcurrency` | integer | Requests in parallel (default 8, max 24) |
| `proxyConfiguration` | object | Apify proxy. The automatic pool is enough, residential is not needed |

### Output

| Field | Example | Description |
|---|---|---|
| `listingId` | `1564958` | era.pt property id |
| `reference` | `116260142` | ERA reference, also at the end of the URL |
| `url` | `https://www.era.pt/imovel/...-116260142` | Listing page |
| `title` / `summary` | `Apartamento T3 / Espinho, Espinho` | Headline and short label |
| `transactionType` | `sale` | `sale`, `rent` or `transfer` |
| `businessType` | `Comprar` | Site label (Comprar, Arrendar, Trespasse) |
| `availability` | `available` | `available`, `reserved` or `sold` (site labels Disponível, Reservado, Já ERA) |
| `propertyType` / `propertyTypeLabel` / `propertySubtype` | `apartment` / `Apartamentos` / `Duplex` | Site category, normalised and as labelled |
| `typology` | `T3` | T0, T1, T2 ... |
| `bedrooms` / `bathrooms` | `3` / `2` | Quartos and WCs |
| `price` / `currency` | `389000` / `EUR` | Asking price or monthly rent |
| `priceOnRequest` | `false` | True when the site shows "Sob Consulta" |
| `previousPrice` / `isPriceReduced` | `410000` / `true` | Earlier price when the site shows a reduction |
| `salePrice` / `rentPriceMonthly` / `transferPrice` | | Each price when a listing carries several business types |
| `pricePerM2` | `3150` | Price per m² as shown by the site |
| `usefulAreaM2` / `grossPrivateAreaM2` / `landAreaM2` | `98` / `112` / `null` | Área útil, área bruta, área do terreno |
| `floor` / `hasElevator` / `parkingSpaces` | `6` / `true` / `1` | |
| `condition` | `Usado` | Estado |
| `energyCertificate` / `energyCertificateNote` | `C` | Energy class and the site's note (requested, exempt) |
| `district` / `municipality` / `parish` / `zone` | `Aveiro` / `Espinho` / `Espinho` | Distrito, concelho, freguesia, zona |
| `latitude` / `longitude` / `hasExactLocation` | `41.00788` / `-8.640011` / `false` | Map pin; `false` = approximate pin |
| `description` | `Apartamento no centro ...` | Full description |
| `features` / `featuresByGroup` | | All features, flat and grouped as on the site |
| `divisions` | `[{"name": "Sala", "areaM2": 41.5}]` | Rooms with area |
| `imageUrl` / `imageUrls` / `floorPlanUrls` / `imageCount` | | Main photo, all photos, floor plans, count |
| `virtualTourUrl` / `videoUrl` | | When the listing has them |
| `agentName` | `Inger Elin Rodrigues` | Consultant handling the listing |
| `agencyName` / `agencyCompanyName` / `agencyLicenseAmi` / `agencyPhone` / `agencyUrl` | `ERA Espinho` | ERA agency |
| `highlight` | `Novidade` | Badge on the listing |
| `isDevelopment` / `belongsToDevelopment` | `false` | New developments (empreendimentos) and their units |
| `detailsScraped` | `true` | False when only list data was saved |
| `scrapedAt` | `2026-11-09T21:47:00.000Z` | Time of scraping |

`agentEmail`, `agentPhone`, `agentProfileUrl`, `isFeatured`, `isExclusive`, `listedAt` and `updatedAt` are always `null`: era.pt does not publish them. They are kept so the output has the same columns as our other Portuguese real estate scrapers.

### Example output

```json
{
    "listingId": "1564958",
    "reference": "116260142",
    "url": "https://www.era.pt/imovel/apartamento-t3-vista-mar-espinho-116260142",
    "title": "Apartamento T3 / Espinho, Espinho",
    "summary": "Apartamento, Espinho, Aveiro",
    "transactionType": "sale",
    "businessType": "Comprar",
    "availability": "available",
    "availabilityLabel": "Disponível",
    "propertyType": "apartment",
    "propertyTypeLabel": "Apartamentos",
    "propertySubtype": "Apartamento",
    "typology": "T3",
    "bedrooms": 3,
    "bathrooms": 2,
    "price": 389000,
    "currency": "EUR",
    "priceOnRequest": false,
    "previousPrice": null,
    "salePrice": 389000,
    "rentPriceMonthly": null,
    "transferPrice": null,
    "pricePerM2": null,
    "usefulAreaM2": null,
    "grossPrivateAreaM2": 112,
    "landAreaM2": null,
    "floor": "6",
    "constructionYear": null,
    "condition": "Usado",
    "energyCertificate": "C",
    "energyCertificateNote": null,
    "hasElevator": true,
    "parkingSpaces": 1,
    "district": "Aveiro",
    "municipality": "Espinho",
    "parish": "Espinho",
    "zone": null,
    "locationFull": "Espinho, Aveiro",
    "latitude": 41.00788,
    "longitude": -8.640011,
    "hasExactLocation": false,
    "description": "Apartamento no centro da cidade de Espinho com áreas amplas e boa exposição solar e vistas de Mar.\nContém 3 quartos, doi ...",
    "features": [
        "Estado: Usado",
        "Nº Frentes: 2",
        "Água - Companhia",
        "Edifício - Equipamento: Videoporteiro"
    ],
    "featuresByGroup": {
        "Geral": [
            "Estado: Usado",
            "Nº Frentes: 2"
        ],
        "Água": [
            "Companhia"
        ]
    },
    "divisions": [
        {
            "name": "Corredor",
            "areaM2": null
        },
        {
            "name": "Cozinha",
            "areaM2": null
        },
        {
            "name": "Sala",
            "areaM2": null
        }
    ],
    "imageUrl": "https://mediaredir2.era.pt/i/apartamento-t3-espinho-espinho_14_1_1564958_19387976_2_1_w1jr1DY7H6UTVmF7t5tpX0Jlx1ePR620ZIms0H2iUufEB8h4ZPpqcw%3d%3d_.jpg",
    "imageUrls": [
        "https://mediaredir2.era.pt/i/apartamento-t3-espinho-espinho_14_1_1564958_19387976_2_1_w1jr1DY7H6UTVmF7t5tpX0Jlx1ePR620ZIms0H2iUufEB8h4ZPpqcw%3d%3d_.jpg"
    ],
    "floorPlanUrls": [],
    "imageCount": 1,
    "virtualTourUrl": null,
    "videoUrl": null,
    "agentName": "Vera Sousa",
    "agentEmail": null,
    "agentPhone": null,
    "agentProfileUrl": null,
    "agencyName": "ERA Espinho",
    "agencyCompanyName": "Imobuy - Mediação Imobiliária Lda",
    "agencyLicenseAmi": "6958",
    "agencyPhone": "227 333 300",
    "agencyUrl": "https://www.era.pt/agencias/espinho",
    "highlight": "Novidade",
    "isDevelopment": false,
    "belongsToDevelopment": false,
    "isFeatured": null,
    "isExclusive": null,
    "isPriceReduced": false,
    "listedAt": null,
    "updatedAt": null,
    "detailsScraped": true,
    "scrapedAt": "2026-11-09T21:43:54.322Z"
}
```

### Cost estimate

You pay per result: **$0.002 per listing** plus **$0.005 per run start** on the free plan, less on higher Apify plans. 1,000 listings cost about $2. The whole site of about 33,000 listings costs about $67 on the free plan.

A run of 100 listings takes well under a minute. A district of about 3,200 listings took 4 minutes with details. The whole site (33,318 listings on 9 Nov 2026) took 43 minutes.

A run's usage cost only settles after the run reports SUCCEEDED. Reading the cost of a run that is still going shows a number far below the final one.

### Limitations

- era.pt does not publish a listing date or update date, an agent email or phone, street addresses or postal codes.
- Construction year is not published for almost all listings.
- New developments (empreendimentos) are saved with the list data only: they have no reference and no detail record.
- Typology, bedrooms and bathrooms are empty for land, shops, warehouses and other non-residential types (about 40% of the site is land).
- Coordinates are the listing's map pin. When `hasExactLocation` is `false` the agency placed an approximate pin.
- Runs above 3,000 items read one district at a time, so the sort order holds per district.
- Data is scraped from the public website and may change without notice.

### Related Scrapers

- [Hall Portugal Scraper](https://apify.com/studio-amba/hall-pt-scraper)
- [Predimed Portugal Scraper](https://apify.com/studio-amba/predimed-pt-scraper)
- [RE/MAX Portugal Scraper](https://apify.com/studio-amba/remax-pt-scraper)
- [Imovirtual Scraper](https://apify.com/studio-amba/imovirtual-scraper)
- [Idealista Scraper](https://apify.com/studio-amba/idealista-scraper)
- [Supercasa Scraper](https://apify.com/studio-amba/supercasa-scraper)

### Maintained by Studio Amba

We run 700+ scrapers for European websites, and the priority is keeping
every one of them working. Automated runs test this actor against the live
site and verify the output is complete. When the website changes, the
scraper usually gets repaired the same day, without you having to report
anything. Questions and issues go straight to the people who built it, and
most get an answer the same day.

If this actor works for you, a review on its Store page helps other people
find it.

# Actor input Schema

## `transactionType` (type: `string`):

Sale (comprar), rent (arrendar), business transfer (trespasse) or all of them.

## `location` (type: `string`):

A Portuguese district (e.g. "Porto", "Lisboa", "Faro", "Madeira"), a municipality (e.g. "Sintra", "Matosinhos") or "Parish, Municipality" (e.g. "Cedofeita, Porto"). Accents are optional. Leave empty for all of Portugal. A name the site does not know fails the run with examples, it never silently widens to the whole country.

## `propertyTypes` (type: `array`):

Only these property types. Leave empty for all types. These are the site's own categories.

## `minPrice` (type: `integer`):

Minimum asking price, or minimum monthly rent for rentals.

## `maxPrice` (type: `integer`):

Maximum asking price, or maximum monthly rent for rentals.

## `minBedrooms` (type: `integer`):

Only listings with at least this many bedrooms (T1 = 1). 5 means T5 or more. Listings without a typology (land, shops) drop out when this is set.

## `sortBy` (type: `string`):

Order of the results. With a low max items this decides which listings you get. Runs above 3,000 items walk one district at a time, so the order then holds per district.

## `maxItems` (type: `integer`):

Maximum number of listings to return. 0 = no limit (the whole site, about 33,000 listings). Hard cap 100,000.

## `includeDetails` (type: `boolean`):

ON by default and load-bearing: the description, municipality, parish, condition, features, divisions, energy certificate note, price per m² and the agent name come from one extra call per listing. Turn it OFF only for a fast price/status check: rows then carry the list data (price, typology, areas, district, coordinates, photos, energy class, agency).

## `maxConcurrency` (type: `integer`):

Requests in parallel.

## `proxyConfiguration` (type: `object`):

era.pt sits behind Cloudflare but does not challenge API calls (see recon), so Apify's automatic proxy is enough. Residential is not needed.

## Actor input object example

```json
{
  "transactionType": "sale",
  "location": "Porto",
  "sortBy": "newest",
  "maxItems": 20,
  "includeDetails": true,
  "maxConcurrency": 8,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "transactionType": "sale",
    "location": "Porto",
    "maxItems": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/era-pt-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "transactionType": "sale",
    "location": "Porto",
    "maxItems": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/era-pt-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "transactionType": "sale",
  "location": "Porto",
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call studio-amba/era-pt-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/era-pt-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Ur1iIR0hIf5NGAjDS/builds/qRqAGMfJxRBIXSEC5/openapi.json
