# TocToc Agencies API

<p><strong>TocToc Agencies API</strong> lists developers or brokers from the TocToc company catalog: id, name, type, logo and profile url. The catalog returns 24 companies per call, and the fields <code>total</code>, <code>per_page</code> and <code>last_page</code> show the size of the full catalog. Paging through the catalog is not offered. Use the id with the agency route, or the exact name with the agency filter of the search route. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/toctoc-api/toctoc_agencies](https://scrappa.co/docs/toctoc-api/toctoc_agencies)
- **API group:** TocToc API
- **Endpoint:** `GET https://scrappa.co/api/toctoc/agencies`

## 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 |
| --- | --- | --- | --- |
| `type` | string | Yes | developer or broker. |

## Example response

```json
{
    "data": {
        "items": [
            {
                "id": "6a8d08a7802dbc64ca4d94e7",
                "url": "https://www.toctoc.com/empresas/corredoras/catalogo/propiedades/re-max-platino/6a8d08a7802dbc64ca4d94e7",
                "logo": null,
                "name": "RE/MAX Platino",
                "type": "broker"
            },
            {
                "id": "6a50d1921e9eb1bc8cf93aa2",
                "url": "https://www.toctoc.com/empresas/corredoras/catalogo/propiedades/1-house/6a50d1921e9eb1bc8cf93aa2",
                "logo": "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/logos/corredora/29184/0212202514274829184.png",
                "name": "1 House",
                "type": "broker"
            },
            {
                "id": "6a50d19158894110a5f933f9",
                "url": "https://www.toctoc.com/empresas/corredoras/catalogo/propiedades/1111/6a50d19158894110a5f933f9",
                "logo": null,
                "name": "1111",
                "type": "broker"
            }
        ],
        "total": 3703,
        "per_page": 24,
        "last_page": 155
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agencies"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billed. |
| 503 | Upstream Unavailable | TocToc could not be reached or returned data that does not match the request. This response is not billed and can be retried. |

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