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 (search / detail)

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

| transactions | Centaline transaction records — historical sale/rent deals by estate | keywords[] (estate name) + dealType | $0.002 / row | | ccl | Centa-City Leading Index (CCL) weekly series, plus the HK Island / Kowloon / NT East / NT West / large units / small-medium units / large estates sub-indices | weeks (optional, default 52) | $0.002 / row |

---

Input fields

Field	Type	Default	Description
mode	string	auto-detected	search, detail, transactions or ccl
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)
dateFrom	string	—	Keep only deals on/after this date (transactions mode only). Relative 3d / 12h / 2w, or absolute MM/DD/YY
weeks	number	52	How many recent weeks of the CCL series to return (ccl mode only). 0 = full history since 1994
maxItems	number	50	Max results (cap 2000). In transactions mode this is per estate keyword

---

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
}

Example 4: Taikoo Shing transactions (sales, 100 rows)

{
    "mode": "transactions",
    "keywords": ["Taikoo Shing"],
    "dealType": "buy",
    "maxItems": 100
}

Example 5: CCL index (last 104 weeks, about 2 years)

{
    "mode": "ccl",
    "weeks": 104
}

---

Output fields (transactions)

Field	Type	Description
transaction_id	string	Unique transaction record ID
estate	string | null	Estate name (null for non-estate buildings)
phase	string | null	Phase name
building	string | null	Block / building name
address	string | null	Street address
district	string | null	District
floor	string | null	Floor description, e.g. 高層 (high floor)
unit	string | null	Unit, e.g. E室
deal_type	string | null	sale or rent
price	number | null	Transaction price / monthly rent (HKD)
currency	string	Always HKD
gross_area_sqft	number | null	Gross area (sq ft)
net_area_sqft	number | null	Saleable / net area (sq ft)
gross_unit_price	number | null	Price per gross sq ft
net_unit_price	number | null	Price per saleable sq ft
bedrooms	number | null	Number of bedrooms
first_or_second_hand	string | null	First-hand / second-hand
built_year	number | null	Year built
data_source	string | null	Data source (e.g. Land Registry)
transaction_date	string | null	Transaction date (YYYY-MM-DD; the source has no time of day, so none is invented)
detail_url	string | null	Link to the transaction detail
source_mode	string	Always transactions
source_query	string	The estate keyword searched
scraped_at	string	Scrape time (ISO 8601)

Output fields (ccl)

Field	Type	Description
series	string	ccl (overall) / hk (HK Island) / kln (Kowloon) / nte (NT East) / ntw (NT West) / big (large units) / normal (small-medium units) / estate (large estates)
series_name	string	Series name in Chinese, e.g. 中原城市領先指數 CCL
week_ending	string	Week date (YYYY-MM-DD)
index	number	Index value
change_pct_wow	number | null	Week-over-week change (%); null for the earliest point in history
change_pct_mom	number | null	Month-over-month change (%); only on the latest point
publish_date	string | null	Official publish time (ISO 8601); only on the latest point
source_mode	string	Always ccl
scraped_at	string	Scrape time (ISO 8601)

series=ccl returns a weekly series (length set by weeks); the seven sub-indices return their latest value only.

Price-index and transaction monitoring

transactions and ccl are built for scheduled runs — stack each run's output and you have a time series:

• Estate price monitoring: run transactions for the same keywords (estate) + dealType on a schedule with dateFrom so each run only fetches deals since the last one (e.g. daily with dateFrom: "1d"); the accumulated dataset is that estate's deal-price curve.
• CCL trend tracking: ccl returns the latest window of the weekly series every run (weeks sets the look-back); schedule it weekly (e.g. Friday evening after CCL is published) and align on week_ending / publish_date to follow the headline index and its seven sub-indices.

Set a cron in Apify Console Schedules (e.g. 0 20 * * 5 = every Friday 20:00) — no scheduling code needed.

---

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 (ccl mode is the exception: a plain GET of the index page).
• 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 2000. If your keyword is too broad, the scraper auto-stops after 5 consecutive pages with no new data, to save cost (transactions mode stops immediately on a page with no new rows instead of retrying).

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: How are transactions different from the property search?

A: search returns listings currently on the market; transactions returns completed deals (actual price and date). They are different data sources and do not substitute for each other — to track an estate's real price trend, use transactions.

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, transaction records, CCL index