--- title: "TOCTOC API: JSON data, 5 endpoints, 1 credit per call" description: "TOCTOC API for Chilean homes for sale or rent, in UF and CLP, with listings, brokers, developers and place lookups as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/toctoc --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / TOCTOC 1 credit per call 5 endpoints 20 datapoints # TOCTOC API TOCTOC API for Chilean homes for sale or rent, in UF and CLP, with listings, brokers, developers and place lookups as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below TOCTOC GET /v1/toctoc/search?operation=sale®ion\_id=13&commune\_id=339&property\_type=apartment&min\_bedrooms=2&max\_bedrooms=2&sort=price\_asc ``` { "success": true, "data": { "applied_filters": { "operation": "sale", "region_id": 13, "commune_id": 339, "property_type": "apartment", "sort": "price_asc", "min_bedrooms": 2, "max_bedrooms": 2 }, "pagination": { "page": 1, "per_page": 20, "total": 2440, "total_pages": 122, "has_next_page": true, "filtered_out": 0 }, "items": [ { "id": 1031609, "hash_id": "ac3055f4b85429206017d5d645b8cd3f51bd2cc0", "title": "Concepto Best Site", "description": "Concepto Best Site se emplaza en una cómoda ubicación de Centro de Santiago, a pasos de Plaza de Armas, del Mall Vivo, comercios, restaurantes, servicios y con fácil acceso a líneas 2, 3 y 5 del Metro y Autopista Central. \r\n\r\nConcepto Best …", "listing_type": "sale", "condition": "new", "operation": "Venta Nuevo", "property_type": "Departamento", "url": "https://www.toctoc.com/venta/departamento/metropolitana/santiago/r_ac3055f4b85429206017d5d645b8cd3f51bd2cc0", "price": { "uf": 3393, "clp": 140185392, "listed_in": "UF" }, "bedrooms": { "min": 2, "max": 2 }, "bathrooms": { "min": 1, "max": 2 }, "area_m2": { "min": 41.87, "max": 49.78 }, "location": { "commune": "Santiago", "commune_id": 339, "region": "Metropolitana", "coordinates": { "lat": -33.435427, "lng": -70.654698 } }, "main_image": "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/fotos/20180614/1031609/2026052616144073834.jpg", "images": [ "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/fotos/20180614/1031609/2026052616144073834.jpg", "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/fotos/20180614/1031609/2026052619241404911.jpg", "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/fotos/20180614/1031609/2026052619236405031.jpg" ], "agency": { "id": 115, "type": "developer", "name": "Imagina Grupo Inmobiliario", "logo": "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/logos/empresa/115/2017092758244179488.jpg" }, "is_featured": false, "views": 0, "published_hours_ago": 73765 }, { "id": 0, "hash_id": "f46b89f77b909987beaed56e41274ad4cdd7c89a", "title": "Oportunidad Inversión Santiago Centro 2D1B - 1.700 UF", "description": "Bajo valor de mercado en Zenteno 1490! Depto de 39 m² ideales para inversión o vivir. Cuenta con 2 dormitorios con piso flotante y 1 baño con tina. Cocina funcional. Piso 11. Ubicación estratégica con alta plusvalía y conectividad: a pasos …", "listing_type": "sale", "condition": "used", "operation": "Venta Usado", "property_type": "Departamento", "url": "https://www.toctoc.com/venta/departamento/metropolitana/santiago/o_f46b89f77b909987beaed56e41274ad4cdd7c89a", "price": { "uf": 1700, "clp": 70237302, "listed_in": "UF" }, "bedrooms": { "min": 2, "max": 2 }, "bathrooms": { "min": 1, "max": 1 }, "area_m2": { "min": 39, "max": 39 }, "location": { "commune": "Santiago", "commune_id": 339, "region": "Metropolitana", "coordinates": { "lat": -33.465974, "lng": -70.649788 } }, "main_image": "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/fotos/new/2026/10/23/f46b89f77b909987beaed56e41274ad4cdd7c89a/dac850c8af91f70f891124795fbeed58a7c7b604.webp", "images": [ "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/fotos/new/2026/10/23/f46b89f77b909987beaed56e41274ad4cdd7c89a/dac850c8af91f70f891124795fbeed58a7c7b604.webp", "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/fotos/new/2026/10/23/f46b89f77b909987beaed56e41274ad4cdd7c89a/705e44e289bb79453dde1a0dc08d77022051b8d0.webp", "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/fotos/new/2026/10/23/f46b89f77b909987beaed56e41274ad4cdd7c89a/32303651ea01d49904047b74be5d0145e09ca8f9.webp" ], "agency": { "id": 40242, "type": "private", "name": "patricio sierra" }, "is_featured": true, "views": 0, "published_hours_ago": 493 }, { "id": 4353860, "hash_id": "6ec03210138a86fc8c2ec7cc5078ac0ae56fdfa0", "title": "Departamento en Venta Excelente Ubicación", "description": "Departamentos de 2 dormitorios y un baño de 44 m2, muy bien ubicado, en sector ecuador cercano a metro ecuador y metro las rejas, Colegio y Jardín Infantil cercanos, Centros de salud Comercio y Áreas Verdes\r\nDepartamento ideal para inversio…", "listing_type": "sale", "condition": "used", "operation": "Venta Usado", "property_type": "Departamento", "url": "https://www.toctoc.com/venta/departamento/metropolitana/santiago/b_6ec03210138a86fc8c2ec7cc5078ac0ae56fdfa0", "price": { "uf": 2190, "clp": 90482171, "listed_in": "UF" }, "bedrooms": { "min": 2, "max": 2 }, "bathrooms": { "min": 1, "max": 1 }, "area_m2": { "min": 44, "max": 44 }, "location": { "commune": "Santiago", "commune_id": 339, "region": "Metropolitana", "coordinates": { "lat": -33.45467305103479, "lng": -70.7027701587219 } }, "main_image": "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/fotos/new/2026/09/17/6ec03210138a86fc8c2ec7cc5078ac0ae56fdfa0/e23b51e5d265223dc87b742a4093556cfcef270a.jpg", "images": [ "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/fotos/new/2026/09/17/6ec03210138a86fc8c2ec7cc5078ac0ae56fdfa0/e23b51e5d265223dc87b742a4093556cfcef270a.jpg", "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/fotos/new/2026/09/17/6ec03210138a86fc8c2ec7cc5078ac0ae56fdfa0/2e5d33d5f915a1b8200c598f188b84d936417f12.jpg", "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/fotos/new/2026/09/17/6ec03210138a86fc8c2ec7cc5078ac0ae56fdfa0/3d6ebfac75840358cb5d4fcc72c33b40204fd4ab.jpg" ], "agency": { "id": 29856, "type": "broker", "name": "Century21 +Activo", "logo": "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/logos/corredora/29856/broker_29856_20260813_175140_logoSGGHD.png" }, "is_featured": true, "views": 0, "published_hours_ago": 1357 } ] }, "meta": { "endpoint_family": "search", "request_id": "req_8b290f25804e46ef87b3f10c14763912", "credits_charged": 1, "credits_remaining": 1806 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | id integer | hash\_id string | title string | description string | listing\_type string | condition string | operation string | property\_type string | url url | price object | bedrooms object | bathrooms object | area\_m2 object | location object | main\_image url | images string\[\] | agency object | is\_featured boolean | views integer | published\_hours\_ago integer | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 1031609 | ac3055f4b85429206017d5d645b8cd3f51bd2cc0 | Concepto Best Site | Concepto Best Site se emplaza en una cómoda ubicación de Centro de Santiago, a pasos de Plaza de Armas, del Mall Vivo, comercios, restaurantes, servicios y con fácil acceso a líneas 2, 3 y 5 del Metro y Autopista Central. Concepto Best … | sale | new | Venta Nuevo | Departamento | https://www.toctoc.com/venta/departamento/metropolitana/santiago/r\_ac3055f4b85429206017d5d645b8cd3f51bd2cc0 | {3 fields} | {2 fields} | {2 fields} | {2 fields} | {4 fields} | https://d1cfu8v5n1wsm.cloudfront.net/toctoc/fotos/20180614/1031609/2026052616144073834.jpg | \[3 items\] | {4 fields} | false | 0 | 73765 | | 2 | 0 | f46b89f77b909987beaed56e41274ad4cdd7c89a | Oportunidad Inversión Santiago Centro 2D1B - 1.700 UF | Bajo valor de mercado en Zenteno 1490! Depto de 39 m² ideales para inversión o vivir. Cuenta con 2 dormitorios con piso flotante y 1 baño con tina. Cocina funcional. Piso 11. Ubicación estratégica con alta plusvalía y conectividad: a pasos … | sale | used | Venta Usado | Departamento | https://www.toctoc.com/venta/departamento/metropolitana/santiago/o\_f46b89f77b909987beaed56e41274ad4cdd7c89a | {3 fields} | {2 fields} | {2 fields} | {2 fields} | {4 fields} | https://d1cfu8v5n1wsm.cloudfront.net/toctoc/fotos/new/2026/10/23/f46b89f77b909987beaed56e41274ad4cdd7c89a/dac850c8af91f70f891124795fbeed58a7c7b604.webp | \[3 items\] | {3 fields} | true | 0 | 493 | | 3 | 4353860 | 6ec03210138a86fc8c2ec7cc5078ac0ae56fdfa0 | Departamento en Venta Excelente Ubicación | Departamentos de 2 dormitorios y un baño de 44 m2, muy bien ubicado, en sector ecuador cercano a metro ecuador y metro las rejas, Colegio y Jardín Infantil cercanos, Centros de salud Comercio y Áreas Verdes Departamento ideal para inversio… | sale | used | Venta Usado | Departamento | https://www.toctoc.com/venta/departamento/metropolitana/santiago/b\_6ec03210138a86fc8c2ec7cc5078ac0ae56fdfa0 | {3 fields} | {2 fields} | {2 fields} | {2 fields} | {4 fields} | https://d1cfu8v5n1wsm.cloudfront.net/toctoc/fotos/new/2026/09/17/6ec03210138a86fc8c2ec7cc5078ac0ae56fdfa0/e23b51e5d265223dc87b742a4093556cfcef270a.jpg | \[3 items\] | {4 fields} | true | 0 | 1357 | Recorded from our API · 3 items shown · 20 datapoints per item GET /v1/toctoc/search?operation=sale®ion\_id=13&commune\_id=339&property\_type=apartment&min\_bedrooms=2&max\_bedrooms=2&sort=price\_asc 20 datapoints ### Identity - id integer - hash\_id string - title string - listing\_type string - property\_type string ### Contact - url url ### Location - area\_m2 object - location object ### Reputation - main\_image url - images string\[\] ### Price - price object ### Other - description string - condition string - operation string - bedrooms object - bathrooms object - agency object - is\_featured boolean - views integer - published\_hours\_ago integer Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/toctoc/search?operation=sale®ion_id=13&commune_id=339&property_type=apartment&min_bedrooms=2&max_bedrooms=2&sort=price_asc" \ -H "X-API-Key: $API_KEY" ``` TOCTOC · 5 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/toctoc/agencies`](https://perceptlayer.com/apis/toctoc/agencies) | `type` | 1 credit | | [GET `/v1/toctoc/agency`](https://perceptlayer.com/apis/toctoc/agency) | none +3 optional | 1 credit | | [GET `/v1/toctoc/autocomplete`](https://perceptlayer.com/apis/toctoc/autocomplete) | `query` +1 optional | 1 credit | | [GET `/v1/toctoc/listing`](https://perceptlayer.com/apis/toctoc/listing) | none +2 optional | 1 credit | | [GET `/v1/toctoc/search`](https://perceptlayer.com/apis/toctoc/search) | none +20 optional | 1 credit | Overview ## About the TOCTOC API ## What you can get The TOCTOC API returns TOCTOC property data as JSON through 5 endpoints. - **Search:** `search` takes `operation` (sale or rent), `region_id`, `commune_id`, `property_type` (house, apartment, office, commercial, land, plot, storage or parking), `state` (new or used), `publisher_type` (professional or private), `agency`, `agency_type` (broker or developer), `currency` (uf or clp), `min_price`, `max_price`, `min_bedrooms`, `max_bedrooms`, `min_bathrooms`, `max_bathrooms`, `min_area`, `max_area`, `sort` (relevance, price\_asc, price\_desc, newest or oldest), `page` and `limit`. - **Listings:** `listing` takes a `url` or a `hash_id`. - **Agencies:** `agencies` takes a `type` (developer or broker); `agency` takes an `agency_id` with `agency_type` (developer or broker), or a `url`. - **Autocomplete:** `autocomplete` takes a `query`, with `limit`. The recorded `search` for 2-bedroom apartments for sale in Santiago ( `region_id=13`, `commune_id=339`), sorted by `price_asc`, returns `pagination` with a `total` of 2,440, `per_page` (20) and `has_next_page`, and `items`, each with `id`, `hash_id`, `title`, `description`, `condition`, `operation`, `property_type`, `url`, `price` ( `uf`, `clp`), `bedrooms`, `bathrooms`, `area_m2`, `location`, `main_image`, `images`, `agency`, `is_featured`, `views` and `published_hours_ago`. ## How a call works Search a commune: `GET /v1/toctoc/search?operation=sale®ion_id=13&commune_id=339&property_type=apartment&min_bedrooms=2&max_bedrooms=2&sort=price_asc` with your key in the `X-API-Key` header. Each item's `hash_id` or `url` is what `listing` takes, and the `id` and `type` inside its `agency` feed `agency` as `agency_id` and `agency_type`. Check `has_next_page` before asking for the next `page`. Every successful call costs 1 credit; failed calls cost nothing. Real estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) Use cases ### Track asking prices in UF by commune in Santiago and across Chile `Use the TOCTOC API to track asking prices in UF by commune in Santiago and across Chile` ### Compare new developments with used homes with \`state\` `` Use the TOCTOC API to compare new developments with used homes with `state` `` ### Follow a developer's or broker's projects with \`agency\` `` Use the TOCTOC API to follow a developer's or broker's projects with `agency` `` ### Separate private sellers from professionals with \`publisher\_type\` `` Use the TOCTOC API to separate private sellers from professionals with `publisher_type` `` FAQ ## Questions **Do I need a TOCTOC account?** No. You call this TOCTOC API with your Perceptlayer key in the \`X-API-Key\` header, with no TOCTOC login. **How much does the TOCTOC API cost?** Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Are prices in UF or pesos?** Both. Each item's \`price\` carries \`uf\`, \`clp\` and \`listed\_in\`, and \`search\` takes a \`currency\` of uf or clp. **Should I build a TOCTOC scraper instead?** You can, but a TOCTOC scraper is code you maintain: page changes break it, requests get blocked, and TOCTOC's terms govern how you collect data. The TOCTOC API gives you 5 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the TOCTOC API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)