# Remax Scraper Residential (`dadhalfdev/remax-scraper-residential`) Actor Scrape residential property listings from Remax Portugal. Ideal for real estate market research, property investment analysis, or anyone needing structured data about properties in Portugal. - **URL**: https://apify.com/dadhalfdev/remax-scraper-residential.md - **Developed by:** [Marco Rodrigues](https://apify.com/dadhalfdev) (community) - **Categories:** Real estate, Automation, Other - **Stats:** 11 total users, 2 monthly users, 96.8% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## 🏠 Remax Residential Scraper Scraper (Per Event) Scrape residential property listings from Remax Portugal. Ideal for real estate market research, property investment analysis, or anyone needing structured data about properties in Portugal. ### ✨ Features - **Comprehensive Property Types**: All residential property types including apartments, houses, studios, farms, land, garages, and more - **Extracts Complete Property Data**: - Property details and pricing information - Property images - Number of bedrooms, bathrooms, and rooms - Area measurements (total, living, lot, built) - Price per square meter - Agent and office information - Property descriptions - Location and address details - Energy efficiency ratings - Market status and listing information ### 🚀 Usage #### Required Input Parameters | Parameter | Type | Description | Required | Options | | ------------------ | ------- | ----------------------------------------------- | -------- | ----------------------- | | `search_term` | String | Location to search for properties (city, province, municipality, etc.) | ✅ Yes | Any Portuguese location | #### Optional Input Parameters | Parameter | Type | Description | Required | Options | | ------------------ | ------- | ----------------------------------------------- | -------- | ----------------------- | | `rent_or_buy` | String | Whether to search for properties to rent or buy | ❌ No | "Buy", "Rent" (default: "Buy") | | `property_types` | Array | One or more property types to include in the search | ❌ No | See options below (default: ["All"]) | | `rooms` | String | Number of rooms to search for | ❌ No | "Any", "1+", "2+", "3+", "4+", "5+" (default: "Any") | | `max_price` | Integer | Maximum price filter in euros | ❌ No | Minimum: 10, Default: 1000000 | | `min_price` | Integer | Minimum price filter in euros | ❌ No | Minimum: 1, Default: 100 | | `min_area` | Integer | Minimum area filter in square meters | ❌ No | Minimum: 0, Default: 20 | | `sort_by` | String | Sort results by | ❌ No | See options below (default: "Most recent") | | `max_properties` | Integer | Maximum number of properties to scrape | ❌ No | Range: 20-2000, Default: 100 | #### Sort Options - **Most recent**: Sort by most recently updated (default) - **Lowest price**: Sort by price ascending - **Highest price**: Sort by price descending - **Highest reduction**: Sort by highest price reduction - **Lowest reduction**: Sort by lowest price reduction - **Highest area**: Sort by largest area #### Property Types Available - **All**: All residential properties - **Apartament**: Apartments - **Studio**: Studio apartments - **House**: Houses - **Building**: Buildings - **Land**: Land plots - **Manor House**: Manor houses (Solar) - **Duplex**: Duplex properties - **Garage**: Garages - **Others - Residential**: Other residential properties - **Farm**: Farms (Quinta) - **Small Mansion**: Small mansions (Palacete) - **Storage Room**: Storage rooms (Arrecadação) #### Example Input ```json { "search_term": "Arronches", "rent_or_buy": "Buy", "property_types": ["All"], "rooms": "Any", "max_price": 100000, "min_price": 100, "min_area": 20, "sort_by": "Most recent", "max_properties": 100 } ```` ### 📊 Output The actor stores results in the default dataset, with each property represented as a JSON object containing: #### Core Property Information - `id`: Unique property identifier - `propertyLink`: Direct link to the property listing on Remax - `propertyPicture`: URL to the property's main image - `listingType`: Type of property (e.g., "Quinta", "Terreno", "Apartamento") - `listingStatus`: Current listing status (e.g., "Ativo") - `listingClass`: Property class (e.g., "Habitação") - `smallDescription`: Short description of the property - `listingMetatagDescription`: Meta description for the listing #### Location Information - `address`: Property address - `zipCode`: Postal code - `localZone`: Local zone/area - `doorNumber`: Door number (if applicable) - `apartmentNumber`: Apartment number (if applicable) #### Pricing Information - `listingPrice`: Property price in euros (float) - `previousPrice`: Previous price if there was a reduction (float) - `priceReductionPercentage`: Price reduction percentage (float) - `pricePerSqM`: Price per square meter in euros (float) #### Property Details - `totalArea`: Total area in square meters (float) - `areaAutocomplete`: Area for autocomplete (float) - `livingArea`: Living area in square meters (float) - `lotSize`: Lot size in square meters (float) - `builtArea`: Built area in square meters (float) - `totalRooms`: Total number of rooms (integer) - `numberOfBedrooms`: Number of bedrooms (integer) - `numberOfBathrooms`: Number of bathrooms (integer) - `numberOfWC`: Number of WC/toilets (integer) - `garageSpots`: Number of garage spots (integer) - `constructionYear`: Year of construction (integer) #### Property Features - `landRegister`: Land register number - `conservationStatus`: Conservation status - `garageType`: Type of garage - `energyEfficiencyLevel`: Energy efficiency level (e.g., "NC", "A", "B") - `hasVTour`: Whether property has virtual tour (boolean) - `hasVideo`: Whether property has video (boolean) - `hasMultimedia`: Whether property has multimedia (boolean) - `isActive`: Whether listing is active (boolean) - `isOpportunity`: Whether property is marked as opportunity (boolean) - `isGreatOpportunity`: Whether property is marked as great opportunity (boolean) - `isBankAppraisalIncluded`: Whether bank appraisal is included (boolean) - `isMultipleProposal`: Whether multiple proposals are accepted (boolean) #### Market Information - `marketStatus`: Market status (e.g., "Novo para o Mercado") - `marketDays`: Number of days on the market (integer) - `publishDate`: Publication date (ISO 8601 format) - `modified`: Last modification date (ISO 8601 format) #### Agent and Office Information - `userName`: Agent name - `userCellPhoneTrimmed`: Agent cell phone number - `userTeamName`: Agent team name - `userAgencyPhoneNumber`: Agency phone number - `officeName`: Office name - `userLink`: Direct link to agent profile on Remax #### Additional Information - `whatsAppChatLink`: WhatsApp chat link for the property #### Example Output ```json { "id": 7017498, "propertyLink": "https://remax.pt/en/imoveis/venda-terreno-tarronches-assuncao/120581172-23", "propertyPicture": "https://i.maxwork.pt/l-view/listings/12058/7017498/a86feee0-4ed0-41d6-8688-bf15e148f895.jpg", "zipCode": "7341-909", "localZone": "Portalegre", "address": "Coutada", "publishDate": "2025-10-02T16:34:24.057", "modified": "2025-10-08T16:52:41.847", "smallDescription": "Terreno para venda", "listingMetatagDescription": "Terreno rústico com 0,9250ha, situado em Coutada (concelho de Arronches), com acesso pela N246.", "listingPrice": 10000.0, "previousPrice": null, "priceReductionPercentage": null, "listingType": "Terreno", "listingStatus": "Ativo", "marketStatus": "Novo para o Mercado", "totalArea": null, "areaAutocomplete": 9250.0, "livingArea": null, "lotSize": 9250.0, "builtArea": null, "landRegister": "205", "conservationStatus": null, "garageType": null, "energyEfficiencyLevel": "NC", "listingClass": "Habitação", "hasVTour": false, "hasVideo": false, "isActive": false, "constructionYear": null, "pricePerSqM": null, "garageSpots": 0, "hasMultimedia": false, "isOpportunity": false, "isGreatOpportunity": false, "isBankAppraisalIncluded": false, "isMultipleProposal": false, "doorNumber": null, "apartmentNumber": null, "totalRooms": null, "numberOfBedrooms": null, "numberOfWC": null, "numberOfBathrooms": null, "whatsAppChatLink": "https://rply.link/l/rtyDtiEDxh", "marketDays": 11, "userName": "Ana Bragança", "userCellPhoneTrimmed": "+351963951797", "userTeamName": null, "userAgencyPhoneNumber": "+351 245 337 406", "officeName": "RE/MAX Portalegre", "userLink": "https://remax.pt/en/agente/ana-braganca/120581172" } ``` ### 💰 Pricing - **Start Cost**: $0.1 per actor run - **Per Result**: $0.005 per property result ### ⚠️ Important Usage Rules - **Search Language**: You need to search for places in Portuguese. The `search_term` parameter should be provided in Portuguese (e.g., "Lisboa", "Porto", not "Lisbon", "Oporto"). - **Geographic Limitation**: You can only scrape places in Portugal. This scraper is designed specifically for Remax Portugal and will only return results for Portuguese locations. # Actor input Schema ## `search_term` (type: `string`): Search for province, city, municipality, or specific location ## `max_price` (type: `integer`): Maximum price filter in euros ## `min_price` (type: `integer`): Minimum price filter in euros ## `min_area` (type: `integer`): Minimum area filter in square meters ## `rent_or_buy` (type: `string`): Whether to search for properties to rent or buy ## `rooms` (type: `string`): Number of rooms to search for ## `sort_by` (type: `string`): Sort by option ## `max_properties` (type: `integer`): Maximum number of properties to scrape ## `property_types` (type: `array`): One or more property types to include in the search ## Actor input object example ```json { "search_term": "Lisboa", "max_price": 1000000, "min_price": 100, "min_area": 20, "rent_or_buy": "Buy", "rooms": "Any", "sort_by": "Most recent", "max_properties": 100, "property_types": [ "All" ] } ``` # Actor output Schema ## `overview` (type: `string`): Table view using the dataset 'overview' view. ## `results` (type: `string`): All items from the default dataset without view transformation. # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("dadhalfdev/remax-scraper-residential").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 = {} # Run the Actor and wait for it to finish run = client.actor("dadhalfdev/remax-scraper-residential").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 '{}' | apify call dadhalfdev/remax-scraper-residential --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=dadhalfdev/remax-scraper-residential", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Remax Scraper Residential", "description": "Scrape residential property listings from Remax Portugal. Ideal for real estate market research, property investment analysis, or anyone needing structured data about properties in Portugal.", "version": "0.1", "x-build-id": "AKS9nSJCgrHxbhErz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dadhalfdev~remax-scraper-residential/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dadhalfdev-remax-scraper-residential", "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/dadhalfdev~remax-scraper-residential/runs": { "post": { "operationId": "runs-sync-dadhalfdev-remax-scraper-residential", "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/dadhalfdev~remax-scraper-residential/run-sync": { "post": { "operationId": "run-sync-dadhalfdev-remax-scraper-residential", "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": [ "search_term" ], "properties": { "search_term": { "title": "Search term", "type": "string", "description": "Search for province, city, municipality, or specific location", "default": "Lisboa" }, "max_price": { "title": "Maximum Price", "minimum": 10, "type": "integer", "description": "Maximum price filter in euros", "default": 1000000 }, "min_price": { "title": "Minimum Price", "minimum": 1, "type": "integer", "description": "Minimum price filter in euros", "default": 100 }, "min_area": { "title": "Minimum Area", "minimum": 0, "type": "integer", "description": "Minimum area filter in square meters", "default": 20 }, "rent_or_buy": { "title": "Rent or Buy", "enum": [ "Buy", "Rent" ], "type": "string", "description": "Whether to search for properties to rent or buy", "default": "Buy" }, "rooms": { "title": "Rooms", "enum": [ "Any", "1+", "2+", "3+", "4+", "5+" ], "type": "string", "description": "Number of rooms to search for", "default": "Any" }, "sort_by": { "title": "Sort by", "enum": [ "Most recent", "Lowest price", "Highest price", "Highest reduction", "Lowest reduction", "Highest area" ], "type": "string", "description": "Sort by option", "default": "Most recent" }, "max_properties": { "title": "Maximum Properties", "minimum": 20, "maximum": 2000, "type": "integer", "description": "Maximum number of properties to scrape", "default": 100 }, "property_types": { "title": "Property Types", "uniqueItems": true, "type": "array", "description": "One or more property types to include in the search", "items": { "type": "string", "enum": [ "All", "Apartament", "Studio", "House", "Building", "Land", "Manor House", "Duplex", "Garage", "Others - Residential", "Farm", "Small Mansion", "Storage Room" ], "enumTitles": [ "All", "Apartament", "Studio", "House", "Building", "Land", "Manor House", "Duplex", "Garage", "Others - Residential", "Farm", "Small Mansion", "Storage Room" ] }, "default": [ "All" ] } } }, "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 } } } } } } } } } } ```