# Centaline + 28Hse Scraper – Hong Kong Property Listings (`claude_code_reviewer/centaline-scraper-en`) Actor Scrape Centaline and 28Hse (Hong Kong property) listings and full details for sale and rent: price, rent, saleable area, price per sqft, layout, floor and building age. No API or login. Export JSON/CSV/Excel for property market research. - **URL**: https://apify.com/claude\_code\_reviewer/centaline-scraper-en.md - **Developed by:** [Chad](https://apify.com/claude_code_reviewer) (community) - **Categories:** Agents, Real estate, Integrations - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 property 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 ## Centaline + 28Hse Scraper | Hong Kong Property Listings & Details (No API, No Login) Scrape public property data from **Centaline** (hk.centanet.com) and **28Hse** (28hse.com) — one Actor covering Hong Kong's two largest property listing platforms. Supports keyword search (buy/rent) and Centaline full property detail, two modes in total. Everything goes through public JSON/HTML endpoints — no login, no account, no API token required. --- ### What you get | Field | Type | Description | |---|---|---| | `property_id` | string | Unique property ID (Centaline refNo or 28Hse ID) | | `source_site` | string | Data source: `centanet` or `28hse` | | `title` | string \| null | Listing title (estate + building name) | | `district` | string \| null | District (e.g. Taikoo Shing, Kowloon City) | | `address` | string \| null | Street address | | `estate_name` | string \| null | Estate name | | `deal_type` | string | `buy` or `rent` | | `price` | number \| null | Sale price (HKD, sale listings only) | | `rent` | number \| null | Monthly rent (HKD, rental listings only) | | `currency` | string | Always `HKD` | | `area_sqft` | number \| null | Gross floor area (sq ft) | | `area_saleable` | number \| null | Saleable area (sq ft) | | `price_per_sqft` | number \| null | Price per sq ft (HKD / sq ft) | | `room_layout` | string \| null | Room count, e.g. `2 Bedrooms`, `Studio` | | `floor` | string \| null | Floor description, e.g. `High Floor Flat F` | | `direction` | string \| null | Facing direction, e.g. `Southwest` | | `building_age` | number \| null | Building age (years) | | `agent_name` | string \| null | Agent name | | `agent_phone` | string \| null | Agent phone number | | `image_urls` | string[] | Array of property image URLs | | `property_url` | string | Property detail page URL | | `source_mode` | string | `search` or `detail` | | `source_query` | string | The search keyword or property ID that produced this row | | `scraped_at` | string | Scrape timestamp (ISO 8601) | --- ### Modes | Mode | What it does | Input | Billing | |---|---|---|---| | `search` | Keyword search across both Centaline and 28Hse (or a single source) | `keywords[]` + `dealType` | $0.002 / row | | `detail` | Full Centaline property detail (requires a property ID) | `propertyIds[]` or `propertyUrls[]` | $0.008 / row | > **Note**: A transaction-record mode is planned for v1.1 and is not implemented yet. --- ### Input fields | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | auto-detected | `search` or `detail` | | `keywords` | string[] | — | Search keywords, e.g. `["太古城", "九龍城"]` | | `dealType` | string | `buy` | `buy` (for sale) or `rent` (for rent) | | `source` | string | `both` | `centanet`, `28hse`, or `both` | | `propertyIds` | string[] | — | Centaline property IDs, e.g. `["CLL467", "DAJ422"]` | | `propertyUrls` | string[] | — | Centaline property detail page URLs | | `bulkInput` | string | — | One keyword or ID per line, merged automatically | | `priceMin` | number | — | Minimum price (HKD) | | `priceMax` | number | — | Maximum price (HKD) | | `areaMin` | number | — | Minimum saleable area (sq ft) | | `maxItems` | number | 50 | Max results (cap 500) | --- ### Examples #### Example 1: Taikoo Shing sale search (both sites combined) ```json { "mode": "search", "keywords": ["太古城"], "dealType": "buy", "source": "both", "maxItems": 50 } ```` #### Example 2: Kowloon City rental search (Centaline only) ```json { "mode": "search", "keywords": ["九龍城", "馬頭圍"], "dealType": "rent", "source": "centanet", "priceMin": 15000, "priceMax": 30000, "maxItems": 100 } ``` #### Example 3: Fetch detail by property ID ```json { "mode": "detail", "propertyIds": ["CLL467", "DAJ422", "DAR140"], "maxItems": 100 } ``` *** ### Notes - Only publicly accessible data is scraped; no login or account is required. - Both Centaline's and 28Hse's public API endpoints are called via POST. - Due to how Crawlee schedules crawls, the same search term may de-duplicate across pages at the `property_id` level. - `search` mode pulls from both sites; `property_id` format differs between them (Centaline uses an alphanumeric code like `CLL467`, 28Hse uses a purely numeric ID). - `detail` mode only supports Centaline (28Hse has no public detail API). - Every Run charges a fixed **$0.005** start-up fee, then bills per item actually scraped. *** ### FAQ **Q: Can I search for-sale and for-rent listings at the same time?** A: Currently each Run can only use one `dealType`. Run it twice separately if you need both. **Q: Why did I get fewer search results than expected?** A: `maxItems` caps at 500. If your keyword is too broad, the scraper auto-stops after 5 consecutive pages with no new data, to save cost. **Q: How do I get a property ID for detail mode?** A: Extract it from a Centaline property page URL (format like `CLL467`), or run `search` mode first to get the `property_id` field, then paste those into `bulkInput`. **Q: Does 28Hse have price-per-sqft data?** A: Yes — the `price_per_sqft` field (saleable area price) is also populated for 28Hse search results. *** ### Disclaimer This Actor only collects **publicly visible** page data from each site, for research, analysis, and data-integration purposes. Users must comply with the Terms of Service of Centaline and 28Hse. Data accuracy is subject to the original websites — this Actor is not responsible for any investment decisions. *** *Centaline scraper, 28Hse scraper, Hong Kong property, HK real estate, property for sale Hong Kong, property for rent HK, Hong Kong housing data* # Actor input Schema ## `mode` (type: `string`): What do you want to scrape? Pick one mode, then fill in the matching fields below. ## `dealType` (type: `string`): Scrape for-sale or for-rent listings. ## `source` (type: `string`): Which site to scrape. both = combine both sites for the most complete coverage. ## `keywords` (type: `array`): Search keywords, e.g. estate names: Taikoo Shing, Sha Tin First City, South Horizons. One estate per keyword works best. ## `districts` (type: `array`): Search by district, e.g. Taikoo Shing, Causeway Bay, Sha Tin. Merged into the search together with the keywords above. ## `priceMin` (type: `integer`): Only keep properties with a sale price or monthly rent ≥ this amount. Leave blank for no limit. ## `priceMax` (type: `integer`): Only keep properties with a sale price or monthly rent ≤ this amount. Leave blank for no limit. ## `areaMin` (type: `integer`): Only keep properties with saleable area ≥ this value (sq ft). Leave blank for no limit. ## `propertyIds` (type: `array`): Centaline property refNo, e.g. CLL467, DAZ418. It's the segment after the last \_ in a Centaline detail page URL. ## `propertyUrls` (type: `array`): Full Centaline property URL, e.g. https://hk.centanet.com/findproperty/detail/太古城\_CLL467. The refNo is extracted automatically. ## `bulkInput` (type: `string`): One per line (press Enter for a new line). Treated as keywords in search mode, or refNo/property URLs in detail mode. Fastest way is to copy a whole column from Google Sheets. ## `maxItems` (type: `integer`): Max results per keyword × per source. More items = higher cost. Detail mode is not limited by this (bounded by the number of refNo values instead). ## `proxyConfiguration` (type: `object`): Both sites are friendly to datacenter requests; it works without a proxy by default. Enable only if you hit blocks (429) during heavy scraping. ## Actor input object example ```json { "mode": "search", "dealType": "buy", "source": "both", "keywords": [ "太古城" ], "maxItems": 50, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `dataset` (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 = { "mode": "search", "keywords": [ "太古城" ] }; // Run the Actor and wait for it to finish const run = await client.actor("claude_code_reviewer/centaline-scraper-en").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": "search", "keywords": ["太古城"], } # Run the Actor and wait for it to finish run = client.actor("claude_code_reviewer/centaline-scraper-en").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": "search", "keywords": [ "太古城" ] }' | apify call claude_code_reviewer/centaline-scraper-en --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=claude_code_reviewer/centaline-scraper-en", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Centaline + 28Hse Scraper – Hong Kong Property Listings", "description": "Scrape Centaline and 28Hse (Hong Kong property) listings and full details for sale and rent: price, rent, saleable area, price per sqft, layout, floor and building age. No API or login. Export JSON/CSV/Excel for property market research.", "version": "1.0", "x-build-id": "lAXIQWfEUI3dwGEZ4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/claude_code_reviewer~centaline-scraper-en/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-claude_code_reviewer-centaline-scraper-en", "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/claude_code_reviewer~centaline-scraper-en/runs": { "post": { "operationId": "runs-sync-claude_code_reviewer-centaline-scraper-en", "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/claude_code_reviewer~centaline-scraper-en/run-sync": { "post": { "operationId": "run-sync-claude_code_reviewer-centaline-scraper-en", "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": [ "search", "detail" ], "type": "string", "description": "What do you want to scrape? Pick one mode, then fill in the matching fields below.", "default": "search" }, "dealType": { "title": "🏠 Buy/Rent", "enum": [ "buy", "rent" ], "type": "string", "description": "Scrape for-sale or for-rent listings.", "default": "buy" }, "source": { "title": "📡 Data source", "enum": [ "both", "centanet", "28hse" ], "type": "string", "description": "Which site to scrape. both = combine both sites for the most complete coverage.", "default": "both" }, "keywords": { "title": "🔎 Keywords", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Search keywords, e.g. estate names: Taikoo Shing, Sha Tin First City, South Horizons. One estate per keyword works best.", "items": { "type": "string" } }, "districts": { "title": "📍 Districts", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Search by district, e.g. Taikoo Shing, Causeway Bay, Sha Tin. Merged into the search together with the keywords above.", "items": { "type": "string" } }, "priceMin": { "title": "💰 Min price (HKD)", "minimum": 0, "type": "integer", "description": "Only keep properties with a sale price or monthly rent ≥ this amount. Leave blank for no limit." }, "priceMax": { "title": "💰 Max price (HKD)", "minimum": 0, "type": "integer", "description": "Only keep properties with a sale price or monthly rent ≤ this amount. Leave blank for no limit." }, "areaMin": { "title": "📐 Min area (sq ft)", "minimum": 0, "type": "integer", "description": "Only keep properties with saleable area ≥ this value (sq ft). Leave blank for no limit." }, "propertyIds": { "title": "📦 Property ID (refNo)", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Centaline property refNo, e.g. CLL467, DAZ418. It's the segment after the last _ in a Centaline detail page URL.", "items": { "type": "string" } }, "propertyUrls": { "title": "📦 Property URLs", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Full Centaline property URL, e.g. https://hk.centanet.com/findproperty/detail/太古城_CLL467. The refNo is extracted automatically.", "items": { "type": "string" } }, "bulkInput": { "title": "📋 Bulk paste", "type": "string", "description": "One per line (press Enter for a new line). Treated as keywords in search mode, or refNo/property URLs in detail mode. Fastest way is to copy a whole column from Google Sheets." }, "maxItems": { "title": "📊 Max items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Max results per keyword × per source. More items = higher cost. Detail mode is not limited by this (bounded by the number of refNo values instead).", "default": 50 }, "proxyConfiguration": { "title": "🌐 Proxy (advanced, usually off)", "type": "object", "description": "Both sites are friendly to datacenter requests; it works without a proxy by default. Enable only if you hit blocks (429) during heavy scraping.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```