--- title: "Centaline Property API: 8 endpoints, 1 credit per call" description: "Centaline Property API for Hong Kong flats for sale or rent, listing details, agents, branches and estate autocomplete as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/centaline --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Centaline Property 1 credit per call 8 endpoints 36 datapoints # Centaline Property API Centaline Property API for Hong Kong flats for sale or rent, listing details, agents, branches and estate autocomplete as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below Centaline Property GET /v1/centaline/search?listing\_type=rent&price\_min=20000&price\_max=30000&bedrooms=2&location=eyJ0eXBlQ29kZXMiOlsiMTktSE1BMDM0Il19 ``` { "success": true, "data": { "listing_type": "rent", "page": 1, "size": 24, "total": 29, "has_more": true, "filters": { "listing_type": "rent", "lang": "en", "sort": "published", "order": "desc", "price_min": 20000, "price_max": 30000, "bedrooms": [ 2 ], "location": "eyJ0eXBlQ29kZXMiOlsiMTktSE1BMDM0Il19" }, "listings": [ { "price": 29000, "id": "b2443490-16cc-c6d2-7715-08df3e1b8b45", "ref_no": "DAZ634", "listing_type": "rent", "url": "https://hk.centanet.com/findproperty/en/detail/Taikoo-Shing_DAZ634", "title": "Taikoo Shing・Kao Shan Terrace・(T-17) Kam Shan Mansion", "currency": "HKD", "rent_price": 29000, "rent_price_text": "Rent $29,000", "rent_per_sqft_gross": 42, "rent_per_sqft_net": 49, "area_gross_sqft": 675, "area_net_sqft": 582, "net_to_gross_ratio": 0.8622, "bedrooms": 2, "building_age": 48, "floor": "Middle Floor", "building_type": "Apartment", "estate": "Taikoo Shing", "phase": "Kao Shan Terrace", "building": "(T-17) Kam Shan Mansion", "address": "5 Tai Fung Avenue", "location": { "lat": 22.285567, "lng": 114.218283 }, "region": { "territory": "Hong Kong Island", "district": "Eastern District", "area": "Taikoo Shing", "area_code": "HMA034" }, "estate_code": "OVDUURFSVJ", "building_code": "SBAPPPBYPD", "nearby": { "mtr": [ "…" ], "shopping_malls": [ "…" ], "large_parks": [ "…" ], "car_parks": [ "…" ], "ev_charging": [ "…" ] }, "cover_image": "https://hkcdn.centanet.com/imgresize/matterport/SBAPPABYPDKP_f963e42d-fdfc-4f54-bd49-13559bb39d09.jpg?d=0", "media": { "images": true, "floor_plan": true, "vr": true, "video": false, "street_view": true, "sphere": false, "aerial_vr": false }, "management_included": true, "government_rates_included": true, "government_rent_included": true, "is_house": false, "is_discounted": false, "published_at": "2026-11-09T12:40:13", "updated_at": "2026-11-12T15:54:28" }, { "price": 29000, "id": "38604972-98f8-c6ae-8043-08df0f1b97af", "ref_no": "DAA193", "listing_type": "rent", "url": "https://hk.centanet.com/findproperty/en/detail/Taikoo-Shing_DAA193", "title": "Taikoo Shing・Sing Fai Terrace・(T-49) Wai Sing Mansion", "currency": "HKD", "rent_price": 29000, "rent_price_text": "Rent $29,000", "rent_per_sqft_gross": 48, "rent_per_sqft_net": 57, "area_gross_sqft": 600, "area_net_sqft": 502, "net_to_gross_ratio": 0.8367, "bedrooms": 2, "building_age": 45, "direction": "South East", "floor": "Middle Floor", "building_type": "Apartment", "unit_type": "Simplex", "estate": "Taikoo Shing", "phase": "Sing Fai Terrace", "building": "(T-49) Wai Sing Mansion", "address": "12 Taikoo Shing Road", "location": { "lat": 22.286325, "lng": 114.21935 }, "region": { "territory": "Hong Kong Island", "district": "Eastern District", "area": "Taikoo Shing", "area_code": "HMA034" }, "estate_code": "OVDUURFSFJ", "building_code": "OVSOURFXRJ", "nearby": { "mtr": [ "…" ], "shopping_malls": [ "…" ], "large_parks": [ "…" ], "car_parks": [ "…" ], "ev_charging": [ "…" ] }, "cover_image": "https://hkvrdata.centanet.com/CNHK-30319_adeb9fb142834c07856ccb2fb1b7bbd9/CoverImage/Cover.jpg?x-oss-process=style/master", "media": { "images": true, "floor_plan": true, "vr": true, "video": false, "street_view": true, "sphere": false, "aerial_vr": false }, "management_included": false, "government_rates_included": false, "government_rent_included": false, "is_house": false, "is_discounted": false, "published_at": "2026-11-06T13:22:30", "updated_at": "2026-11-11T20:00:50" }, { "price": 28000, "id": "7048b4af-6ea8-ccaa-773c-08df3af096a4", "ref_no": "DAM087", "listing_type": "rent", "url": "https://hk.centanet.com/findproperty/en/detail/Taikoo-Shing_DAM087", "title": "Taikoo Shing・Kao Shan Terrace・(T-07) Tien Shan Mansion", "currency": "HKD", "rent_price": 28000, "rent_price_text": "Rent $28,000", "rent_per_sqft_gross": 41, "rent_per_sqft_net": 48, "area_gross_sqft": 675, "area_net_sqft": 582, "net_to_gross_ratio": 0.8622, "bedrooms": 2, "building_age": 49, "building_type": "Apartment", "unit_type": "Simplex", "estate": "Taikoo Shing", "phase": "Kao Shan Terrace", "building": "(T-07) Tien Shan Mansion", "address": "9 Taikoo Shing Road", "location": { "lat": 22.285567, "lng": 114.220447 }, "region": { "territory": "Hong Kong Island", "district": "Eastern District", "area": "Taikoo Shing", "area_code": "HMA034" }, "estate_code": "OVDUURFSVJ", "building_code": "TNNDTHSXHI", "nearby": { "mtr": [ "…" ], "shopping_malls": [ "…" ], "large_parks": [ "…" ], "car_parks": [ "…" ], "ev_charging": [ "…" ] }, "cover_image": "https://hkcdn.centanet.com/imgresize/matterport/TNNDTNSXMIXN_4d8af163-3010-4e8b-9696-ab9e955c92e7.jpg?d=0", "media": { "images": true, "floor_plan": true, "vr": true, "video": false, "street_view": true, "sphere": false, "aerial_vr": false }, "management_included": false, "government_rates_included": false, "government_rent_included": false, "is_house": false, "is_discounted": false, "published_at": "2026-11-05T13:24:51", "updated_at": "2026-11-12T10:27:36" } ] }, "meta": { "endpoint_family": "search", "request_id": "req_19d249bfa5e548d4b7b4425147306dae", "credits_charged": 1, "credits_remaining": 1883 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | price integer | id string | ref\_no string | listing\_type string | url url | title string | currency string | rent\_price integer | rent\_price\_text string | rent\_per\_sqft\_gross integer | rent\_per\_sqft\_net integer | area\_gross\_sqft integer | area\_net\_sqft integer | net\_to\_gross\_ratio number | bedrooms integer | building\_age integer | floor string | building\_type string | estate string | phase string | building string | address string | location object | region object | estate\_code string | building\_code string | nearby object | cover\_image url | media object | management\_included boolean | government\_rates\_included boolean | government\_rent\_included boolean | is\_house boolean | is\_discounted boolean | published\_at string | updated\_at string | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 29000 | b2443490-16cc-c6d2-7715-08df3e1b8b45 | DAZ634 | rent | https://hk.centanet.com/findproperty/en/detail/Taikoo-Shing\_DAZ634 | Taikoo Shing・Kao Shan Terrace・(T-17) Kam Shan Mansion | HKD | 29000 | Rent $29,000 | 42 | 49 | 675 | 582 | 0.8622 | 2 | 48 | Middle Floor | Apartment | Taikoo Shing | Kao Shan Terrace | (T-17) Kam Shan Mansion | 5 Tai Fung Avenue | {2 fields} | {4 fields} | OVDUURFSVJ | SBAPPPBYPD | {5 fields} | https://hkcdn.centanet.com/imgresize/matterport/SBAPPABYPDKP\_f963e42d-fdfc-4f54-bd49-13559bb39d09.jpg?d=0 | {7 fields} | true | true | true | false | false | 2026-11-09T12:40:13 | 2026-11-12T15:54:28 | | 2 | 29000 | 38604972-98f8-c6ae-8043-08df0f1b97af | DAA193 | rent | https://hk.centanet.com/findproperty/en/detail/Taikoo-Shing\_DAA193 | Taikoo Shing・Sing Fai Terrace・(T-49) Wai Sing Mansion | HKD | 29000 | Rent $29,000 | 48 | 57 | 600 | 502 | 0.8367 | 2 | 45 | Middle Floor | Apartment | Taikoo Shing | Sing Fai Terrace | (T-49) Wai Sing Mansion | 12 Taikoo Shing Road | {2 fields} | {4 fields} | OVDUURFSFJ | OVSOURFXRJ | {5 fields} | https://hkvrdata.centanet.com/CNHK-30319\_adeb9fb142834c07856ccb2fb1b7bbd9/CoverImage/Cover.jpg?x-oss-process=style/master | {7 fields} | false | false | false | false | false | 2026-11-06T13:22:30 | 2026-11-11T20:00:50 | | 3 | 28000 | 7048b4af-6ea8-ccaa-773c-08df3af096a4 | DAM087 | rent | https://hk.centanet.com/findproperty/en/detail/Taikoo-Shing\_DAM087 | Taikoo Shing・Kao Shan Terrace・(T-07) Tien Shan Mansion | HKD | 28000 | Rent $28,000 | 41 | 48 | 675 | 582 | 0.8622 | 2 | 49 | — | Apartment | Taikoo Shing | Kao Shan Terrace | (T-07) Tien Shan Mansion | 9 Taikoo Shing Road | {2 fields} | {4 fields} | OVDUURFSVJ | TNNDTHSXHI | {5 fields} | https://hkcdn.centanet.com/imgresize/matterport/TNNDTNSXMIXN\_4d8af163-3010-4e8b-9696-ab9e955c92e7.jpg?d=0 | {7 fields} | false | false | false | false | false | 2026-11-05T13:24:51 | 2026-11-12T10:27:36 | Recorded from our API · 3 items shown · 36 datapoints per item GET /v1/centaline/search?listing\_type=rent&price\_min=20000&price\_max=30000&bedrooms=2&location=eyJ0eXBlQ29kZXMiOlsiMTktSE1BMDM0Il19 36 datapoints ### Identity - id string - listing\_type string - title string - building\_type string ### Contact - url url ### Location - area\_gross\_sqft integer - area\_net\_sqft integer - estate string - address string - location object - region object - estate\_code string ### Reputation - cover\_image url ### Price - price integer - currency string - rent\_price integer - rent\_price\_text string - government\_rates\_included boolean - is\_discounted boolean ### Other - ref\_no string - rent\_per\_sqft\_gross integer - rent\_per\_sqft\_net integer - net\_to\_gross\_ratio number - bedrooms integer - building\_age integer - floor string - phase string - building string - building\_code string - nearby object - media object - management\_included boolean - government\_rent\_included boolean - is\_house boolean - published\_at string - updated\_at string Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/centaline/search?listing_type=rent&price_min=20000&price_max=30000&bedrooms=2&location=eyJ0eXBlQ29kZXMiOlsiMTktSE1BMDM0Il19" \ -H "X-API-Key: $API_KEY" ``` Centaline Property · 8 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/centaline/agent`](https://perceptlayer.com/apis/centaline/agent) | `agent_no` +1 optional | 1 credit | | [GET `/v1/centaline/agent-listings`](https://perceptlayer.com/apis/centaline/agent-listings) | `agent_no` `listing_type` +5 optional | 1 credit | | [GET `/v1/centaline/agents`](https://perceptlayer.com/apis/centaline/agents) | none +3 optional | 1 credit | | [GET `/v1/centaline/autocomplete`](https://perceptlayer.com/apis/centaline/autocomplete) | `keyword` +3 optional | 1 credit | | [GET `/v1/centaline/branches`](https://perceptlayer.com/apis/centaline/branches) | none +4 optional | 1 credit | | [GET `/v1/centaline/filter-options`](https://perceptlayer.com/apis/centaline/filter-options) | none +2 optional | 1 credit | | [GET `/v1/centaline/listing`](https://perceptlayer.com/apis/centaline/listing) | `ref_no` +2 optional | 1 credit | | [GET `/v1/centaline/search`](https://perceptlayer.com/apis/centaline/search) | `listing_type` +22 optional | 1 credit | Overview ## About the Centaline Property API ## What you can get The Centaline Property API returns Centaline Property listing data for Hong Kong as JSON through 8 endpoints. Every endpoint takes a `lang` of en or hk. - **Search:** `search` takes a `listing_type` (sale or rent), with `page`, `size`, `sort` (published, ranking, price or unit\_price), `order` (asc or desc), `price_min`, `price_max`, `area_min`, `area_max`, `building_age_min`, `building_age_max`, `bedrooms`, `property_type`, `location`, `agent_no`, `mtr_walk_minutes` (2, 5 or 10), `views`, `features`, `facilities`, `developers`, `topics` and `floors`. `filter-options` takes a `listing_type` and returns the filter options. - **Listings:** `listing` takes a `ref_no`, with `details` (full or core). - **Agents and branches:** `agent` takes an `agent_no`; `agent-listings` takes an `agent_no` and a `listing_type`, with the same `sort`, `order`, `page` and `size`; `agents` and `branches` take a `keyword`. - **Autocomplete:** `autocomplete` takes a `keyword`, with `listing_type` and `size`. The recorded `search` ( `listing_type=rent`, `price_min=20000`, `price_max=30000`, `bedrooms=2`, with a Taikoo Shing `location`) returns `listings`, each with `ref_no`, `url`, `title`, `rent_price`, `rent_price_text`, `rent_per_sqft_gross`, `rent_per_sqft_net`, `area_gross_sqft`, `area_net_sqft`, `bedrooms`, `building_age`, `floor`, `estate`, `phase`, `building`, `address`, `region`, `nearby`, `management_included`, `government_rates_included` and `published_at`. It also returns `total` (29), `size`, `has_more` and the applied `filters`. ## How a call works Search two-bedroom rentals in Taikoo Shing: `GET /v1/centaline/search?listing_type=rent&price_min=20000&price_max=30000&bedrooms=2&location=eyJ0eXBlQ29kZXMiOlsiMTktSE1BMDM0Il19` with your key in the `X-API-Key` header. Each listing's `ref_no` goes to `listing`. Every successful call costs 1 credit; failed calls cost nothing. Real estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) Use cases ### Track rents and sale prices per gross and net square foot by Hong Kong estate `Use the Centaline Property API to track rents and sale prices per gross and net square foot by Hong Kong estate` ### Compare net-to-gross ratios across buildings with \`net\_to\_gross\_ratio\` `` Use the Centaline Property API to compare net-to-gross ratios across buildings with `net_to_gross_ratio` `` ### Check whether a rent includes management fees and government rates `Use the Centaline Property API to check whether a rent includes management fees and government rates` ### Find flats within a few minutes' walk of an MTR station with \`mtr\_walk\_minutes\` `` Use the Centaline Property API to find flats within a few minutes' walk of an MTR station with `mtr_walk_minutes` `` FAQ ## Questions **Do I need a Centaline Property account?** No. You call this Centaline Property API with your Perceptlayer key in the \`X-API-Key\` header, with no Centaline Property login. **How much does the Centaline Property API cost?** Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Which languages does it return?** Every endpoint takes a \`lang\` of en or hk. The recorded search used en. **Should I build a Centaline Property scraper instead?** You can, but a Centaline Property scraper is code you maintain: page changes break it, requests get blocked, and Centaline Property's terms govern how you collect data. The Centaline Property API gives you 8 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the Centaline Property API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)