Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Centaline Property

1 credit per call8 endpoints36 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 keyRun 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 OKJSONX-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.

#priceintegeridstringref_nostringlisting_typestringurlurltitlestringcurrencystringrent_priceintegerrent_price_textstringrent_per_sqft_grossintegerrent_per_sqft_netintegerarea_gross_sqftintegerarea_net_sqftintegernet_to_gross_rationumberbedroomsintegerbuilding_ageintegerfloorstringbuilding_typestringestatestringphasestringbuildingstringaddressstringlocationobjectregionobjectestate_codestringbuilding_codestringnearbyobjectcover_imageurlmediaobjectmanagement_includedbooleangovernment_rates_includedbooleangovernment_rent_includedbooleanis_housebooleanis_discountedbooleanpublished_atstringupdated_atstring
129000b2443490-16cc-c6d2-7715-08df3e1b8b45DAZ634renthttps://hk.centanet.com/findproperty/en/detail/Taikoo-Shing_DAZ634Taikoo Shing・Kao Shan Terrace・(T-17) Kam Shan MansionHKD29000Rent $29,00042496755820.8622248Middle FloorApartmentTaikoo ShingKao Shan Terrace(T-17) Kam Shan Mansion5 Tai Fung Avenue{2 fields}{4 fields}OVDUURFSVJSBAPPPBYPD{5 fields}https://hkcdn.centanet.com/imgresize/matterport/SBAPPABYPDKP_f963e42d-fdfc-4f54-bd49-13559bb39d09.jpg?d=0{7 fields}truetruetruefalsefalse2026-11-09T12:40:132026-11-12T15:54:28
22900038604972-98f8-c6ae-8043-08df0f1b97afDAA193renthttps://hk.centanet.com/findproperty/en/detail/Taikoo-Shing_DAA193Taikoo Shing・Sing Fai Terrace・(T-49) Wai Sing MansionHKD29000Rent $29,00048576005020.8367245Middle FloorApartmentTaikoo ShingSing Fai Terrace(T-49) Wai Sing Mansion12 Taikoo Shing Road{2 fields}{4 fields}OVDUURFSFJOVSOURFXRJ{5 fields}https://hkvrdata.centanet.com/CNHK-30319_adeb9fb142834c07856ccb2fb1b7bbd9/CoverImage/Cover.jpg?x-oss-process=style/master{7 fields}falsefalsefalsefalsefalse2026-11-06T13:22:302026-11-11T20:00:50
3280007048b4af-6ea8-ccaa-773c-08df3af096a4DAM087renthttps://hk.centanet.com/findproperty/en/detail/Taikoo-Shing_DAM087Taikoo Shing・Kao Shan Terrace・(T-07) Tien Shan MansionHKD28000Rent $28,00041486755820.8622249—ApartmentTaikoo ShingKao Shan Terrace(T-07) Tien Shan Mansion9 Taikoo Shing Road{2 fields}{4 fields}OVDUURFSVJTNNDTHSXHI{5 fields}https://hkcdn.centanet.com/imgresize/matterport/TNNDTNSXMIXN_4d8af163-3010-4e8b-9696-ab9e955c92e7.jpg?d=0{7 fields}falsefalsefalsefalsefalse2026-11-05T13:24:512026-11-12T10:27:36

Recorded from our API · 3 items shown · 36 datapoints per itemGET /v1/centaline/search?listing_type=rent&price_min=20000&price_max=30000&bedrooms=2&location=eyJ0eXBlQ29kZXMiOlsiMTktSE1BMDM0Il19

36 datapoints

Identity

  • idstring
  • listing_typestring
  • titlestring
  • building_typestring

Contact

  • urlurl

Location

  • area_gross_sqftinteger
  • area_net_sqftinteger
  • estatestring
  • addressstring
  • locationobject
  • regionobject
  • estate_codestring

Reputation

  • cover_imageurl

Price

  • priceinteger
  • currencystring
  • rent_priceinteger
  • rent_price_textstring
  • government_rates_includedboolean
  • is_discountedboolean

Other

  • ref_nostring
  • rent_per_sqft_grossinteger
  • rent_per_sqft_netinteger
  • net_to_gross_rationumber
  • bedroomsinteger
  • building_ageinteger
  • floorstring
  • phasestring
  • buildingstring
  • building_codestring
  • nearbyobject
  • mediaobject
  • management_includedboolean
  • government_rent_includedboolean
  • is_houseboolean
  • published_atstring
  • updated_atstring

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/centaline/agent
agent_no+1 optional
1 credit
GET/v1/centaline/agent-listings
agent_nolisting_type+5 optional
1 credit
GET/v1/centaline/agents
none+3 optional
1 credit
GET/v1/centaline/autocomplete
keyword+3 optional
1 credit
GET/v1/centaline/branches
none+4 optional
1 credit
GET/v1/centaline/filter-options
none+2 optional
1 credit
GET/v1/centaline/listing
ref_no+2 optional
1 credit
GET/v1/centaline/search
listing_type+22 optional
1 credit

Overview

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 estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

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 keyRead the docs