# TocToc Agency API

<p><strong>TocToc Agency API</strong> returns the profile of a developer or broker: name, logo, tax id, address and the company contact data that the profile page shows to every visitor (empty fields are null), plus the first listings of the agency. Pass <code>agency_id</code> and <code>agency_type</code> from the agencies route, or the <code>url</code> of an entry. An unknown agency returns a 404 error. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/toctoc-api/toctoc_agency](https://scrappa.co/docs/toctoc-api/toctoc_agency)
- **API group:** TocToc API
- **Endpoint:** `GET https://scrappa.co/api/toctoc/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 |
| --- | --- | --- | --- |
| `agency_id` | string | No | The id of an agency from the agencies route (24 characters). Send it with agency_type. |
| `agency_type` | string | No | developer or broker. |
| `url` | string | No | The url of an agency from the agencies route. Use it instead of agency_id and agency_type. |

## Example response

```json
{
    "data": {
        "agency": {
            "id": "6a5e3173141f614cf4f1fb67",
            "logo": "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/logos/empresa/4372/2026042721188719068.jpg",
            "name": "AMA Inmobiliaria",
            "slug": "ama-inmobiliaria",
            "type": "developer",
            "tax_id": null,
            "address": null,
            "contact": {
                "name": "AMA Inmobiliaria",
                "email": null,
                "phone": null,
                "landline": null
            },
            "commune_id": null
        },
        "listings": [
            {
                "id": 4142922,
                "url": "https://www.toctoc.com/venta/departamento/metropolitana/la-florida/r_c912c1715c90e0b6e64549a7da00d1a629c5f153",
                "price": {
                    "uf": 2540,
                    "amount": 2540,
                    "currency": "UF"
                },
                "title": "AMA Quillayes",
                "area_m2": 35.5,
                "commune": "La Florida",
                "bedrooms": 1,
                "bathrooms": 1,
                "operation": "Venta Nuevo",
                "main_image": "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/fotos/20260421/4142922/n_wm_2026042123439854403.webp",
                "listing_type": "sale",
                "property_type": "Departamento",
                "published_ago": "Publicado hace 6 meses"
            }
        ],
        "listings_total": 1
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agency"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billed. |
| 404 | Not Found | The agency was not found. 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)