# 28Hse Agency API

<p>Get an agency profile: name, logo, address, licence number, business phone, employees with the contact details the agency publishes, the number of listings and one page of its listings (15 per page) in the same shape as the search. A valid agency without listings returns an empty list. An unknown agency answers 404 and is not billed.</p>

- **Documentation:** [https://scrappa.co/docs/28hse-api/28hse_agency](https://scrappa.co/docs/28hse-api/28hse_agency)
- **API group:** 28Hse API
- **Endpoint:** `GET https://scrappa.co/api/28hse/agency`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | Agency id from the `agency.id` field of a listing, e.g. `5626`. |
| `page` | integer | No | Page of the agency listings, 1-based. A page past the last page returns an empty list. |

## Example response

```json
{
    "data": {
        "id": "5626",
        "url": "https://www.28hse.com/en/agent/5626",
        "name": "Ricacorp Properties",
        "page": 1,
        "total": 27,
        "address": "Shop Lop2,mtr West Rail Long Ping Station,new Territories",
        "listings": [
            {
                "id": "4069683",
                "url": "https://www.28hse.com/en/buy/apartment/property-4069683",
                "mode": "buy",
                "tags": [
                    "2 Bedrooms",
                    "North east",
                    "Apartment",
                    "Henderson"
                ],
                "grade": "Golden",
                "price": 4040000,
                "title": "Received 13,000 in rent. Received 4% return!",
                "estate": {
                    "id": "4214",
                    "name": "Sheung Shui Centre"
                },
                "bedrooms": 2,
                "currency": "HKD",
                "district": {
                    "id": "105",
                    "name": "Sheung Shui",
                    "location": "di112-105"
                },
                "thumbnail": "https://i1.28hse.com/2026/10/202610252320003487430_thumb.jpg",
                "price_text": "Sale HK$4.04 million",
                "agency_name": "Midland Property",
                "photo_count": 7,
                "posted_text": "2 hours ago",
                "property_type": "apartment",
                "price_per_sqft": 11510,
                "unit_description": "Unit D,Low Floor,BLOCK 1",
                "saleable_area_sqft": 351
            }
        ],
        "per_page": 15,
        "employees": [
            {
                "name": "Charlie Ng",
                "phone": "852-98502588"
            }
        ],
        "total_pages": 2,
        "license_number": "C-002504"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agency"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | The listing or agency does not exist or is no longer online. This response is not billable. |  |
|  | A parameter is missing or invalid. This response is not billable. |  |
|  | 28Hse is temporarily unavailable, or its answer did not match the request, for example another page or an ignored filter. Retry the request. This response is not billable. |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)