# TocToc Listing API

<p><strong>TocToc Listing API</strong> returns one listing. Pass the <code>url</code> or the <code>hash_id</code> of a search item. The record has the price in pesos and UF with the UF rate of the day, rooms, area, the list of characteristics and typed details such as useful and terrace area, year built, floor and orientation, amenities by category, the street address, <code>lat</code> and <code>lng</code>, photos, publication and change dates, views and the publishing agency. A listing that is no longer online returns a 404 error. Only www.toctoc.com listing addresses are accepted. Agent phone numbers and emails are not part of the public data. Failed requests are not billed.</p>

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

## 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 |
| --- | --- | --- | --- |
| `url` | string | No | The url of a search item, or its path. Only www.toctoc.com listing addresses are accepted. |
| `hash_id` | string | No | The hash_id of a search item (40 characters). Use it instead of the url. |

## Example response

```json
{
    "data": {
        "id": 4280708,
        "url": "https://www.toctoc.com/arriendo/departamento/metropolitana/santiago/b_2fbbaf435c42df7c9399d7aa2c6581052f85dc49",
        "code": "176718",
        "dates": {
            "modified": "2026-10-24",
            "published": "2026-07-23"
        },
        "price": {
            "uf": 9,
            "clp": 380000,
            "uf_max": 9.22,
            "uf_min": 9.22,
            "uf_rate": 41215.77,
            "listed_in": "CLP"
        },
        "title": "ARRIENDO DPTO 2D+2B Metro Sta Lucia",
        "views": 37,
        "agency": {
            "id": 25935,
            "logo": "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/logos/corredora/25935/0423202418544925935.jpeg",
            "name": "Kutt Property",
            "type": "broker"
        },
        "images": [
            "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/fotos/new/2026/07/23/2fbbaf435c42df7c9399d7aa2c6581052f85dc49/98d358b3ed35d0451f7ff8ede7d372b548bc643e.png",
            "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/fotos/new/2026/07/23/2fbbaf435c42df7c9399d7aa2c6581052f85dc49/c0d02430e36d36f521999945733739d9048fb125.png",
            "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/fotos/new/2026/07/23/2fbbaf435c42df7c9399d7aa2c6581052f85dc49/b8b631bf3b7992a5f85c433ada2b9f339f8f919f.png",
            "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/fotos/new/2026/07/23/2fbbaf435c42df7c9399d7aa2c6581052f85dc49/4f883fadd5d48ce3be7dd1dfa4066e2ce866058a.png"
        ],
        "address": {
            "region": "Metropolitana",
            "street": "Avenida Santa Rosa 1 - 300",
            "commune": "Santiago",
            "commune_id": 339
        },
        "details": {
            "floor": 3,
            "year_built": 2009,
            "orientation": "Sur",
            "storage_units": 0,
            "parking_spaces": 1,
            "useful_area_m2": {
                "max": 48,
                "min": 48
            },
            "terrace_area_m2": {
                "max": 1,
                "min": 1
            }
        },
        "hash_id": "2fbbaf435c42df7c9399d7aa2c6581052f85dc49",
        "bedrooms": {
            "max": 2,
            "min": 2
        },
        "amenities": [
            {
                "values": [
                    "Hall",
                    "Jardin",
                    "Terraza"
                ],
                "category": "distribuci\u00f3n"
            },
            {
                "values": [
                    "Piscina",
                    "Porton Automatico",
                    "Sala multiuso",
                    "Conserje",
                    "Sistema Seguridad"
                ],
                "category": "servicios"
            }
        ],
        "bathrooms": {
            "max": 2,
            "min": 2
        },
        "condition": "used",
        "operation": "Arriendo",
        "coordinates": {
            "lat": -33.4475285,
            "lng": -70.6452214
        },
        "description": "Excelente oportunidad para arriendo. Departamento en pleno coraz\u00f3n de Santiago\nCaracter\u00edsticas del departamento\n2 dormitorios \n2 ba\u00f1os \nliving comedor \ncocina americana \nespacio para home office o escritorio\n\n\nEquipamiento del edificio\nacceso controlado y vigilancia las 24 horas \n3 ascensores \npisci",
        "min_area_m2": 48,
        "listing_type": "rent",
        "property_type": "Departamento",
        "characteristics": [
            {
                "name": "Dormitorios",
                "value": "2"
            },
            {
                "name": "Ba\u00f1os",
                "value": "2"
            },
            {
                "name": "Superf. \u00fatil",
                "value": "48 m\u00b2"
            },
            {
                "name": "Superf. terraza",
                "value": "1 m\u00b2"
            },
            {
                "name": "A\u00f1o de construcci\u00f3n",
                "value": "2009"
            },
            {
                "name": "Bodega",
                "value": "0"
            },
            {
                "name": "Estacionamiento",
                "value": "1"
            },
            {
                "name": "Piso",
                "value": "3"
            },
            {
                "name": "Orientaci\u00f3n",
                "value": "Sur"
            },
            {
                "name": "Estado de la propiedad",
                "value": "Entrega inmediata"
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "listing"
    },
    "success": true
}
```

## Errors

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