# 99.co Agent Directory API Documentation

Page through the public 99.co agent directory. Each agent carries the agent id, name, agency, CEA registration number, agency licence number, phone, WhatsApp link, profile url, the number of active listings and recorded transactions, and the agent and agency photos. The CEA number is what /agent takes. The directory is browsable up to the total_pages value that 99.co reports; a page past it is an empty list that keeps the requested page number.

- **Documentation:** [https://scrappa.co/docs/99co-api/99co_agents](https://scrappa.co/docs/99co-api/99co_agents)
- **API group:** 99.co API
- **Endpoint:** `GET https://scrappa.co/api/99co/v1/agents`

## 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 |
| --- | --- | --- | --- |
| `page` | integer | No | One-based page number, 1 to 5000. Defaults to 1. |
| `limit` | integer | No | Agents per page, 1 to 60. Defaults to 20. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/99co/v1/agents?page=1&limit=10"
```

## Example response

```json
{
    "success": true,
    "data": {
        "items": [
            {
                "agent_id": "AvsgWHNn4tzdd8CgHAw6w",
                "name": "Agent Name",
                "agency": "ERA REALTY NETWORK PTE LTD",
                "cea_number": "R025639D",
                "agency_licence": "L3002382K",
                "phone": "+6560000000",
                "whatsapp_url": "https://wa.me/6560000000",
                "profile_url": "https://www.99.co/singapore/agents/R025639D-agent-name",
                "total_listings": 5,
                "total_transactions": 115,
                "is_recommended": false,
                "photo_url": "https://pic2.99.co/v2/oKbYexp8M3oStjoARatB4H?mode=fill",
                "agency_photo_url": "https://pic2.99.co/v2/aWXk2ZVKzwiv4Bmdru3YCn?mode=fill"
            }
        ],
        "pagination": {
            "current_page": 1,
            "page_size": 10,
            "total_results": 30404,
            "total_pages": 636,
            "has_next_page": true
        }
    },
    "meta": {
        "endpoint_family": "agents",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A public parameter is missing or invalid. No upstream call is made and the response is not billable. |
| 502 | Unexpected Upstream Response | 99.co answered with a body that is not the documented shape. The response is not billable. |
| 503 | Upstream Unavailable | 99.co was temporarily unavailable or blocked the request. The response is not billable and the request never answers 429. |

## 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)