# Fazwaz Thailand Property Scraper — Sale & Rent (`maximedupre/fazwaz-scraper`) Actor Collect public FazWaz homes for sale or rent across Thailand. Get prices, property facts, places, photos, and public agent details for research or exports. - **URL**: https://apify.com/maximedupre/fazwaz-scraper.md - **Developed by:** [Maxime Dupré](https://apify.com/maximedupre) (community) - **Categories:** Real estate, Lead generation, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.95 / 1,000 overview 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 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/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 ### 🏠 FazWaz property data for Thailand FazWaz Scraper helps property researchers, agents, and investors collect public homes for sale or rent across Thailand. Get prices, property facts, places, photos, and public agent details in rows that are ready to review or export. - **[FazWaz Property Scraper](https://apify.com/maximedupre/fazwaz-scraper/examples/fazwaz-property-scraper)** — collect public FazWaz property listings. - **[Thailand Property Listings Scraper](https://apify.com/maximedupre/fazwaz-scraper/examples/thailand-property-listings-scraper)** — build a list of homes for sale across Thai provinces. - **[Thailand Rental Listings Scraper](https://apify.com/maximedupre/fazwaz-scraper/examples/thailand-rental-listings-scraper)** — collect homes for rent across Thai provinces. - **[Bangkok Property Scraper](https://apify.com/maximedupre/fazwaz-scraper/examples/bangkok-property-scraper)** — research sale or rental listings in Bangkok. - **[Phuket Property Scraper](https://apify.com/maximedupre/fazwaz-scraper/examples/phuket-property-scraper)** — research sale or rental listings in Phuket. - **[FazWaz Property Details Scraper](https://apify.com/maximedupre/fazwaz-scraper/examples/fazwaz-property-details-scraper)** — get full details from property URLs. - **[FazWaz Real Estate Market Scan](https://apify.com/maximedupre/fazwaz-scraper/examples/fazwaz-real-estate-market-scan)** — get listing-card data for a quick market scan. #### 📦 Returned data Each dataset row is one public FazWaz listing. It can include: - listing ID, title, canonical URL, sale or rent type, and source dates - price, original price, currency, THB and USD values, and price per square meter - property type, bedrooms, bathrooms, areas, floor, furnishing, and view - project, developer, address, province, district, subdistrict, and coordinates - estimated rent, rental yield, and maintenance fee when FazWaz shows enough data - description, photos, amenities, nearby places, ownership, and build facts in full-detail runs - public agent and agency names and phone details when shown - the province, results URL, or property URL that first found the listing Some fields can be empty when FazWaz does not show them. The fast market scan returns listing-card data. Full property details add the fields found on each property page. #### 🚀 Running the Actor 1. Open the Actor in Apify Console. 2. Choose one **Target**: Province search, Results URLs, or Property URLs. 3. Add the places or URLs you want to check. 4. For province searches, set sale or rent and any useful filters. 5. For province searches or results URLs, choose a fast market scan or full property details. 6. Set **Maximum listings**, run the Actor, and open the dataset. The Actor follows pages until it reaches your limit or runs out of matches. If inputs overlap, each listing is saved at most once in the run. #### ⚙️ Input - `target` — choose `province`, `resultsUrls`, or `propertyUrls`. - `provinces` — Thai province or place names, such as Bangkok or Phuket. - `transaction` — properties for `sale` or `rent` in a province search. - `minPrice` and `maxPrice` — asking price or monthly rent limits in THB. - `bedrooms`, `bathrooms`, `propertyTypes`, and `completion` — province search filters. - `order` — recommended, newest, lowest price, or highest price order. - `resultsUrls` — FazWaz search or results URLs; their source filters are kept. - `propertyUrls` — public FazWaz property-detail URLs. - `depth` — `overview` for a market scan or `detail` for full property details. - `maxResults` — the most listings to return from each province or results URL. ```json { "target": "province", "provinces": ["Bangkok", "Phuket"], "transaction": "sale", "propertyTypes": ["condo", "villa"], "completion": "both", "order": "newest", "depth": "overview", "maxResults": 100 } ```` Use one Target per run. Options for the other Targets are ignored. #### 📊 Output Results are saved in the default Apify dataset. Download them as JSON, CSV, Excel, XML, RSS, or HTML, or read them through the Apify API. ```json { "listingId": "U1884596", "listingUrl": "https://www.fazwaz.com/property-sales/2-bedroom-condo-for-sale-at-example-in-bangkok-u1884596", "title": "2 Bedroom Condo for Sale in Bangkok", "transaction": "sale", "propertyType": "Condo", "bedrooms": 2, "bathrooms": 2, "price": 6500000, "currency": "THB", "priceThb": 6500000, "province": "Bangkok", "district": "Watthana", "photos": ["https://images.fazwaz.com/example/property.jpg"], "discoveredFrom": "Bangkok" } ``` #### 💳 Pricing This Actor uses pay-per-event pricing. A saved market-scan listing uses the overview listing event. A saved full-detail listing uses the detail listing event. Inputs that fail, searches with no matches, and diagnostic work do not create listing events. Use **Maximum listings** and the data depth to control the size and type of your run. #### 🔌 Integrations Use Apify datasets, the API, schedules, webhooks, or Apify integrations to move the saved rows into your workflow. This video shows how to connect an Actor to other apps: https://www.youtube.com/watch?v=bNACk1\_S\_6w\&list=PLObrtcm1Kw6MUrlLNDbK9QRg8VDJg0gOW\&index=4 #### ❓ FAQ ##### Can I keep filters from a FazWaz results page? Yes. Choose **Results URLs** and paste the FazWaz results URL. The Actor keeps the filters in that URL. ##### Can I scrape one known property? Yes. Choose **Property URLs** and add its public FazWaz detail URL. This Target returns full property details. ##### Why are some fields empty? FazWaz does not show every field on every listing. Full-detail runs can add photos, descriptions, amenities, ownership, and other facts, but only when the source shows them. ##### Does the Actor need a FazWaz login? No. It collects public listings and does not ask for FazWaz login details. It does not collect private, removed, or account-only listings. ##### Can one run use different filter sets for each province? No. One province run uses one set of filters. Start a separate run for each filter set. You can also submit FazWaz results URLs that already hold the source filters you need. ##### Does this include every FazWaz listing? No completeness is promised. Results depend on public FazWaz pages, source access, your inputs, and the limits you set. ### 📝 Changelog - 0.0: Initial release. ### 🆘 Support For issues, questions, or feature requests, [file a ticket](https://console.apify.com/actors/maximedupre~fazwaz-scraper/issues) and I'll fix or implement it in less than 24h 🫡 ### 🔗 Related Actors - [ForRent Scraper](https://apify.com/maximedupre/forrent-scraper) — collect US rental listings, floor plans, amenities, and contact details from ForRent.com. - [Realtor Scraper](https://apify.com/maximedupre/realtor-scraper) — collect US sale, rent, sold, and pending listings from Realtor.com. - [Zillow Foreclosure & Pre-Foreclosure Scraper](https://apify.com/maximedupre/zillow-foreclosure-pre-foreclosure-scraper) — research public distressed-property listings on Zillow. - [Idealista Agency Scraper](https://apify.com/maximedupre/idealista-agency-scraper) — find real estate agencies shown on Idealista results pages. **Made with ❤️ by Maxime Dupré** # Actor input Schema ## `target` (type: `string`): Choose how to find FazWaz property listings. Use one Target per run. ## `provinces` (type: `array`): Enter one or more Thai province or place names, such as Bangkok or Phuket. Used only for the Province search Target. ## `transaction` (type: `string`): Choose whether to find properties for sale or for rent. Used only for the Province search Target. ## `minPrice` (type: `number`): Set the lowest asking price or monthly rent in Thai baht. Leave empty for no minimum. Used only for the Province search Target. ## `maxPrice` (type: `number`): Set the highest asking price or monthly rent in Thai baht. Leave empty for no maximum. Used only for the Province search Target. ## `bedrooms` (type: `array`): Choose the bedroom counts to include. Leave empty to include any count. Used only for the Province search Target. ## `bathrooms` (type: `array`): Choose the bathroom counts to include. Leave empty to include any count. Used only for the Province search Target. ## `propertyTypes` (type: `array`): Choose the property types to include. Leave empty to include all types. Used only for the Province search Target. ## `completion` (type: `string`): Choose completed properties, off-plan properties, or both. Used only for the Province search Target. ## `order` (type: `string`): Choose the order used by FazWaz. Used only for the Province search Target. ## `resultsUrls` (type: `array`): Add one or more FazWaz search or results page URLs. Filters in each URL are kept. Used only for the Results URLs Target. ## `propertyUrls` (type: `array`): Add one or more public FazWaz property-detail URLs. Each URL returns full property details. Used only for the Property URLs Target. ## `depth` (type: `string`): Choose a fast listing-card scan or full property details. Used only for the Province search and Results URLs Targets. ## `maxResults` (type: `integer`): Set the most listings to return from each province or results URL. The Actor pages through FazWaz results until it reaches this number or runs out of matches. ## Actor input object example ```json { "target": "province", "provinces": [ "Bangkok" ], "transaction": "sale", "minPrice": null, "maxPrice": null, "bedrooms": [], "bathrooms": [], "propertyTypes": [], "completion": "both", "order": "recommended", "depth": "overview", "maxResults": 100 } ``` # Actor output Schema ## `results` (type: `string`): Open the property listings in the default dataset. ## `csv` (type: `string`): Download the property listings as a CSV file. # 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 = { "target": "province", "provinces": [ "Bangkok" ] }; // Run the Actor and wait for it to finish const run = await client.actor("maximedupre/fazwaz-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 = { "target": "province", "provinces": ["Bangkok"], } # Run the Actor and wait for it to finish run = client.actor("maximedupre/fazwaz-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 '{ "target": "province", "provinces": [ "Bangkok" ] }' | apify call maximedupre/fazwaz-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=maximedupre/fazwaz-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Fazwaz Thailand Property Scraper — Sale & Rent", "description": "Collect public FazWaz homes for sale or rent across Thailand. Get prices, property facts, places, photos, and public agent details for research or exports.", "version": "0.0", "x-build-id": "Hyplj2qhacNOpoKVF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~fazwaz-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-fazwaz-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/maximedupre~fazwaz-scraper/runs": { "post": { "operationId": "runs-sync-maximedupre-fazwaz-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/maximedupre~fazwaz-scraper/run-sync": { "post": { "operationId": "run-sync-maximedupre-fazwaz-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": [ "target" ], "properties": { "target": { "title": "Target", "enum": [ "province", "resultsUrls", "propertyUrls" ], "type": "string", "description": "Choose how to find FazWaz property listings. Use one Target per run.", "default": "province" }, "provinces": { "title": "Thai provinces or places", "minItems": 1, "uniqueItems": true, "type": "array", "description": "Enter one or more Thai province or place names, such as Bangkok or Phuket. Used only for the Province search Target.", "items": { "type": "string", "minLength": 1 }, "default": [ "Bangkok" ] }, "transaction": { "title": "For sale or rent", "enum": [ "sale", "rent" ], "type": "string", "description": "Choose whether to find properties for sale or for rent. Used only for the Province search Target.", "default": "sale" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "number", "description": "Set the lowest asking price or monthly rent in Thai baht. Leave empty for no minimum. Used only for the Province search Target.", "default": null }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "number", "description": "Set the highest asking price or monthly rent in Thai baht. Leave empty for no maximum. Used only for the Province search Target.", "default": null }, "bedrooms": { "title": "Bedrooms", "uniqueItems": true, "type": "array", "description": "Choose the bedroom counts to include. Leave empty to include any count. Used only for the Province search Target.", "items": { "type": "string", "enum": [ "studio", "1", "2", "3", "4", "5+" ], "enumTitles": [ "Studio", "1 bedroom", "2 bedrooms", "3 bedrooms", "4 bedrooms", "5 or more bedrooms" ] }, "default": [] }, "bathrooms": { "title": "Bathrooms", "uniqueItems": true, "type": "array", "description": "Choose the bathroom counts to include. Leave empty to include any count. Used only for the Province search Target.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5+" ], "enumTitles": [ "1 bathroom", "2 bathrooms", "3 bathrooms", "4 bathrooms", "5 or more bathrooms" ] }, "default": [] }, "propertyTypes": { "title": "Property types", "uniqueItems": true, "type": "array", "description": "Choose the property types to include. Leave empty to include all types. Used only for the Province search Target.", "items": { "type": "string", "enum": [ "condo", "villa", "house", "townhouse", "apartment", "penthouse", "land" ], "enumTitles": [ "Condo", "Villa", "House", "Townhouse", "Apartment", "Penthouse", "Land" ] }, "default": [] }, "completion": { "title": "Completion", "enum": [ "both", "completed", "offPlan" ], "type": "string", "description": "Choose completed properties, off-plan properties, or both. Used only for the Province search Target.", "default": "both" }, "order": { "title": "Order", "enum": [ "recommended", "newest", "priceAsc", "priceDesc" ], "type": "string", "description": "Choose the order used by FazWaz. Used only for the Province search Target.", "default": "recommended" }, "resultsUrls": { "title": "FazWaz results URLs", "minItems": 1, "type": "array", "description": "Add one or more FazWaz search or results page URLs. Filters in each URL are kept. Used only for the Results URLs Target.", "items": { "type": "object", "properties": { "url": { "type": "string", "title": "URL", "description": "A public FazWaz search or results page URL.", "pattern": "^https?://(?:www\\.)?fazwaz\\.[^/]+/.+" } }, "required": [ "url" ], "additionalProperties": true } }, "propertyUrls": { "title": "FazWaz property URLs", "minItems": 1, "type": "array", "description": "Add one or more public FazWaz property-detail URLs. Each URL returns full property details. Used only for the Property URLs Target.", "items": { "type": "object", "properties": { "url": { "type": "string", "title": "URL", "description": "A public FazWaz property-detail page URL.", "pattern": "^https?://(?:www\\.)?fazwaz\\.[^/]+/.+" } }, "required": [ "url" ], "additionalProperties": true } }, "depth": { "title": "Data depth", "enum": [ "overview", "detail" ], "type": "string", "description": "Choose a fast listing-card scan or full property details. Used only for the Province search and Results URLs Targets.", "default": "overview" }, "maxResults": { "title": "Maximum listings", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Set the most listings to return from each province or results URL. The Actor pages through FazWaz results until it reaches this number or runs out of matches.", "default": 100 } } }, "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 } } } } } } } } } } ```