Search
/api/centaline/search
Search homes for sale or rent with location, price, rooms, area and type filters
Scrappa's read-only Centaline Property API turns the Centaline portal for Hong Kong into structured JSON. Search homes for sale and rent by location, price, bedrooms, area, property type and building age, read the full record of a listing with images, floor plans, VR, estate data and recent transactions, find locations, read filter options, search agents and branches. Results come in English or Traditional Chinese. Failed requests are never billed.
Try it now
Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.
curl -X GET "https://scrappa.co/api/centaline/search?listing_type=rent&bedrooms=2&price_min=20000&price_max=30000" \
-H "Accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY"
{
"success": true,
"data": {
"listing_type": "rent",
"page": 1,
"size": 24,
"total": 2942,
"has_more": true,
"listings": [
{
"price": 25000,
"ref_no": "ASN388",
"listing_type": "rent",
"currency": "HKD",
"area_net_sqft": 650,
"bedrooms": 2,
"building": "Tower 5"
}
]
},
"meta": {"endpoint_family": "search", "billable": true}
}
Structured data for real applications. Here are some ideas.
Track asking prices and prices per square foot by estate and district, for sale and rent.
Find homes by bedrooms, rent, area and distance to the MTR for people who move to Hong Kong.
Resolve an estate name to a location, then list every home on offer and read recent transactions.
Find agents by name and branches by area, then page through the listings of one agent.
Centaline Property scraper API
The Centaline API is built for proptech teams, analysts and relocation services that work with the Hong Kong market. Search sale and rental listings by location, price, rooms and area, then use the listing, agent and branch endpoints to complete the record.
Search homes for sale and for rent in Hong Kong.
Filter by location, price, bedrooms, net area, property type, building age and MTR walking time.
Get full listing details with images, floor plans, VR, estate data and recent transactions.
Resolve estate, district, MTR and school names to a location the search takes.
Call 8 read-only endpoints that return structured JSON.
Look up an estate or district by name. Pass its location to the search.
Open Centaline Autocomplete API docsChoose sale or rent, add the filters you need and page through the results.
Open Centaline Search API docsPass the ref_no of a search result to the listing endpoint for images, floor plans, estate data and agents.
Open Centaline Listing API docsEverything you need in one API.
/api/centaline/search
Search homes for sale or rent with location, price, rooms, area and type filters
/api/centaline/listing
Get the price, area, rooms, position, images, floor plans, estate data and agents of one property
/api/centaline/autocomplete
Find districts, estates, buildings, MTR stations, schools and developers by name
/api/centaline/filter-options
List the values of the search filters with listing counts
/api/centaline/agents
Search agents by name with licence, branch, rating and awards
/api/centaline/agent
Get the profile of one agent with branch, experience and sample listings
/api/centaline/agent-listings
Page through the sale or rental listings of one agent
/api/centaline/branches
Search branches with address, position, manager and listing counts
See how Scrappa compares to the official API.
| Feature | Scrappa | Do-it-yourself property data extraction |
|---|---|---|
| Dedicated Centaline endpoints | yes (8 endpoints) | |
| Output format | Structured JSON | Raw page content |
| Filters honoured on every row | Build your own checks | |
| Request mode | Read-only | Depends on implementation |
| Parser maintenance | Handled by Scrappa | Your team |
The Centaline Property API is Scrappa's read-only REST API for Hong Kong property listings. It covers search, listing details, location autocomplete, filter options, agent search, agent profiles and branches.
No. Scrappa is an independent service and is not affiliated with or endorsed by Centaline. A Scrappa API key is used to access the endpoints on this page.
No. Phone numbers, e-mail addresses, WhatsApp and WeChat data are left out. The API returns the name, licence, branch and rating of an agent.
No. Centaline does not publish a bathroom count or fee amounts. The API returns the number of en-suite rooms and flags that say whether management fees and government rates are included.
The request fails with a clear error and is not billed. The API never returns listings that break a filter you asked for.
No. All Centaline endpoints on this page are read-only.