# Thai Real Estate Scraper (`mai_amm/thai-real-estate-scraper`) Actor Scrape public Thailand property listings from DotProperty Thailand, LivingInsider, and DDProperty with prices, locations, project names, agent contacts, unit details, duplicate signals, and market summaries. - **URL**: https://apify.com/mai\_amm/thai-real-estate-scraper.md - **Developed by:** [wiseld\_squid](https://apify.com/mai_amm) (community) - **Categories:** Real estate, Lead generation, Travel - **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ## Thai Real Estate Scraper: Property Listings, Leads & Market Data Scrape public Thailand property listings for sale and rent from multiple real estate marketplaces. The Actor extracts normalized listing data, prices, price per sqm, project names, locations, floor and unit hints, public agent contacts, duplicate signals, deal scores, images, and run-level market summaries. ### Core Sources The production default focuses on the highest-value sources that worked reliably in smoke tests: - DotProperty Thailand - LivingInsider - DDProperty DotProperty supports detail-page enrichment with prices, project data, images, coordinates, transit hints, and public phone fields. LivingInsider is included for lead-rich Thai listing text, owner/agent hints, phone/LINE extraction, and unit/floor hints. DDProperty is included for search demand and broad market coverage; if detail pages are blocked, the Actor saves listing-card fallback records instead of dropping leads. Experimental/custom URL support is included for Hipflat, PropertyHub, Thailand-Property, Kaidee Property, FazWaz, RentHub, and KaiBaanThai. These are not enabled by default until source-specific parsers are hardened. ### Quick Start For most runs, keep the default source selection and change only these fields: - `transactionType`: choose sale, rent, or both. - `propertyType`: choose condo, house, land, or all supported property types. - `locations`: enter English location slugs such as `bangkok`, `phuket`, `pattaya`, `chiang-mai`, `chon-buri`, or `hua-hin`. - `maxItems`: set the number of listings you want. Use `startUrls` only when you want to crawl a specific marketplace search or listing page. ### What You Can Scrape - Sale and rent listings - Condo, house, land, and mixed property pages - Title, URL, listing ID, source, and source URL - Price, currency, area sqm, price per sqm - Bedrooms, bathrooms, floor, building, and unit number hints when publicly available - Project or condo name, location, address, and nearby BTS/MRT/ARL hints - Public phone, LINE, WhatsApp, email, agent, and agency fields when found - Images and canonical listing URLs - Duplicate keys and duplicate group IDs for cross-source listing research - Deal score and price signals - Monitoring changes across scheduled runs - Summary analytics by source, project, location, price, and price per sqm ### Output Views The run output links to three dataset views: - `Property listings`: normalized listing records with price, size, project, location, images, and quality signals. - `Agent and owner leads`: listings where public contact fields were found. - `Deal signals`: listings with price-per-sqm, duplicate keys, and deal scores for market research. ### Example Input ```json { "mode": "auto", "sources": ["dotproperty", "livinginsider", "ddproperty"], "transactionType": "sale", "propertyType": "condo", "locations": ["bangkok"], "maxItems": 100, "maxPagesPerSource": 3, "includeDetails": true, "includeContacts": true, "includeImages": true, "deduplicate": true, "proxyConfiguration": { "useApifyProxy": true } } ```` ### Output Example ```json { "recordType": "listing", "country": "TH", "market": "Thailand", "source": "dotproperty", "sourceName": "DotProperty Thailand", "listingId": "1234567", "url": "https://www.dotproperty.co.th/en/...", "title": "2BR condo near BTS Thong Lo", "transactionType": "sale", "propertyType": "condo", "projectName": "HQ by Sansiri", "location": "Bangkok", "price": 14500000, "currency": "THB", "areaSqm": 77.23, "pricePerSqm": 187751, "bedrooms": 2, "bathrooms": 2, "floor": "31", "unitNumber": "1208", "unitNumberConfidence": "high", "phone": "0812345678", "lineId": "@agent", "hasContact": true, "duplicateKey": "hq by sansiri|bangkok|condo|sale|31|77|14500000", "duplicateGroupId": "dup_ab12cd34ef", "dealScore": 60, "scrapedAt": "2026-05-05T12:00:00.000Z" } ``` ### Notes This Actor only targets public listing pages and public data visible in page HTML or embedded page data. It skips private areas such as login, account, profile, inbox, checkout, and member pages. Unit numbers are extracted only when they are publicly present in listing text. In Thailand, unit numbers are useful as a bonus signal, but the core product is property leads, duplicate detection, price per sqm, and market intelligence. Use scraped data responsibly and review each marketplace's terms for your use case. # Actor input Schema ## `mode` (type: `string`): Use recommended marketplace searches, or crawl only URLs you provide. ## `sources` (type: `array`): Recommended Thai real estate marketplaces to crawl in auto mode. These are the sources currently enabled for regular users. ## `transactionType` (type: `string`): Sale, rent, or both. ## `propertyType` (type: `string`): The primary property type to crawl. Condo, house, and land are supported by the recommended sources. ## `locations` (type: `array`): Locations to search. Use English slugs such as bangkok, phuket, pattaya, chiang-mai, chon-buri, or hua-hin. ## `startUrls` (type: `array`): Optional listing or detail URLs. Use this when you want to crawl a specific search page instead of the recommended auto search. ## `maxItems` (type: `integer`): Maximum property listing records to save. ## `maxPagesPerSource` (type: `integer`): Maximum listing pages to crawl per source/start URL. Use 0 to continue until max items or no next page. ## `includeDetails` (type: `boolean`): Open listing detail pages to enrich records with description, images, contacts, unit hints, and coordinates. ## `includeContacts` (type: `boolean`): Extract public phone, LINE, WhatsApp, email, agent, and agency fields when found in page text or embedded data. ## `includeImages` (type: `boolean`): Include public listing images found in cards, meta tags, and embedded page data. ## `deduplicate` (type: `boolean`): Generate duplicate keys and duplicate group IDs from project, location, floor, area, price, unit hints, and image fingerprints. ## `monitoring` (type: `boolean`): Compare listing price and availability with previous runs stored in the selected key-value store. ## `monitoringStoreName` (type: `string`): Named key-value store used to persist listing snapshots between runs. ## `maxConcurrency` (type: `integer`): Concurrent HTTP requests. Keep low for public marketplace pages. ## `requestDelayMs` (type: `integer`): Polite delay before each request. ## `proxyConfiguration` (type: `object`): Apify proxy configuration. Residential proxy can improve reliability for larger runs. ## Actor input object example ```json { "mode": "auto", "sources": [ "dotproperty", "livinginsider", "ddproperty" ], "transactionType": "sale", "propertyType": "condo", "locations": [ "bangkok" ], "startUrls": [ { "url": "https://www.dotproperty.co.th/en/condos-for-sale/bangkok" }, { "url": "https://www.ddproperty.com/en/condo-for-sale/in-bangkok-th10" } ], "maxItems": 100, "maxPagesPerSource": 3, "includeDetails": true, "includeContacts": true, "includeImages": true, "deduplicate": true, "monitoring": false, "monitoringStoreName": "thai-real-estate-monitoring", "maxConcurrency": 4, "requestDelayMs": 300, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (type: `string`): Main dataset with normalized property listings, prices, locations, contacts, unit hints, and deal signals. ## `leads` (type: `string`): Dataset view focused on listings with public contact fields. ## `deals` (type: `string`): Dataset view focused on listings with price or duplicate signals useful for market research. ## `summary` (type: `string`): Run-level summary with saved counts, source coverage, price stats, top projects, top locations, duplicate groups, and monitoring changes. ## `runOutput` (type: `string`): Compact machine-readable output object with dataset ID and summary. # 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 = { "mode": "auto", "sources": [ "dotproperty", "livinginsider", "ddproperty" ], "locations": [ "bangkok" ], "startUrls": [ { "url": "https://www.dotproperty.co.th/en/condos-for-sale/bangkok" }, { "url": "https://www.ddproperty.com/en/condo-for-sale/in-bangkok-th10" } ], "maxItems": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("mai_amm/thai-real-estate-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 = { "mode": "auto", "sources": [ "dotproperty", "livinginsider", "ddproperty", ], "locations": ["bangkok"], "startUrls": [ { "url": "https://www.dotproperty.co.th/en/condos-for-sale/bangkok" }, { "url": "https://www.ddproperty.com/en/condo-for-sale/in-bangkok-th10" }, ], "maxItems": 100, } # Run the Actor and wait for it to finish run = client.actor("mai_amm/thai-real-estate-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 '{ "mode": "auto", "sources": [ "dotproperty", "livinginsider", "ddproperty" ], "locations": [ "bangkok" ], "startUrls": [ { "url": "https://www.dotproperty.co.th/en/condos-for-sale/bangkok" }, { "url": "https://www.ddproperty.com/en/condo-for-sale/in-bangkok-th10" } ], "maxItems": 100 }' | apify call mai_amm/thai-real-estate-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=mai_amm/thai-real-estate-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Thai Real Estate Scraper", "description": "Scrape public Thailand property listings from DotProperty Thailand, LivingInsider, and DDProperty with prices, locations, project names, agent contacts, unit details, duplicate signals, and market summaries.", "version": "1.0", "x-build-id": "PSdJIRMzh2ufKR8qZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mai_amm~thai-real-estate-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mai_amm-thai-real-estate-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/mai_amm~thai-real-estate-scraper/runs": { "post": { "operationId": "runs-sync-mai_amm-thai-real-estate-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/mai_amm~thai-real-estate-scraper/run-sync": { "post": { "operationId": "run-sync-mai_amm-thai-real-estate-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": { "mode": { "title": "Mode", "enum": [ "auto", "urls" ], "type": "string", "description": "Use recommended marketplace searches, or crawl only URLs you provide.", "default": "auto" }, "sources": { "title": "Sources", "type": "array", "description": "Recommended Thai real estate marketplaces to crawl in auto mode. These are the sources currently enabled for regular users.", "items": { "type": "string", "enum": [ "dotproperty", "livinginsider", "ddproperty" ], "enumTitles": [ "DotProperty Thailand", "LivingInsider", "DDProperty" ] }, "default": [ "dotproperty", "livinginsider", "ddproperty" ] }, "transactionType": { "title": "Transaction type", "enum": [ "sale", "rent", "all" ], "type": "string", "description": "Sale, rent, or both.", "default": "sale" }, "propertyType": { "title": "Property type", "enum": [ "condo", "house", "land", "all" ], "type": "string", "description": "The primary property type to crawl. Condo, house, and land are supported by the recommended sources.", "default": "condo" }, "locations": { "title": "Locations", "type": "array", "description": "Locations to search. Use English slugs such as bangkok, phuket, pattaya, chiang-mai, chon-buri, or hua-hin.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional listing or detail URLs. Use this when you want to crawl a specific search page instead of the recommended auto search.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Maximum property listing records to save.", "default": 100 }, "maxPagesPerSource": { "title": "Max pages per source", "minimum": 0, "type": "integer", "description": "Maximum listing pages to crawl per source/start URL. Use 0 to continue until max items or no next page.", "default": 3 }, "includeDetails": { "title": "Include detail pages", "type": "boolean", "description": "Open listing detail pages to enrich records with description, images, contacts, unit hints, and coordinates.", "default": true }, "includeContacts": { "title": "Include public contacts", "type": "boolean", "description": "Extract public phone, LINE, WhatsApp, email, agent, and agency fields when found in page text or embedded data.", "default": true }, "includeImages": { "title": "Include images", "type": "boolean", "description": "Include public listing images found in cards, meta tags, and embedded page data.", "default": true }, "deduplicate": { "title": "Duplicate signals", "type": "boolean", "description": "Generate duplicate keys and duplicate group IDs from project, location, floor, area, price, unit hints, and image fingerprints.", "default": true }, "monitoring": { "title": "Monitoring mode", "type": "boolean", "description": "Compare listing price and availability with previous runs stored in the selected key-value store.", "default": false }, "monitoringStoreName": { "title": "Monitoring store name", "type": "string", "description": "Named key-value store used to persist listing snapshots between runs.", "default": "thai-real-estate-monitoring" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Concurrent HTTP requests. Keep low for public marketplace pages.", "default": 4 }, "requestDelayMs": { "title": "Request delay milliseconds", "minimum": 0, "type": "integer", "description": "Polite delay before each request.", "default": 300 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy configuration. Residential proxy can improve reliability for larger runs.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```