TocToc Listing API returns one listing. Pass the url or the hash_id 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, lat and lng, 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.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
2 optional filters available.
string
Optional
The url of a search item, or its path. Only www.toctoc.com listing addresses are accepted.
https://example.com/product
string
Optional
The hash_id of a search item (40 characters). Use it instead of the url.
1234567890
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"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
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing or invalid. This response is not billed.
{
"errors": {
"url": [
"Send the url or the hash_id of a listing from the search route."
]
},
"message": "The request validation failed"
}Not Found
The listing is no longer online. This response is not billed.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "listing"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested resource was not found."
},
"success": false
}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.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "listing"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "TocToc could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.