# Centaline Agent Listings API

<p>Page through the sale or rental listings of one Centaline agent. The listings have the same fields as the search endpoint, and `total` is the number of listings of that agent for the listing type. An agent without listings, or an unknown agent number, returns an empty list. The site serves the first 10000 results; a page past that returns HTTP 422.</p>

- **Documentation:** [https://scrappa.co/docs/centaline-api/centaline_agent_listings](https://scrappa.co/docs/centaline-api/centaline_agent_listings)
- **API group:** Centaline Property API
- **Endpoint:** `GET https://scrappa.co/api/centaline/agent-listings`

## 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 |
| --- | --- | --- | --- |
| `agent_no` | string | Yes | The `agent_no` of an agent search result. |
| `listing_type` | string | Yes | `sale` for homes for sale, `rent` for homes for rent. |
| `sort` | string | No | `published` (default), `ranking`, `price` or `unit_price`. |
| `order` | string | No | `desc` (default) or `asc`. |
| `page` | integer | No | Page number, 1-based. |
| `size` | integer | No | Listings per page, 1 to 100. Default 24. |
| `lang` | string | No | `en` (default) for English names, `hk` for Traditional Chinese. |

## Example response

```json
{
    "data": {
        "page": 1,
        "size": 24,
        "total": 20,
        "filters": {
            "lang": "en",
            "sort": "published",
            "order": "desc",
            "agent_no": "25355",
            "listing_type": "sale"
        },
        "has_more": false,
        "listings": [
            {
                "id": "b572415e-a650-c7f1-93a6-08dedca15195",
                "url": "https://hk.centanet.com/findproperty/en/detail/The-Latitude_UBD837",
                "floor": "High Floor",
                "price": 53800000,
                "title": "The Latitude\u30fbTower 6",
                "ref_no": "UBD837",
                "address": "638 Prince Edward Road East",
                "bedrooms": 4,
                "currency": "HKD",
                "location": {
                    "lat": 22.333465,
                    "lng": 114.19691
                },
                "sale_price": 53800000,
                "building_age": 16,
                "listing_type": "sale",
                "published_at": "2026-07-08T11:35:32",
                "area_net_sqft": 2181,
                "ensuite_rooms": 3,
                "area_gross_sqft": 2942,
                "sale_price_text": "Sell $53.8M",
                "price_per_sqft_net": 24667
            }
        ],
        "listing_type": "sale"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agent_listings"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | The property or agent does not exist or is no longer online. This response is not billable. |  |
|  | A parameter is missing or invalid, or the page reaches past the first 10000 results. This response is not billable. |  |
|  | Centaline is temporarily unavailable, or its answer did not match the request. 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)