# Century 21 Portugal Property Scraper (`trovevault/century21-portugal-property-scraper`) Actor Discover public Century 21 Portugal property listings by location, operation, and property type. Extract descriptions, prices, areas, rooms, features, images, agency names, and URLs. - **URL**: https://apify.com/trovevault/century21-portugal-property-scraper.md - **Developed by:** [Trove Vault](https://apify.com/trovevault) (community) - **Categories:** Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $0.85 / 1,000 listings 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 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 ```json { "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 ```json { "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 ```bash curl -X POST "https://api.apify.com/v2/acts/trovevault~century21-portugal-property-scraper/runs" \ -H "Authorization: Bearer " \ -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: ```bash curl -X POST "https://api.apify.com/v2/acts/trovevault~century21-portugal-property-scraper/runs" \ -H "Authorization: Bearer " \ -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. # Actor input Schema ## `location` (type: `string`): City, region, or country to search. Use English names when possible, for example Lisbon, Portugal; Porto; Madrid; United States. City-level searches are usually more precise and stable than whole-country searches. ## `operation` (type: `string`): Choose whether to discover properties offered for sale or for rent. ## `propertyType` (type: `string`): Choose the type of property to discover. Use Any to return the broadest listing set supported by Century 21 Portugal. ## `maxItems` (type: `integer`): Maximum number of property listings to return. Use smaller values for quick checks and higher values for broader market discovery. ## `datasetId` (type: `string`): Optional Apify dataset ID to append each saved listing to, in addition to this run's default dataset. Use this when chaining multiple discovery actors into one shared dataset. ## `runId` (type: `string`): Optional external or Apify run ID copied into each output row and RUN\_SUMMARY. Use this to trace listings back to a parent workflow run. ## Actor input object example ```json { "location": "Lisbon, Portugal", "operation": "sale", "propertyType": "apartment", "maxItems": 3 } ``` # Actor output Schema ## `dataset` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "location": "Lisbon, Portugal" }; // Run the Actor and wait for it to finish const run = await client.actor("trovevault/century21-portugal-property-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "location": "Lisbon, Portugal" } # Run the Actor and wait for it to finish run = client.actor("trovevault/century21-portugal-property-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "location": "Lisbon, Portugal" }' | apify call trovevault/century21-portugal-property-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=trovevault/century21-portugal-property-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Century 21 Portugal Property Scraper", "description": "Discover public Century 21 Portugal property listings by location, operation, and property type. Extract descriptions, prices, areas, rooms, features, images, agency names, and URLs.", "version": "0.1", "x-build-id": "YVChHfPqD6UnaRstv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/trovevault~century21-portugal-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-trovevault-century21-portugal-property-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/trovevault~century21-portugal-property-scraper/runs": { "post": { "operationId": "runs-sync-trovevault-century21-portugal-property-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/trovevault~century21-portugal-property-scraper/run-sync": { "post": { "operationId": "run-sync-trovevault-century21-portugal-property-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "location", "operation", "propertyType" ], "properties": { "location": { "title": "Location", "type": "string", "description": "City, region, or country to search. Use English names when possible, for example Lisbon, Portugal; Porto; Madrid; United States. City-level searches are usually more precise and stable than whole-country searches.", "default": "Lisbon, Portugal" }, "operation": { "title": "Operation", "enum": [ "sale", "rent" ], "type": "string", "description": "Choose whether to discover properties offered for sale or for rent.", "default": "sale" }, "propertyType": { "title": "Property Type", "enum": [ "any", "apartment", "house", "land", "commercial" ], "type": "string", "description": "Choose the type of property to discover. Use Any to return the broadest listing set supported by Century 21 Portugal.", "default": "apartment" }, "maxItems": { "title": "Maximum Items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of property listings to return. Use smaller values for quick checks and higher values for broader market discovery.", "default": 3 }, "datasetId": { "title": "Dataset ID", "type": "string", "description": "Optional Apify dataset ID to append each saved listing to, in addition to this run's default dataset. Use this when chaining multiple discovery actors into one shared dataset." }, "runId": { "title": "Run ID", "type": "string", "description": "Optional external or Apify run ID copied into each output row and RUN_SUMMARY. Use this to trace listings back to a parent workflow run." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```