APIs / 28Hse / Search

28Hse: Search

Search from 28Hse as JSON. 1 credit per successful call.

GET /v1/28hse/search

Parameters

Send parameters in the query string.

ParameterTypeRequiredAllowed values
modestringRequiredbuy, rent
pageintegerOptionalAny
bedroomsintegerOptional1, 2, 3, 4
price_rangeintegerOptionalAny
area_typestringOptionalsaleable, gross
area_rangeintegerOptionalAny
estate_idstringOptionalAny
locationstringOptionalAny
sortstringOptionaldefault, 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, unit_price_saleable_high

Example request

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.

Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.