--- title: "Centaline Property API: Search | Perceptlayer" description: "Search from Centaline Property as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/centaline/search --- [APIs](https://perceptlayer.com/apis) / [Centaline Property](https://perceptlayer.com/apis/centaline) / Search # Centaline Property: Search Search from Centaline Property as JSON. 1 credit per successful call. GET `/v1/centaline/search` ## Parameters Send parameters in the query string. | Parameter | Type | Required | Allowed values | | --- | --- | --- | --- | | `listing_type` | string | Required | sale, rent | | `lang` | string | Optional | en, hk | | `page` | integer | Optional | Any | | `size` | integer | Optional | Any | | `sort` | string | Optional | published, ranking, price, unit\_price | | `order` | string | Optional | asc, desc | | `price_min` | integer | Optional | Any | | `price_max` | integer | Optional | Any | | `area_min` | integer | Optional | Any | | `area_max` | integer | Optional | Any | | `building_age_min` | integer | Optional | Any | | `building_age_max` | integer | Optional | Any | | `bedrooms` | string | Optional | Any | | `property_type` | string | Optional | Any | | `location` | string | Optional | Up to 800 characters | | `agent_no` | string | Optional | Any | | `mtr_walk_minutes` | integer | Optional | 2, 5, 10 | | `views` | string | Optional | Up to 400 characters | | `features` | string | Optional | Up to 400 characters | | `facilities` | string | Optional | Up to 400 characters | | `developers` | string | Optional | Up to 400 characters | | `topics` | string | Optional | Up to 400 characters | | `floors` | string | Optional | Up to 400 characters | ## Example request 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. [Run this endpoint in the playground](https://perceptlayer.com/apis/centaline?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.