---
title: "28Hse API: Search | Perceptlayer"
description: "Search from 28Hse as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/28hse/search
---

[APIs](https://perceptlayer.com/apis) / [28Hse](https://perceptlayer.com/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.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `mode` | string | Required | buy, rent |
| `page` | integer | Optional | Any |
| `bedrooms` | integer | Optional | 1, 2, 3, 4 |
| `price_range` | integer | Optional | Any |
| `area_type` | string | Optional | saleable, gross |
| `area_range` | integer | Optional | Any |
| `estate_id` | string | Optional | Any |
| `location` | string | Optional | Any |
| `sort` | string | Optional | 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, 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 OK JSON X-Credits-Used: 1

Recorded from our API and shortened.

[Run this endpoint in the playground](https://perceptlayer.com/apis/28hse?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.