Sign inGet a free API keyDashboard
Menu

APIs / Real estate / 28Hse

1 credit per call4 endpoints20 datapoints

28Hse API

28Hse API for Hong Kong flats to buy or rent, listing details, estate agencies and location autocomplete as JSON. 1 credit per successful call.

Get a free API keyRun it below
28Hse
GET/v1/28hse/search?mode=buy&bedrooms=2&price_range=3
{
  "success": true,
  "data": {
    "mode": "buy",
    "page": 1,
    "per_page": 15,
    "total": 9631,
    "total_pages": 643,
    "filters": {
      "sort": "default",
      "bedrooms": 2,
      "price_range": 3,
      "price_label": "HK$4M-8M"
    },
    "listings": [
      {
        "id": "4095657",
        "url": "https://www.28hse.com/en/buy/apartment/property-4095657",
        "mode": "buy",
        "property_type": "apartment",
        "title": "Super deal on a 2-bedroom apartment!!! Owner is so keen to sell, the price is negotiable, don't miss",
        "thumbnail": "https://i1.28hse.com/2026/11/202611121954158914055_thumb.jpg",
        "photo_count": 6,
        "grade": "Golden",
        "posted_text": "2 hours ago",
        "district": {
          "id": "74",
          "location": "di30-74",
          "name": "Tsim Sha Tsui"
        },
        "estate": {
          "id": "8376",
          "name": "Harbour Pinnacle"
        },
        "unit_description": "Unit H,Low Floor,Harbour Pinnacle",
        "saleable_area_sqft": 472,
        "price_per_sqft": 16907,
        "agency_name": "Midland Realty",
        "price_text": "Sale HK$7.98 million",
        "price": 7980000,
        "currency": "HKD",
        "bedrooms": 2,
        "tags": [
          "2 Bedrooms",
          "Apartment"
        ]
      },
      {
        "id": "4095646",
        "url": "https://www.28hse.com/en/buy/apartment/property-4095646",
        "mode": "buy",
        "property_type": "apartment",
        "title": "*Acquaintance with the owner* More surprises await when you visit. Multiple viewings scheduled.",
        "thumbnail": "https://i1.28hse.com/2026/11/202611121948045800373_thumb.jpg",
        "photo_count": 3,
        "grade": "Golden",
        "posted_text": "2 hours ago",
        "district": {
          "id": "26333",
          "location": "di26-26333",
          "name": "Nam Cheong"
        },
        "estate": {
          "id": "23746",
          "name": "Hoi Lok Court"
        },
        "unit_description": "Low Floor,BLOCK D",
        "saleable_area_sqft": 390,
        "price_per_sqft": 12051,
        "agency_name": "Hoi Lok Property Limited",
        "price_text": "Sale HK$4.7 million",
        "price": 4700000,
        "currency": "HKD",
        "bedrooms": 2,
        "bathrooms": 1,
        "tags": [
          "Premium Unpaid",
          "2 Bedrooms , 1 Bathroom",
          "Home Ownership"
        ]
      },
      {
        "id": "4095612",
        "url": "https://www.28hse.com/en/buy/apartment/property-4095612",
        "mode": "buy",
        "property_type": "apartment",
        "title": "Kai Tak Parkview 2-bedroom, 392 sq ft, garden view, HK$7.8 million | School Network 34",
        "thumbnail": "https://i1.28hse.com/2026/11/202611121921561474311_thumb.jpg",
        "photo_count": 7,
        "grade": "Golden",
        "posted_text": "2 hours ago",
        "district": {
          "id": "82",
          "location": "di108-82",
          "name": "Kai Tak"
        },
        "estate": {
          "id": "26929",
          "name": "The Pavilia Forest"
        },
        "unit_description": "Unit G,Low Floor,Tower 3,The Pavilia Forest II",
        "saleable_area_sqft": 392,
        "price_per_sqft": 19898,
        "agency_name": "Ricacorp Properties",
        "price_text": "Sale HK$7.8 million",
        "price": 7800000,
        "currency": "HKD",
        "bedrooms": 2,
        "bathrooms": 1,
        "tags": [
          "2 Bedrooms , 1 Bathroom",
          "North east",
          "Apartment"
        ]
      }
    ]
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_a5bf84dfcd85495f83ed95833d652bb5",
    "credits_charged": 1,
    "credits_remaining": 1900
  }
}
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.

#idstringurlurlmodestringproperty_typestringtitlestringthumbnailurlphoto_countintegergradestringposted_textstringdistrictobjectestateobjectunit_descriptionstringsaleable_area_sqftintegerprice_per_sqftintegeragency_namestringprice_textstringpriceintegercurrencystringbedroomsintegertagsstring[]
14095657https://www.28hse.com/en/buy/apartment/property-4095657buyapartmentSuper deal on a 2-bedroom apartment!!! Owner is so keen to sell, the price is negotiable, don't misshttps://i1.28hse.com/2026/11/202611121954158914055_thumb.jpg6Golden2 hours ago{3 fields}{2 fields}Unit H,Low Floor,Harbour Pinnacle47216907Midland RealtySale HK$7.98 million7980000HKD2[2 items]
24095646https://www.28hse.com/en/buy/apartment/property-4095646buyapartment*Acquaintance with the owner* More surprises await when you visit. Multiple viewings scheduled.https://i1.28hse.com/2026/11/202611121948045800373_thumb.jpg3Golden2 hours ago{3 fields}{2 fields}Low Floor,BLOCK D39012051Hoi Lok Property LimitedSale HK$4.7 million4700000HKD2[3 items]
34095612https://www.28hse.com/en/buy/apartment/property-4095612buyapartmentKai Tak Parkview 2-bedroom, 392 sq ft, garden view, HK$7.8 million | School Network 34https://i1.28hse.com/2026/11/202611121921561474311_thumb.jpg7Golden2 hours ago{3 fields}{2 fields}Unit G,Low Floor,Tower 3,The Pavilia Forest II39219898Ricacorp PropertiesSale HK$7.8 million7800000HKD2[3 items]

Recorded from our API · 3 items shown · 20 datapoints per itemGET /v1/28hse/search?mode=buy&bedrooms=2&price_range=3

20 datapoints

Identity

  • idstring
  • property_typestring
  • titlestring
  • agency_namestring

Contact

  • urlurl

Location

  • districtobject
  • estateobject
  • saleable_area_sqftinteger

Reputation

  • photo_countinteger

Price

  • price_per_sqftinteger
  • price_textstring
  • priceinteger
  • currencystring

Other

  • modestring
  • thumbnailurl
  • gradestring
  • posted_textstring
  • unit_descriptionstring
  • bedroomsinteger
  • tagsstring[]

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/28hse/search?mode=buy&bedrooms=2&price_range=3" \
  -H "X-API-Key: $API_KEY"

28Hse · 4 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/28hse/agency
id+1 optional
1 credit
GET/v1/28hse/autocomplete
keyword+1 optional
1 credit
GET/v1/28hse/listing
idmode
1 credit
GET/v1/28hse/search
mode+8 optional
1 credit

Overview

What you can get

The 28Hse API returns 28Hse property data for Hong Kong as JSON through 4 endpoints.

  • Search: search takes a mode (buy or rent), with page, bedrooms (1, 2, 3 or 4), price_range, area_type (saleable or gross), area_range, estate_id, location and sort (default, latest, price_low, price_high, gross_area_low, gross_area_high, saleable_area_low, saleable_area_high, unit_price_gross_low, unit_price_gross_high, unit_price_saleable_low or unit_price_saleable_high).
  • Listings: listing takes an id and a mode (buy or rent).
  • Agencies: agency takes an id, with page.
  • Autocomplete: autocomplete takes a keyword, with mode (buy or rent).

The recorded search (mode=buy, bedrooms=2, price_range=3) returns listings, each with id, url, property_type, title, district, estate, unit_description, saleable_area_sqft, price, price_per_sqft, currency, bedrooms, agency_name, posted_text and tags. It also returns total (9,631), per_page, total_pages and the applied filters, where price_label spells out the band: HK$4M-8M for price_range=3.

How a call works

Search flats for sale: GET /v1/28hse/search?mode=buy&bedrooms=2&price_range=3 with your key in the X-API-Key header. Page with page. Each listing's id goes to listing with the same mode; its estate.id goes back into search as estate_id, and district.location as location. Every successful call costs 1 credit; failed calls cost nothing.

Real estateJSONRESTMCP

More real estate APIs

4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathomeBatdongsan.com.vn

Use cases

Track asking prices and price per saleable square foot across Hong Kong districts

Use the 28Hse API to track asking prices and price per saleable square foot across Hong Kong districts

Follow every listing in one estate with `estate_id`

Use the 28Hse API to follow every listing in one estate with `estate_id`

Compare sale and rental supply for the same estate or district by switching `mode`

Use the 28Hse API to compare sale and rental supply for the same estate or district by switching `mode`

Rank flats by unit price on saleable or gross area

Use the 28Hse API to rank flats by unit price on saleable or gross area

FAQ

Questions

Do I need a 28Hse account?

No. You call this 28Hse API with your Perceptlayer key in the `X-API-Key` header, with no 28Hse login.

How much does the 28Hse 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.

Can I filter by saleable or gross area?

Yes. Set `area_type` to saleable or gross and pass an `area_range`. The `sort` values also cover both, from saleable_area_low to unit_price_gross_high.

Should I build a 28Hse scraper instead?

You can, but a 28Hse scraper is code you maintain: page changes break it, requests get blocked, and 28Hse's terms govern how you collect data. The 28Hse API gives you 4 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 28Hse API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs