# Century 21 Portugal Scraper - Real Estate Listings (`studio-amba/century21-pt-scraper`) Actor

Scrape property listings from Century 21 Portugal (century21.pt). Price, typology, useful, gross and land area, description, photos, energy certificate, coordinates, district, municipality, parish, agent and agency. Sale, rent and business transfer. No login.

- **URL**: https://apify.com/studio-amba/century21-pt-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** Real estate
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% 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

## Century 21 Portugal Scraper

Scrape every property listing from Century 21 Portugal (century21.pt), one of the largest real estate agency networks in Portugal, with around 15,000 listings for sale, for rent and for business transfer.

### Why use this actor?

Century 21 agencies publish their full stock on century21.pt, including listings that never reach the big portals. If you feed a real estate CRM, track agency stock per region, or compare asking prices per parish, this actor gives you every listing as a structured row: price, typology, useful, gross and land area, the full description, all photos, energy certificate, coordinates, district, municipality and parish, and the consultant and agency that hold the listing.

One run with no filters reads the whole site.

### How to scrape Century 21 Portugal data

1. Leave every filter empty to get every listing in Portugal: sale, rent and business transfer, all property types.
2. Or narrow it down with **Transaction type**, **Property type**, **District**, **Municipality** or **Parish**. Accents are optional: `Setubal` and `Setúbal` both work.
3. Optionally add **Bedrooms**, **Minimum price** and **Maximum price**.
4. Set **Max items** and run. The default of 50,000 covers the whole site.
5. Download the dataset as JSON, CSV or Excel, or read it through the Apify API.

The filters are applied by century21.pt itself, so they behave like the filters on the website. No login, cookies or browser are needed.

### Input

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `transactionTypes` | Array | No | `sale` (Comprar), `rent` (Arrendar), `transfer` (Trespasse). Empty = all three. |
| `propertyTypes` | Array | No | `apartment`, `house`, `building`, `homestead`, `room`, `land`, `urban_land`, `warehouse`, `factory`, `office`, `hotel`, `palace`, `retail_park`, `mall`, `store`, `restaurant`, `cafe`, `bar`, `parking_space`, `storage`, `garage`, `commercial`. Empty = all. |
| `district` | String | No | Distrito or island, e.g. `Lisboa`, `Porto`, `Faro`, `Ilha da Madeira` |
| `municipality` | String | No | Concelho, e.g. `Cascais`, `Sintra`, `Palmela` |
| `parish` | String | No | Freguesia, e.g. `Pinhal Novo` |
| `bedrooms` | Array of integers | No | Exact bedroom counts, e.g. `[2, 3]` for T2 and T3 |
| `minPrice` / `maxPrice` | Integer | No | Price range in EUR (monthly rent for rentals) |
| `sortBy` | String | No | `newest`, `oldest`, `price_asc`, `price_desc`. Empty = by listing id, the most reliable order for a full read. |
| `includeDetails` | Boolean | No | On by default. Loads each listing's own page for the description, energy certificate, land area, condition, construction year, floor, postal code and the district, municipality and parish names. Turn it off for a faster read with only the search fields. |
| `language` | String | No | Language of title and description: `pt` (default), `en`, `es`, `fr` |
| `startUrls` | Array | No | Listing URLs, e.g. `https://century21.pt/comprar/C0545-00137`. Max 500. When set, the filters are ignored. |
| `maxItems` | Integer | No | Maximum listings to save. Default 50,000. |
| `proxyConfiguration` | Object | No | Apify automatic proxy is enough. |

Every filter is off by default. An empty filter never narrows the results.

### Output

Each listing is one row. Fields the site does not show for a listing are `null`, never invented.

| Field | Type | Example |
|-------|------|---------|
| `listingId` | Integer | `820860` |
| `reference` | String | `"C0545-00137"` |
| `url` | String | `"https://century21.pt/comprar/C0545-00137"` |
| `title` | String | Listing title |
| `transactionType` | String | `"sale"`, `"rent"` or `"transfer"` |
| `availability` | String | `"available"` |
| `propertyType` / `propertyTypeLocal` | String | `"apartment"` / `"Apartamento"` |
| `typology` | String | `"T1"` |
| `bedrooms` / `bathrooms` / `parkingSpaces` | Number | `1` / `1` / `1` |
| `price` | Number or null | `395000` |
| `previousPrice` / `isPriceReduced` | Number / Boolean | Earlier asking price |
| `priceOnRequest` | Boolean | `true` when the price is hidden |
| `currency` | String | `"EUR"`, always next to `price` |
| `pricePerM2` | Number | `4202.13` |
| `usefulAreaM2` / `grossAreaM2` / `landAreaM2` | Number | Área útil / bruta / terreno |
| `floor` | String | `"3"`, `"R/C"` |
| `constructionYear` | Number | `1988` |
| `condition` | String | `"used"`, `"new"`, `"renovated"` |
| `energyCertificate` | String | `"C"`, `"A+"`, `"exempt"`, `"in_process"` |
| `description` | String | Full description |
| `district` / `municipality` / `parish` | String | `"Lisboa"` / `"Cascais"` / parish name |
| `districtCode` / `municipalityCode` / `parishCode` | String | INE codes `"11"` / `"1105"` / `"110508"` |
| `postalCode` / `address` | String | `"2750-506"` |
| `latitude` / `longitude` | Number | `38.6994` / `-9.4241` |
| `imageUrl` / `imageUrls` / `imageCount` | String / Array / Integer | All photos |
| `floorplanUrls` / `videoUrl` / `virtualTourUrl` | Array / String | When published |
| `features` | Array | `["garage", "sea_view", "air_conditioning"]` |
| `divisions` | Array | Rooms with area in m² |
| `agentName` / `agentEmail` / `agentPhone` / `agentProfileUrl` | String | Consultant |
| `agencyName` / `agencyLicenseAmi` / `agencyEmail` / `agencyPhone` / `agencyProfileUrl` | String | Agency |
| `listedAt` | String | Date the listing entered the market, `"2026-11-09"` |
| `detailsScraped` | Boolean | `false` when only search data was saved |
| `scrapedAt` | String | ISO timestamp |

### Example output

```json
{
    "listingId": 820860,
    "reference": "C0545-00137",
    "url": "https://century21.pt/comprar/C0545-00137",
    "title": "Apartamento T1 no Centro Histórico de Cascais com Vista Mar e Garagem, para Venda",
    "transactionType": "sale",
    "availability": "available",
    "propertyType": "apartment",
    "propertyTypeLocal": "Apartamento",
    "typology": "T1",
    "bedrooms": 1,
    "bathrooms": 1,
    "parkingSpaces": 1,
    "price": 395000,
    "priceOnRequest": false,
    "currency": "EUR",
    "pricePerM2": 4202.13,
    "usefulAreaM2": 52,
    "grossAreaM2": 94,
    "landAreaM2": null,
    "floor": "3",
    "constructionYear": 1988,
    "condition": "used",
    "energyCertificate": "C",
    "district": "Lisboa",
    "municipality": "Cascais",
    "parish": "União das freguesias de Cascais e Estoril",
    "postalCode": "2750-506",
    "latitude": 38.6993938412542,
    "longitude": -9.42410225500296,
    "imageCount": 21,
    "agentName": "António Moreira",
    "agencyName": "CENTURY 21 Isidoro Alves IV",
    "agencyLicenseAmi": "10025",
    "listedAt": "2026-11-09",
    "detailsScraped": true
}
```

### Cost estimate

The actor charges **$0.002 per saved listing** plus **$0.005 per run start** (lower per-listing prices on higher Apify plans). The whole site of about 15,000 listings costs about $30 and takes about 30 minutes. A run of 20 listings costs about $0.045.

The run's usage cost only settles once the run reports SUCCEEDED. A dataset read during a run, or from a run that later failed, shows a cost far below the real total.

### What century21.pt does not publish

- **Reserved or under-offer status.** The site only shows listings that are not sold, so `availability` is always `available`. Compare runs to see removed listings.
- **Last-update date.** Only the date the listing entered the market (`listedAt`).
- **Energy certificate** on part of the listings (land, garages, and listings where the agent left it empty).
- **Neighbourhood name.** Only district, municipality and parish names are published.

### Typology

The typology comes from the listing title (`Apartamento T3`). When the title has none and the listing is a home (apartment, house, farm, palace or room), the actor uses T + number of bedrooms. Land, shops, garages and other non-residential listings have no typology and no bedroom count.

### Limitations

- The site returns 100 listings per search page and one detail page per listing, so a full read makes about 15,000 requests. It still finishes in well under an hour.
- The run fails, with the saved listings kept, if it collects fewer than 98% of the listings the site reports for the search.
- Data is taken from the public website and can change without notice.

### Related Scrapers

- [RE/MAX Portugal Scraper](https://apify.com/studio-amba/remax-pt-scraper) - listings from remax.pt
- [Hall Portugal Scraper](https://apify.com/studio-amba/hall-pt-scraper) - Hall Rede Imobiliária
- [Predimed Portugal Scraper](https://apify.com/studio-amba/predimed-pt-scraper) - Predimed Imobiliária
- [Casa Sapo Scraper](https://apify.com/studio-amba/casa-sapo-pt-scraper) - Portuguese property portal
- [Imovirtual Scraper](https://apify.com/studio-amba/imovirtual-scraper) - Portugal's large property portal

### 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

## `transactionTypes` (type: `array`):

Sale (Comprar), rent (Arrendar) or business transfer (Trespasse). Leave empty for all three.

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

Only these property types. Leave empty for all types.

## `district` (type: `string`):

Portuguese district or island, e.g. Lisboa, Porto, Setúbal, Faro, Ilha da Madeira. Accents optional. Leave empty for the whole country.

## `municipality` (type: `string`):

Municipality, e.g. Cascais, Sintra, Palmela, Vila Nova de Gaia. Accents optional.

## `parish` (type: `string`):

Parish, e.g. Pinhal Novo. Accents optional. Setting the municipality too makes the lookup exact.

## `bedrooms` (type: `array`):

Exact numbers of bedrooms as a JSON list, e.g. \[2, 3] for T2 and T3. Leave empty for any.

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

Minimum asking price, or monthly rent, in EUR.

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

Maximum asking price, or monthly rent, in EUR.

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

Order in which listings are collected. Only matters when Max items is lower than the number of matching listings. Leave empty for the most reliable full read (by listing id).

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

On by default, and needed for a complete record: loads each listing's own page for the description, energy certificate, land area, condition, construction year, floor, postal code and district/municipality/parish names. Turn off for a faster, cheaper read with only the search fields (price, typology, areas, photos, coordinates, agent).

## `language` (type: `string`):

century21.pt stores most titles and descriptions in Portuguese, English, Spanish and French. Falls back to Portuguese when a translation is missing.

## `startUrls` (type: `array`):

Optional century21.pt listing URLs, e.g. https://century21.pt/comprar/C0545-00137 or https://www.century21.pt/ref/C0545-00137. When set, only these listings are scraped and the filters are ignored. Max 500.

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

Maximum number of listings to save. century21.pt has about 15,000 listings in total, so the default reads the whole site.

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

century21.pt has no anti-bot wall for this data (see recon), so Apify's automatic proxy is enough.

## Actor input object example

```json
{
  "transactionTypes": [
    "sale"
  ],
  "includeDetails": true,
  "language": "pt",
  "maxItems": 20,
  "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 = {
    "transactionTypes": [
        "sale"
    ],
    "maxItems": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/century21-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 = {
    "transactionTypes": ["sale"],
    "maxItems": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/century21-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 '{
  "transactionTypes": [
    "sale"
  ],
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call studio-amba/century21-pt-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/century21-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/pcI8PGLasiU5ME6nF/builds/UfKSvzzYIqnic0wvx/openapi.json
