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)

{
    "mode": "search",
    "keywords": ["太古城"],
    "dealType": "buy",
    "source": "both",
    "maxItems": 50
}

Example 2: Kowloon City rental search (Centaline only)

{
    "mode": "search",
    "keywords": ["九龍城", "馬頭圍"],
    "dealType": "rent",
    "source": "centanet",
    "priceMin": 15000,
    "priceMax": 30000,
    "maxItems": 100
}

Example 3: Fetch detail by property ID

{
    "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