# πΆπ¦ Property Finder Qatar Scraper | Property Listings (`misterkhan/propertyfinder-qatar-scraper`) Actor
From $0.75/1K. Extract property listings from Property Finder Qatar (propertyfinder.qa) across Doha, Lusail & The Pearl β prices in QAR, beds, area & photos.
- **URL**: https://apify.com/misterkhan/propertyfinder-qatar-scraper.md
- **Developed by:** [Khan](https://apify.com/misterkhan) (community)
- **Categories:** Real estate, AI, Automation
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $0.75 / 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.
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
### πΆπ¦ Property Finder Qatar Scraper
Extract structured real estate listings from Property Finder Qatar (propertyfinder.qa), the premier property marketplace across Doha, Lusail, The Pearl, Al Wakrah, and West Bay. Collect comprehensive property data including asking prices in QAR, bedrooms, bathrooms, living area (mΒ²), property types, developer information, broker contact details, and direct listing links.
***
### What does Property Finder Qatar Scraper do?
Property Finder Qatar is the top-tier property portal in Qatar, connecting buyers, tenants, and institutional investors with licensed real estate agencies, property developers, and verified brokers.
This Actor extracts structured property listings directly from Property Finder Qatar search feeds:
- **Sale & Rental Properties**: Apartments, waterfront villas, penthouses, townhouses, duplexes, plots, and commercial offices.
- **Detailed Specifications**: Living space (mΒ²), bedroom counts, bathroom counts, furnishing status, and property subtype.
- **Financial Details**: Sale prices and rental rates in QAR, price per square meter metrics, and payment terms.
- **Agent & Broker Attribution**: Agent names, agency/broker company names, office phone numbers, WhatsApp contact links, and broker logos.
- **Geographic Precision**: Municipality, community, district, and project location trees across Qatar.
***
### Why scrape Property Finder Qatar?
- **Qatar Real Estate Valuation**: Track asking prices, yields, and luxury waterfront valuations across The Pearl-Qatar, Lusail Marina District, West Bay Lagoon, and Al Waab.
- **Expatriate & Freehold Zone Intelligence**: Monitor residential supply and occupancy in designated foreign freehold zones.
- **Broker & Lead Generation**: Discover active brokerage firms, licensed brokers, and direct phone/WhatsApp contact information.
- **PropTech & Investment Models**: Ingest clean, structured Qatari real estate feeds for algorithmic valuation models (AVMs) and portfolio tracking.
***
### How to scrape Property Finder Qatar listings
1. **Find your search URL on Property Finder Qatar**: Visit `https://www.propertyfinder.qa` and select your location, transaction type (buy or rent), and filters.
2. **Copy the search URL**: Copy the full URL from your browser address bar (e.g. `https://www.propertyfinder.qa/en/buy/properties-for-sale.html`).
3. **Configure the Actor**: Paste the search URL into the **Start URLs** field in the Apify Console.
4. **Set Max Results**: Specify the total number of property listings you want to collect.
5. **Run the Actor**: Click **Start**. The Actor streams live results into your default dataset in real time.
6. **Export your data**: Download your structured property listings in JSON, CSV, Excel, XML, or Parquet.
***
### Input Configuration
The Actor accepts the following input parameters:
**π `location`** β search city or region in Qatar (e.g. `Doha`). Optional when `startUrls` is provided
**Start URLs** (`startUrls`):
One or more Property Finder Qatar search or category URLs. Supports apartments, villas, and compounds for sale or rent across Doha, Lusail, The Pearl, and other municipalities.
*Default*: `https://www.propertyfinder.qa/en/buy/properties-for-sale.html`
**Max Results** (`maxItems`):
The maximum number of property listings to extract during the run.
*Default*: 40
***
### Input Examples
**Standard Qatar Properties for Sale Search**:
```json
{
"startUrls": [
{
"url": "https://www.propertyfinder.qa/en/buy/properties-for-sale.html"
}
],
"maxItems": 100
}
```
**Lusail Marina Apartments for Rent Search**:
```json
{
"startUrls": [
{
"url": "https://www.propertyfinder.qa/en/rent/apartments-for-rent.html"
}
],
"maxItems": 50
}
```
***
### Output Data & Sample Dataset
The Actor returns clean, normalized property listing objects directly to the Apify dataset:
```json
{
"id": "63807186",
"listing_id": "ZNN0E9TCWW6VPX5MN17HEK09QC",
"property_id": "63807186",
"title": "Investor Deal | Spacious 2BR with Unique Layout",
"price": 1800000,
"currency": "QAR",
"bedrooms": "2",
"bedrooms_value": 2,
"bathrooms": "3",
"bathrooms_value": 3,
"area": 140,
"area_sqm": 140,
"address": "Lusail Residence, Marina District, Lusail",
"location": "Lusail Residence, Marina District, Lusail",
"property_type": "Apartment",
"offering_type": "Residential for Sale",
"description": "An excellent investment opportunity in Marina Lusail, this modern 2-bedroom apartment offers strong rental yield potential and long-term capital appreciation. Featuring a spacious layout and contemporary design, it appeals to professionals and expatriates...",
"broker": {
"name": "GOLDEN KEY REAL ESTATE",
"phone": "+97433050298",
"email": "rami@goldenkey.qa",
"logo": "https://static.shared.propertyfinder.qa/media/images/client_logos/196/72fa8fd7-be10-4fb8-b0af-3c17cb8aec9d/260x200.jpg"
},
"agent": {
"name": "Anan Elhalabi",
"is_super_agent": true,
"image": "https://static.shared.propertyfinder.qa/media/images/agent_image/11755/d2b2f410-9777-497f-90bc-d956f8d8bd07/260x200.jpg"
},
"image_url": "https://static.shared.propertyfinder.qa/media/images/listing/ZNN0E9TCWW6VPX5MN17HEK09QC/198383cb-d8d1-45f1-9885-a1e5e01e29e5/668x452.jpg",
"url": "https://www.propertyfinder.qa/en/plp/buy/apartment-for-sale-lusail-marina-district-lusail-residence-63807186.html",
"portal": "propertyfinder.qa",
"country": "QA"
}
```
***
### Performance & Resource Utilization
- **Ultra-Lightweight Memory Footprint**: Runs on just 128 MB RAM, maximizing cost efficiency and throughput.
- **Asynchronous Pipeline**: Built with native async streaming, collecting records at high extraction rates.
- **Real-Time Data Streaming**: Listings are pushed to the Apify Dataset incrementally as pages are processed.
- **Resilient Transport Routing**: Features intelligent proxy management and automatic header emulation to ensure uninterrupted scraping.
***
### How much does it cost to scrape Property Finder Qatar?
This Actor uses transparent **Pay-Per-Event (Pay-Per-Result)** pricing with a **`$0.00` Actor run start fee**:
**π Free Plan** β $0.005 per item ($5.00 / 1K) with up to 40 items per run
**π₯ Bronze Plan** β $0.00135 per item ($1.35 / 1K) with unlimited scale
**π₯ Silver Plan** β $0.00095 per item ($0.95 / 1K) with unlimited scale
**π₯ Gold Plan** β $0.00075 per item ($0.75 / 1K) with highest priority execution
You only pay for successful listings extracted. Failed runs or empty pages incur zero platform cost.
***
### Integrations & Export Options
- **Direct Export**: Download collected data in JSON, CSV, XLSX, XML, or NDJSON.
- **Apify API & Webhooks**: Trigger downstream webhooks upon run completion to sync new listings to external endpoints.
- **Cloud & Automation Workflows**: Connect directly with Zapier, Make, Google Sheets, Airtable, Amazon S3, and PostgreSQL.
- **Python & Node.js Clients**: Ingest property feeds directly into data science workflows using `apify-client`.
***
***
### Using πΆπ¦ Property Finder Qatar Scraper | Property Listings β Input with AI Agents and Apify MCP
This Actor is optimized as an on-demand tool for AI developer assistants, Claude Desktop, Cursor, and autonomous agent workflows connected via the official Apify MCP Server (`https://mcp.apify.com`).
**Example prompts for Claude Desktop and Cursor:**
β’ Extract property listings in Doha and summarize pricing, bedrooms, and square meters.
β’ Search the latest listings and identify high-yield investment opportunities.
β’ Monitor new properties and compare square meter pricing.
**Agent tool advantages:**
β’ **Natural location input** β Pass simple city or region names (e.g. Doha) without constructing portal URLs.
β’ **Sub-second Rust streaming** β Returns live listings in 3 to 4 seconds to prevent agent tool-call timeouts.
β’ **Context-protective JSON** β Clean, normalized fields designed to fit efficiently inside LLM prompt context windows.
β’ **Pay-Per-Event pricing** β Only pay per extracted property listing with zero platform start fees.
### Frequently Asked Questions (FAQ)
**Can I scrape properties from across Qatar?**
Yes. You can paste search URLs covering Doha, Lusail, The Pearl, Al Rayyan, Al Wakrah, or West Bay.
**Does this scraper extract rental listings as well as sales?**
Yes. Simply paste a Property Finder Qatar search URL filtered for rentals (/rent/) and the Actor will collect rental listings and monthly rates.
**Are agent and broker phone numbers included?**
Yes. When provided on the listing, broker company details, agent names, and phone/WhatsApp contact information are captured.
**How many listings can I collect in a single run?**
You can configure `maxItems` to collect anywhere from a handful of records up to thousands across paginated search queries.
***
### Legal & Ethical Considerations
- The Actor only collects publicly accessible real estate listing data displayed on Propertyfinder.qa.
- Respect Property Finder's platform terms of service and avoid aggressive scraping rates.
- Adhere to applicable data privacy regulations when handling real estate broker and agent contact information.
***
### Support & Feedback
If you have feature requests, notice website layout changes, or need assistance configuring custom extraction workflows, open an issue in the Apify Console Actor Discussion tab.
***
### Additional Real Estate Scrapers
Explore related property and classified scrapers in the Crawlomatic ecosystem:
- **propertyfinder-scraper**: UAE leading property portal (propertyfinder.ae).
- **propertyfinder-saudi-scraper**: Saudi Arabia leading property portal (propertyfinder.sa).
- **funda-nl-scraper**: Netherlands leading property portal (funda.nl).
- **immoweb-be-scraper**: Belgium leading property portal (immoweb.be).
- **zameen-pakistan-scraper**: Pakistan leading property portal (zameen.com).
# Changelog
This Actor's version history is a separate document: https://apify.com/misterkhan/propertyfinder-qatar-scraper/changelog.md
# Actor input Schema
## `location` (type: `string`):
City, region, or municipality in Qatar (e.g. 'Doha'). Optional when startUrls is provided.
## `startUrls` (type: `array`):
Paste one or more Property Finder Qatar (propertyfinder.qa) search or property URLs (e.g., `https://www.propertyfinder.qa/en/buy/properties-for-sale.html`).
## `maxItems` (type: `integer`):
Maximum number of property listings to collect (Free plan runs collect up to 40 results per run; paid plans support unlimited results).
## Actor input object example
```json
{
"location": "Doha",
"startUrls": [
{
"url": "https://www.propertyfinder.qa/en/buy/properties-for-sale.html"
}
],
"maxItems": 20
}
```
# Actor output Schema
## `results` (type: `string`):
All extracted property listings from Property Finder Qatar (propertyfinder.qa).
## `usage_summary` (type: `string`):
Execution telemetry and extraction summary stored in the default key-value store.
# 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": "Doha",
"startUrls": [
{
"url": "https://www.propertyfinder.qa/en/buy/properties-for-sale.html"
}
],
"maxItems": 20
};
// Run the Actor and wait for it to finish
const run = await client.actor("misterkhan/propertyfinder-qatar-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": "Doha",
"startUrls": [{ "url": "https://www.propertyfinder.qa/en/buy/properties-for-sale.html" }],
"maxItems": 20,
}
# Run the Actor and wait for it to finish
run = client.actor("misterkhan/propertyfinder-qatar-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 '{
"location": "Doha",
"startUrls": [
{
"url": "https://www.propertyfinder.qa/en/buy/properties-for-sale.html"
}
],
"maxItems": 20
}' |
apify call misterkhan/propertyfinder-qatar-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"type": "http",
"url": "https://mcp.apify.com/?tools=fetch-actor-details,misterkhan/propertyfinder-qatar-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 ` 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/ScOUUIu5GqUskQHnr/builds/dJAwxGoM6somR44Jr/openapi.json