Sign inGet a free API keyDashboard
Menu

APIs / Real estate / TOCTOC

1 credit per call5 endpoints20 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 keyRun it below
TOCTOC
GET/v1/toctoc/search?operation=sale&region_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 OKJSONX-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.

#idintegerhash_idstringtitlestringdescriptionstringlisting_typestringconditionstringoperationstringproperty_typestringurlurlpriceobjectbedroomsobjectbathroomsobjectarea_m2objectlocationobjectmain_imageurlimagesstring[]agencyobjectis_featuredbooleanviewsintegerpublished_hours_agointeger
11031609ac3055f4b85429206017d5d645b8cd3f51bd2cc0Concepto Best SiteConcepto 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 …salenewVenta NuevoDepartamentohttps://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}false073765
20f46b89f77b909987beaed56e41274ad4cdd7c89aOportunidad Inversión Santiago Centro 2D1B - 1.700 UFBajo 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 …saleusedVenta UsadoDepartamentohttps://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}true0493
343538606ec03210138a86fc8c2ec7cc5078ac0ae56fdfa0Departamento en Venta Excelente UbicaciónDepartamentos 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…saleusedVenta UsadoDepartamentohttps://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}true01357

Recorded from our API · 3 items shown · 20 datapoints per itemGET /v1/toctoc/search?operation=sale&region_id=13&commune_id=339&property_type=apartment&min_bedrooms=2&max_bedrooms=2&sort=price_asc

20 datapoints

Identity

  • idinteger
  • hash_idstring
  • titlestring
  • listing_typestring
  • property_typestring

Contact

  • urlurl

Location

  • area_m2object
  • locationobject

Reputation

  • main_imageurl
  • imagesstring[]

Price

  • priceobject

Other

  • descriptionstring
  • conditionstring
  • operationstring
  • bedroomsobject
  • bathroomsobject
  • agencyobject
  • is_featuredboolean
  • viewsinteger
  • published_hours_agointeger

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/toctoc/search?operation=sale&region_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.

EndpointRequired parametersCost
GET/v1/toctoc/agencies
type
1 credit
GET/v1/toctoc/agency
none+3 optional
1 credit
GET/v1/toctoc/autocomplete
query+1 optional
1 credit
GET/v1/toctoc/listing
none+2 optional
1 credit
GET/v1/toctoc/search
none+20 optional
1 credit

Overview

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&region_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 estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

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 keyRead the docs