# Propertyfinder Reviews Scraper (`getdataforme/propertyfinder-reviews-scraper`) Actor Automate the extraction of property reviews from Propertyfinder with this Apify Actor, designed for reliable data collection. Key features include customizable inputs, high-quality output, multi-language support, and seamless integration into market research or competitive intelligence efforts.... - **URL**: https://apify.com/getdataforme/propertyfinder-reviews-scraper.md - **Developed by:** [GetDataForMe](https://apify.com/getdataforme) (community) - **Categories:** AI, Automation, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $9.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 ## README.md ### Propertyfinder Reviews Scraper #### Introduction The **Propertyfinder Reviews Scraper** is an Apify Actor designed to efficiently extract reviews from property listings on Propertyfinder's website. This tool provides valuable insights into user feedback, helping businesses and individuals make informed decisions based on community opinions. #### Features - **Automated Data Extraction**: Seamlessly scrape review data using a pre-configured CheerioCrawler template. - **High-Quality Data**: Ensures accurate and reliable extraction of reviews with detailed scoring metrics. - **Customizable Inputs**: Allows users to specify start URLs and limit the number of items scraped. - **Multi-Language Support**: Captures translations for multilingual insights. - **User-Friendly Interface**: Easy setup and execution on the Apify platform. #### Input Parameters Table | Parameter | Type | Required | Description | Example | |-------------|---------|----------|-----------------------------------------------------------------------------|----------------------------------------------------------------------------------------------| | startUrls | array | Yes | URLs to begin scraping from. | `[{"url": "https://www.propertyfinder.ae/en/area-insights/dubai/dubai-marina-al-majara-towers-al-majara-2#reviews"}]` | | maxItems | integer | No | Maximum number of items to scrape. | `10` | #### Example Usage ##### Input JSON ```json { "startUrls": [ { "url": "https://www.propertyfinder.ae/en/area-insights/dubai/dubai-marina-al-majara-towers-al-majara-2#reviews" } ], "maxItems": 10 } ```` ##### Output JSON ```json [ { "location_id": 50, "location_name": "Dubai Marina", "location_type": "COMMUNITY", "title": "Dubai Marina", "body": "Dubai Marina is one of the best communities in Dubai", "user_id": "2546533", "user_name": "Yosef Koka", "date": "10 days ago", "language": "en", "scores": { "family_friendly": 5, "noise_traffic": 1, "connectivity_commute": 5, "great_for_walking": 5, "greenery_parks": 2, "overall_score": 3.6 }, "translations": [ { "language": "ar", "title": "\u062f\u0628\u064a \u0645\u0627\u0631\u064a\u0646\u0627", "body": "\u062f\u0628\u064a \u0645\u0627\u0631\u064a\u0646\u0627 \u0647\u064a \u0648\u0627\u062d\u062f\u0629 \u0645\u0646 \u0623\u0641\u0636\u0644 \u0627\u0644\u0645\u062c\u0645\u0639\u0627\u062a \u0627\u0644\u0633\u0643\u0646\u064a\u0629 \u0641\u064a \u062f\u0628\u064a." } ] } ] ``` #### Use Cases - **Market Research and Analysis**: Gain insights into market trends and customer preferences. - **Competitive Intelligence**: Monitor competitors' property reviews to identify strengths and weaknesses. - **Price Monitoring**: Track pricing trends based on user feedback. - **Content Aggregation**: Aggregate content for blogs or reports. - **Academic Research**: Use data for studies in urban development or real estate markets. - **Business Automation**: Automate the collection of customer feedback for business strategies. #### Installation and Usage 1. Search for "Propertyfinder Reviews Scraper" in the Apify Store. 2. Click "Try for free" or "Run". 3. Configure input parameters as needed. 4. Click "Start" to begin extraction. 5. Monitor progress in the log. 6. Export results in your preferred format (JSON, CSV, Excel). #### Output Format The output is a JSON array of review objects, each containing: - `location_id`: Unique identifier for the location. - `location_name`: Name of the property or community. - `location_type`: Type of location (e.g., COMMUNITY). - `title`: Title of the review. - `body`: Main content of the review. - `user_id`: Identifier for the user who posted the review. - `user_name`: Username of the reviewer. - `date`: Date when the review was posted. - `language`: Language of the review. - `scores`: Object containing various scores (e.g., family\_friendly, noise\_traffic). - `translations`: Array of translations for multilingual support. #### Error Handling The Actor is designed to handle common errors such as network issues or changes in website structure. If an error occurs, it will be logged, and the process may retry based on configuration settings. #### Rate Limiting and Best Practices To avoid being blocked by Propertyfinder's servers: - Respect rate limits by configuring appropriate delays between requests. - Use a pool of rotating IP addresses if necessary. - Monitor logs for any signs of blocking or throttling. #### Limitations and Considerations - The Actor is tailored for Propertyfinder's website structure; changes in the site may require updates to the scraper. - Ensure compliance with Propertyfinder's terms of service when using this tool. ### Support For custom/simplified outputs or bug reports, please contact: - Email: support@getdataforme.com - Subject line: "custom support" - Contact form: [Get Data For Me](https://getdataforme.com/contact/) We're here to help you get the most out of this Actor! *** ## Description Maximize insights with the **Propertyfinder Reviews Scraper**, an Apify Actor designed for automated, reliable extraction of property reviews. Key features include customizable input parameters, high-quality data output, and multi-language support. Ideal for market research, competitive intelligence, and business automation. Start extracting valuable data today on the Apify platform! # Actor input Schema ## `startUrls` (type: `array`): URLs to start with. ## `maxItems` (type: `integer`): Maximum number of items to scrape. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.propertyfinder.ae/en/area-insights/dubai/dubai-marina-al-majara-towers-al-majara-2#reviews" } ], "maxItems": 10 } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.propertyfinder.ae/en/area-insights/dubai/dubai-marina-al-majara-towers-al-majara-2#reviews" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("getdataforme/propertyfinder-reviews-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 = { "startUrls": [{ "url": "https://www.propertyfinder.ae/en/area-insights/dubai/dubai-marina-al-majara-towers-al-majara-2#reviews" }] } # Run the Actor and wait for it to finish run = client.actor("getdataforme/propertyfinder-reviews-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 '{ "startUrls": [ { "url": "https://www.propertyfinder.ae/en/area-insights/dubai/dubai-marina-al-majara-towers-al-majara-2#reviews" } ] }' | apify call getdataforme/propertyfinder-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getdataforme/propertyfinder-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Propertyfinder Reviews Scraper", "description": "Automate the extraction of property reviews from Propertyfinder with this Apify Actor, designed for reliable data collection. Key features include customizable inputs, high-quality output, multi-language support, and seamless integration into market research or competitive intelligence efforts....", "version": "0.0", "x-build-id": "m2xhRPsnZohWhhxLA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getdataforme~propertyfinder-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getdataforme-propertyfinder-reviews-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/getdataforme~propertyfinder-reviews-scraper/runs": { "post": { "operationId": "runs-sync-getdataforme-propertyfinder-reviews-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/getdataforme~propertyfinder-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-getdataforme-propertyfinder-reviews-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", "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "URLs to start with.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of items to scrape.", "default": 10 } } }, "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 } } } } } } } } } } ```