Century 21 Portugal Property Scraper

Discover public Century 21 Portugal property listings from buyer-facing inputs: location, operation, property type, and result limit. The Actor returns structured listing rows with descriptions, prices, area, price per square meter, rooms, main image, image gallery, features, agency or agent name, and listing URLs.

This is a discovery Actor. You do not need to provide search result URLs.

Why Use This Actor

Use this Actor when you need a clean real estate dataset from Century 21 Portugal without manually building search URLs or copying listings from the website.

It is useful for:

• real estate lead discovery by Portuguese city or region
• sale and rental inventory checks from the Century 21 Portugal network
• price and area comparison across public Century 21 listings
• monitoring agency supply in Lisbon, Porto, Faro, Braga, and other markets
• TroveVault pipelines that combine several property portals into one dataset

What It Extracts

Each dataset row can include:

• platform, listingId, title, and url
• operation and propertyType
• price, currency, priceText, and pricePerM2; hidden Century 21 prices are returned as priceText: "Price on request" while numeric price fields stay null
• areaM2, bedrooms, and bathrooms
• address, city, and country
• description
• features, such as elevator, parking, garage, balcony, terrace, garden, pool, air conditioning, virtual tour, or video
• sellerName
• mainImage and images
• listedAtText
• scrapedAt
• runId when supplied in the input

Fields are only populated when they are publicly visible in Century 21 Portugal listing data.

Input

{
  "location": "Lisbon, Portugal",
  "operation": "sale",
  "propertyType": "apartment",
  "maxItems": 3,
  "datasetId": "",
  "runId": ""
}

Input Fields

• location - City or city plus country to search. City-level searches are recommended for stable results, for example Lisbon, Portugal, Porto, or Faro.
• operation - Dropdown. Use sale for properties for sale or rent for rental listings.
• propertyType - Dropdown. Use any, apartment, house, land, or commercial.
• maxItems - Maximum number of listings to save. Use a small number for quick checks and a larger number for broader discovery.
• datasetId - Optional Apify dataset ID. When provided, each saved listing is also appended to that dataset, which is useful when combining several discovery Actors.
• runId - Optional workflow run ID. When provided, it is copied into each output row and the RUN_SUMMARY key-value record.

Output Example

{
  "platform": "Century 21 Portugal",
  "listingId": "C0223-08368",
  "title": "Three Bedroom in Olivais Lisbon",
  "url": "https://www.century21.pt/ref/C0223-08368",
  "operation": "sale",
  "propertyType": "apartment",
  "price": 310000,
  "currency": "EUR",
  "priceText": "310000 EUR",
  "pricePerM2": 4079,
  "areaM2": 75,
  "bedrooms": 3,
  "bathrooms": 1,
  "address": "Rua Doutor Jose Saraiva 12, Lisbon, Portugal",
  "city": "Lisbon",
  "country": "Portugal",
  "description": "Localizado nos Olivais, em Lisboa, podemos encontrar este T3 num predio com elevador...",
  "features": ["good light exposure", "elevator"],
  "sellerName": "CENTURY 21 Nacoes",
  "mainImage": "https://images.century21.pt/...",
  "images": ["https://images.century21.pt/..."],
  "listedAtText": "2025-07-27T00:00:00.000Z",
  "scrapedAt": "2026-07-24T10:30:00.000Z",
  "runId": "parent-workflow-run"
}

API Usage

curl -X POST "https://api.apify.com/v2/acts/trovevault~century21-portugal-property-scraper/runs" \
  -H "Authorization: Bearer <APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"location":"Lisbon, Portugal","operation":"sale","propertyType":"apartment","maxItems":3}'

To append rows to an existing dataset and tag them with a workflow run:

curl -X POST "https://api.apify.com/v2/acts/trovevault~century21-portugal-property-scraper/runs" \
  -H "Authorization: Bearer <APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"location":"Lisbon, Portugal","operation":"sale","propertyType":"apartment","maxItems":50,"datasetId":"YOUR_DATASET_ID","runId":"YOUR_PARENT_RUN_ID"}'

Notes And Limitations

• Use English values for operation and propertyType; the Actor maps them internally to Century 21 Portugal filters.
• City-level searches are more stable than whole-country searches.
• The Actor opens public listing detail pages to extract descriptions when Century 21 exposes them in listing metadata.
• When Century 21 shows Sob Consulta, the Actor returns priceText as Price on request and leaves numeric price fields empty.
• The Actor does not return private contact details and does not bypass logins, paywalls, or private contact flows.

Related Actors

• OLX Portugal Property Scraper
• Imovirtual Property Discovery Scraper
• CASA SAPO Property Discovery Scraper
• RE/MAX Portugal Property Scraper
• ERA Portugal Property Scraper

Changelog

0.1

• Initial Century 21 Portugal discovery Actor with dropdown operation/property type, optional pipeline IDs, description extraction, price-on-request labeling, image gallery extraction, price-per-square-meter calculation, and low-cost default test input.