# Centaline Agent API

<p>Get the public profile of one Centaline agent by agent number: names, licence, title, branch with address and position, manager, star rating, listing counts, languages, awards, the areas the agent works in, new project and estate experience and a few sample sale and rental listings. Phone numbers, e-mail, WhatsApp and WeChat data are not returned. An unknown agent number returns HTTP 404 and is not billed. Use agent-listings to page through all listings of an agent.</p>

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

## 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, for example `25355`. |
| `lang` | string | No | `en` (default) for English names, `hk` for Traditional Chinese. |

## Example response

```json
{
    "data": {
        "agent": {
            "name": "Chan Chi Ho",
            "star": 5,
            "title": "LICENSED SALESPERSON",
            "branch": {
                "name": "Central Kowloon Skytower Branch",
                "address": "Shop 3A, G/F., Sky Tower, No. 38 Sung Wong Toi Road, Tokwawan, Kowloon",
                "branch_code": "DW6"
            },
            "license": "S-315634",
            "manager": {
                "name": "Thomas Yeung",
                "license": "E-011993",
                "agent_no": "05190"
            },
            "name_zh": "\u9673\u5fd7\u8c6a",
            "agent_no": "25355",
            "languages": [
                "Cantonese",
                "Putonghua"
            ],
            "rent_listing_count": 1,
            "sale_listing_count": 20
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agent"
    },
    "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)