--- title: "28Hse API: JSON data, 4 endpoints, 1 credit per call" description: "28Hse API for Hong Kong flats to buy or rent, listing details, estate agencies and location autocomplete as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/28hse --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / 28Hse 1 credit per call 4 endpoints 20 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 key](https://perceptlayer.com/signup) Run 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 OK JSON X-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. | # | id string | url url | mode string | property\_type string | title string | thumbnail url | photo\_count integer | grade string | posted\_text string | district object | estate object | unit\_description string | saleable\_area\_sqft integer | price\_per\_sqft integer | agency\_name string | price\_text string | price integer | currency string | bedrooms integer | tags string\[\] | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 4095657 | https://www.28hse.com/en/buy/apartment/property-4095657 | buy | apartment | Super deal on a 2-bedroom apartment!!! Owner is so keen to sell, the price is negotiable, don't miss | https://i1.28hse.com/2026/11/202611121954158914055\_thumb.jpg | 6 | Golden | 2 hours ago | {3 fields} | {2 fields} | Unit H,Low Floor,Harbour Pinnacle | 472 | 16907 | Midland Realty | Sale HK$7.98 million | 7980000 | HKD | 2 | \[2 items\] | | 2 | 4095646 | https://www.28hse.com/en/buy/apartment/property-4095646 | buy | apartment | \*Acquaintance with the owner\* More surprises await when you visit. Multiple viewings scheduled. | https://i1.28hse.com/2026/11/202611121948045800373\_thumb.jpg | 3 | Golden | 2 hours ago | {3 fields} | {2 fields} | Low Floor,BLOCK D | 390 | 12051 | Hoi Lok Property Limited | Sale HK$4.7 million | 4700000 | HKD | 2 | \[3 items\] | | 3 | 4095612 | https://www.28hse.com/en/buy/apartment/property-4095612 | buy | apartment | Kai Tak Parkview 2-bedroom, 392 sq ft, garden view, HK$7.8 million \| School Network 34 | https://i1.28hse.com/2026/11/202611121921561474311\_thumb.jpg | 7 | Golden | 2 hours ago | {3 fields} | {2 fields} | Unit G,Low Floor,Tower 3,The Pavilia Forest II | 392 | 19898 | Ricacorp Properties | Sale HK$7.8 million | 7800000 | HKD | 2 | \[3 items\] | Recorded from our API · 3 items shown · 20 datapoints per item GET /v1/28hse/search?mode=buy&bedrooms=2&price\_range=3 20 datapoints ### Identity - id string - property\_type string - title string - agency\_name string ### Contact - url url ### Location - district object - estate object - saleable\_area\_sqft integer ### Reputation - photo\_count integer ### Price - price\_per\_sqft integer - price\_text string - price integer - currency string ### Other - mode string - thumbnail url - grade string - posted\_text string - unit\_description string - bedrooms integer - tags string\[\] Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/28hse/agency`](https://perceptlayer.com/apis/28hse/agency) | `id` +1 optional | 1 credit | | [GET `/v1/28hse/autocomplete`](https://perceptlayer.com/apis/28hse/autocomplete) | `keyword` +1 optional | 1 credit | | [GET `/v1/28hse/listing`](https://perceptlayer.com/apis/28hse/listing) | `id` `mode` | 1 credit | | [GET `/v1/28hse/search`](https://perceptlayer.com/apis/28hse/search) | `mode` +8 optional | 1 credit | Overview ## About the 28Hse API ## 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 estate JSON REST MCP ### More real estate APIs [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) [Batdongsan.com.vn](https://perceptlayer.com/apis/batdongsan) 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)