# TocToc Scraper — Chile Real Estate Listings (`fabrikit/toctoc-scraper`) Actor Scrape property listings from TocToc.com, Chile: sale, rent and new projects with price in UF and CLP, m², bedrooms, bathrooms, parking, comuna, region, GPS, photos and broker/developer. Skips delisted ads. Pay per result, no subscription. - **URL**: https://apify.com/fabrikit/toctoc-scraper.md - **Developed by:** [Fabrikit](https://apify.com/fabrikit) (community) - **Categories:** Real estate, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 property results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## TocToc Scraper — Chile Real Estate Listings Extract property listings from **[TocToc.com](https://www.toctoc.com)**, one of Chile's main real-estate portals: apartments, houses, offices, land and more, **for sale or for rent**, both **used listings and new-development projects** (*proyectos nuevos*). Every property comes as one clean JSON row: price in **UF and CLP**, price per m², bedrooms, bathrooms, useful / built / terrace / total m², parking and other amenities, comuna, region, GPS coordinates, the full photo gallery, the publishing **real-estate company** (broker or developer), publication date and the listing URL. An optional add-on opens each listing page for the full description, street address, year built, delivery status (entrega inmediata / en verde / en blanco), video and page views. ### Why this scraper - **Only live listings.** TocToc's own search keeps returning ads that were already taken down; when you open them, the page says *"Propiedad no disponible"*. In our tests that was **10–30% of all results** (up to 40% in some rental searches). The actor checks every result against TocToc's live photo index and drops dead ads before they reach your dataset, and **you are never charged for them**. The run summary tells you how many it skipped. - **Built for reliability.** TocToc's API needs a session token tied to the visitor's IP, and its firewall rate-limits and challenges datacenter IPs. The actor keeps the token and the IP together on one sticky Chilean residential session, refreshes the token on its own, paces requests under the firewall limit, rotates to a fresh IP if it is ever blocked, and retries temporary errors (3× with backoff). If TocToc really is unreachable, the run fails with a clear message. It never ends "successfully" with zero rows. - **Fast.** Listings come from TocToc's own JSON search API at up to 600 properties per request, not from rendered HTML pages. A 300-property run takes about 20 seconds. - **Prices in both currencies.** Every row has `priceUF` and `priceCLP`, using TocToc's own conversion, plus `pricePerM2UF`. - **Company names, not people.** Brokers (*corredoras*) and developers (*inmobiliarias*) are named. Private owners are only flagged as `private_owner` and are never named. Phone numbers and e-mails are removed from descriptions. ### What you can search | Filter | Values | |---|---| | Operation | `venta` (sale) or `arriendo` (rent) | | Property types | `departamento`, `casa`, `oficina`, `local_comercial`, `terreno`, `parcela`, `agricola`, `industrial`, `bodega`, `estacionamiento`, `lugar_vacacional` (any combination) | | New / used | `any`, `new` (new-development projects), `used` | | Locations | Any comuna, region or neighbourhood, written as you would type it on the site: `Las Condes`, `Ñuñoa`, `Viña del Mar`, `Región de Valparaíso`, `Metropolitana`, `Barrio Italia`, `Chicureo`. Several locations = several searches in one run. Empty = all of Chile. | | Price range | Min/max in **UF** or **CLP** | | Bedrooms / bathrooms | Min / max | | Published in the last N days | e.g. `1` for daily monitoring | | Sort | relevance, price ↑/↓, area ↑/↓, newest, oldest | | Or: search URLs | Paste any TocToc search URL. The actor reads its operation, type, location and filters, including filters the form above doesn't offer, such as surface ranges and amenities. | ### Input examples **Apartments for sale in Las Condes (default):** ```json { "locations": ["Las Condes"], "operation": "venta", "propertyTypes": ["departamento"], "maxItems": 50 } ``` **Rentals in two comunas, 2+ bedrooms, up to CLP 900,000, newest first, 100 per comuna:** ```json { "locations": ["Providencia", "Ñuñoa"], "operation": "arriendo", "propertyTypes": ["departamento", "casa"], "priceCurrency": "CLP", "priceMax": 900000, "bedroomsMin": 2, "sort": "newest", "maxItems": 200, "maxItemsPerSearch": 100 } ``` **Only new-development projects in the whole Valparaíso region, with full details:** ```json { "locations": ["Región de Valparaíso"], "operation": "venta", "propertyTypes": ["departamento", "casa"], "condition": "new", "maxItems": 300, "fetchDetails": true } ``` **Straight from TocToc URLs:** ```json { "startUrls": [ { "url": "https://www.toctoc.com/venta/casa/metropolitana/lo-barnechea" }, { "url": "https://www.toctoc.com/resultados/lista/arriendo/departamento/metropolitana/nunoa/?moneda=1&precioDesde=400000&precioHasta=700000&dormitoriosDesde=2&ordenarPor=5" } ], "maxItems": 500 } ``` **Daily monitor of new listings in Santiago Centro:** ```json { "locations": ["Santiago"], "operation": "arriendo", "propertyTypes": [], "publishedWithinDays": 1, "sort": "newest", "maxItems": 1000 } ``` ### Output example One row per property (description and photos shortened): ```json { "id": "4323366", "url": "https://www.toctoc.com/venta/departamento/vina-del-mar/b_4323366", "title": "Amplio Departamento Ubicación Privilegiada", "operation": "venta", "condition": "used", "propertyType": "departamento", "price": 7450, "priceMax": null, "currency": "UF", "priceUF": 7450, "priceCLP": 306543884, "pricePerM2UF": 53.21, "bedrooms": 3, "bedroomsMax": null, "bathrooms": 3, "bathroomsMax": null, "usefulAreaM2": 140, "usefulAreaM2Max": null, "builtAreaM2": 130, "builtAreaM2Max": null, "terraceAreaM2": null, "totalAreaM2": 140, "totalAreaM2Max": null, "hasParking": false, "amenities": ["storage", "elevator"], "comuna": "Viña del Mar", "region": "Valparaíso", "address": "norte", "latitude": -33.0210402, "longitude": -71.5555215, "publisherType": "broker", "publisherId": 22099, "publisherName": "Coldwell Banker Chile", "publisherLogo": "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/logos/corredora/22099/1112202014495022099.jpeg", "imageUrl": "https://d1cfu8v5n1wsm.cloudfront.net/toctoc/fotos/20260822/4323366/42d164444ddac418a0aca0d56ade582129c6f913.jpg", "photos": ["https://d1cfu8v5n1wsm.cloudfront.net/toctoc/fotos/20260822/4323366/42d164444ddac418a0aca0d56ade582129c6f913.jpg", "..."], "photoCount": 20, "videoUrl": null, "publishedAt": "2026-08-22", "updatedAt": "2026-08-22", "available": true, "description": "Ubicado en el corazón de Viña del Mar, este departamento ofrece un entorno vibrante y lleno de vida...", "yearBuilt": 1977, "deliveryStatus": "Entrega inmediata", "views": 24, "listingCode": "43914V", "detailsFetched": true, "scrapedAt": "2026-10-12T16:30:03.893Z" } ``` #### Field notes - **New projects** (`condition: "new"`) are one row per project. Fields ending in `Max` hold the top of the range, e.g. `bedrooms: 1`, `bedroomsMax: 3`, or a useful area of 35–72 m². They are `null` for single units. - **Areas:** `usefulAreaM2` = *superficie útil*, `builtAreaM2` = *superficie construida*, `terraceAreaM2` = terrace, `totalAreaM2` = *superficie total* for apartments, or the lot (*terreno*) for houses and land. - **`pricePerM2UF`** uses the useful area, or the lot area for land. For rentals it is the monthly rent per m². - **`amenities`** can include `parking`, `storage`, `pool`, `elevator`, `bbq_area`, `heating`, `furnished`, `security_system` and `gated_community`. `hasParking` is a shortcut for the first one. - **`publisherType`**: `developer` (inmobiliaria, new projects), `broker` (corredora) or `private_owner`. Private owners never get a name or id. - **`available`**: `true` = confirmed live. With **Skip delisted ads** off, dead ads come through as `false`. `null` = could not be checked (ads without any photos). - These fields are filled only with **Fetch listing details**: `address`, `description`, `yearBuilt`, `deliveryStatus`, `videoUrl`, `views`, `updatedAt` and `listingCode`. - A `SUMMARY` record in the run's key-value store lists every search: the location it resolved to, TocToc's total, rows received, delisted ads skipped and rows pushed. ### Pricing Pay per event: you only pay for properties saved to your dataset. | Event | When | |---|---| | `property-result` | Each live property saved to the dataset | | `property-details` | Only with **Fetch listing details** on: each property whose listing page was read | | `apify-actor-start` | Platform start event, once per run (a fraction of a cent) | From 30 October 2026, 1,000 properties cost US$6 on the Apify Free plan; paid Apify plans pay less per property — see the **Pricing** tab for your plan's rate. Listing details add US$1 per 1,000 properties on every plan. Delisted ads that are skipped are **not** charged. Proxy traffic is included in the price, so you don't need your own residential proxy plan. ### Use cases - **Price analytics and valuation models**: UF/m² by comuna, bedroom count or new vs. used stock. - **Rental-market monitoring**: run daily with `publishedWithinDays: 1` and `sort: newest` to catch new rentals as soon as they appear. - **New-development pipeline**: every *proyecto nuevo* with developer name, price, bedroom and size ranges, and delivery status (en verde / en blanco / entrega inmediata). - **Broker and developer intelligence**: listing counts, price positioning and coverage per real-estate company. - **Lead lists of real-estate companies** (B2B): brokers and developers active in a comuna. - **Feeding maps and dashboards**: every row has GPS coordinates and photos. ### FAQ **Do I need a proxy?** No setup needed. TocToc blocks datacenter IPs with a JavaScript challenge, so the actor uses Apify's residential proxy with a Chilean IP by default. That traffic is included in the event price. **How many properties can I get?** As many as TocToc has: a whole-country sale search reports about 65,000 listings (before delisted ads are removed) and paging works to the last page. `maxItems` caps the run (up to 100,000), and `maxItemsPerSearch` caps each location or URL. **Why do I get fewer rows than TocToc's result count?** Because the actor drops delisted ads that TocToc still counts. The `SUMMARY` record shows how many were skipped per search. Turn off **Skip delisted ads** if you want them anyway. **How do I search a whole region?** Write `Región de Valparaíso`, `Región Metropolitana`, `Región del Biobío`, and so on. A plain `Valparaíso` searches the comuna. The run log tells you which one was used. **How fast is it?** Search results come in at up to 600 per request: 300 properties in about 20 seconds, 50 properties in under 30 seconds including start-up. With **Fetch listing details** on, each property needs one extra page, about 150 per minute. **Is this legal / what about personal data?** See *Is it legal to scrape TocToc?* below. **Something broke. What now?** Check the run's `SUMMARY` record and log. If TocToc changes its site, the actor stops with an explicit error instead of returning empty data. Open an issue on the actor page and it will be fixed. ### Is it legal to scrape TocToc? The actor only reads public listing data that TocToc shows to any visitor without logging in. It doesn't collect names, phone numbers or e-mails of private individuals: private owners are only marked as `private_owner`, and contact details are removed from descriptions. Listings can still reveal personal data indirectly (for example an exact address or photos of a private home), so you are responsible for how you use the data under Chilean law (Ley 19.628 / Ley 21.719), the EU GDPR or the California CCPA where they apply, and under TocToc's terms of service. Photos and descriptions belong to the advertisers. This is general information, not legal advice. ### Integrations Run the TocToc Scraper from the Apify API or the JavaScript and Python clients, send new listings onward with webhooks, or schedule a daily run with `publishedWithinDays: 1` in Apify Console. It works with n8n, Make and Zapier (for example, to load listings into Google Sheets), and with LangChain and LlamaIndex through their Apify integrations. AI agents in Claude, ChatGPT, Cursor and other MCP clients can find and run it through Apify's MCP server. Export as JSON, CSV or Excel, or read from the dataset API. ### Use with AI agents Use this actor to get live property listings in Chile from TocToc for one or more comunas, regions or neighbourhoods, for sale or rent, used or new projects, with prices in UF and CLP, UF/m², rooms, areas and coordinates. ```json { "locations": ["Ñuñoa"], "operation": "venta", "propertyTypes": ["departamento"], "maxItems": 20 } ``` Main output fields: `title`, `url`, `operation`, `condition`, `propertyType`, `priceUF`, `priceCLP`, `pricePerM2UF`, `bedrooms`, `bathrooms`, `usefulAreaM2`, `totalAreaM2`, `comuna`, `latitude`, `longitude`, `publisherType`, `publisherName`, `publishedAt`. It is pay-per-event: an agent pays a small start fee plus a fixed price per property (and per detail page if requested), not for compute time. ### Related actors - [Portal Inmobiliario Scraper](https://apify.com/fabrikit/portal-inmobiliario-scraper) — Chile's largest property portal, for a second source on the same comunas. - [Fincaraíz Scraper](https://apify.com/fabrikit/fincaraiz-scraper) — property listings in Colombia. - [Chile Company RUT Lookup](https://apify.com/fabrikit/chile-company-rut-lookup) — SII data for the brokers and developers you find. - [Mercado Libre Autos Scraper](https://apify.com/fabrikit/mercadolibre-autos-scraper) — new and used car listings in Chile and four more countries. - [Airbnb Scraper](https://apify.com/fabrikit/airbnb-search-scraper) — short-term rental prices to compare with long-term rents. #### Ready-made examples - [Departamentos en venta en Ñuñoa (TocToc)](https://apify.com/fabrikit/toctoc-scraper/examples/departamentos-venta-nunoa) - [Casas en arriendo en La Florida (TocToc)](https://apify.com/fabrikit/toctoc-scraper/examples/casas-arriendo-la-florida) - [Proyectos inmobiliarios nuevos en Santiago](https://apify.com/fabrikit/toctoc-scraper/examples/proyectos-nuevos-santiago) ### Changelog - **2026-10-16** — README: legal notes, integrations, AI-agent usage, related actors and example tasks added; pricing text updated. - **2026-10-15** — Tiered pricing announced, effective 2026-10-30 (lower per-property price on paid Apify plans). Default memory lowered from 1,024 to 512 MB. - **2026-10-12** — Builds 0.1.1–0.1.4: initial release — sale and rent, used and new projects, delisted-ad filtering, sticky Chilean residential sessions and the listing-details add-on; published on the Apify Store. *En español: primera versión publicada el 12-10-2026; nuevo precio por niveles desde el 30-10-2026.* ### En español **TocToc Scraper** extrae avisos de propiedades de TocToc.com (Chile): venta y arriendo, usados y **proyectos nuevos**, con precio en **UF y pesos**, UF/m², dormitorios, baños, m² útiles/construidos/terraza/totales, estacionamiento y otros equipamientos, comuna, región, coordenadas GPS, galería de fotos, corredora o inmobiliaria, fecha de publicación y URL. Con el complemento **Fetch listing details** agrega descripción, dirección, año de construcción, estado de entrega (entrega inmediata, en verde, en blanco), video y visitas. Busca por comuna, región o barrio (`Las Condes`, `Región de Valparaíso`, `Chicureo`), tipo de propiedad, nuevo/usado, rango de precio en UF o CLP, dormitorios, baños y fecha de publicación. También acepta URLs de búsqueda de TocToc. **Descarta automáticamente los avisos dados de baja** que el buscador de TocToc sigue mostrando (entre 10% y 30% de los resultados), y no se cobran. Se cobra por propiedad guardada (más un extra opcional por ficha con detalle); el precio vigente para tu plan está en la pestaña **Pricing**. El proxy residencial chileno está incluido. Nunca se nombra a personas naturales: los avisos de particulares solo se marcan como `private_owner`. # Actor input Schema ## `locations` (type: `array`): One search per entry, resolved with TocToc's own location search: a comuna (`Las Condes`, `Ñuñoa`, `Viña del Mar`), a region (`Región Metropolitana`, `Región de Valparaíso`), or a neighbourhood (`Barrio Italia`, `Chicureo`, `Reñaca`). Use `Comuna, Region` to disambiguate (`Los Ángeles, Biobío`). Names that are both a comuna and a region (Valparaíso, Antofagasta, Coquimbo...) search the comuna unless you write `Región de ...`. Leave empty to search all of Chile. ## `operation` (type: `string`): `venta` = for sale (used and new projects), `arriendo` = for rent. ## `propertyTypes` (type: `array`): One or more property types. Leave empty for all types. ## `condition` (type: `string`): `new` = new-development projects (proyectos nuevos, sold by developers), `used` = resale listings from brokers and owners. Ignored for rentals. ## `priceCurrency` (type: `string`): Currency of the price range below. TocToc converts between UF and CLP itself, so a UF range also matches listings published in pesos. ## `priceMin` (type: `integer`): In the currency chosen above. Leave empty for no minimum. ## `priceMax` (type: `integer`): In the currency chosen above. Leave empty for no maximum. ## `bedroomsMin` (type: `integer`): New projects match when any of their unit types fits. ## `bedroomsMax` (type: `integer`): Leave empty for no maximum. ## `bathroomsMin` (type: `integer`): Leave empty for no minimum. ## `bathroomsMax` (type: `integer`): Leave empty for no maximum. ## `publishedWithinDays` (type: `integer`): Only listings published on TocToc in the last N days (e.g. `1`, `7`, `30`). Leave empty for any date. Handy for daily monitoring runs. ## `sort` (type: `string`): `relevance` is the site default (new projects first). Use `newest` for monitoring pipelines. ## `startUrls` (type: `array`): Paste search pages from toctoc.com instead of using the fields above, e.g. `https://www.toctoc.com/venta/departamento/metropolitana/nunoa` or a `https://www.toctoc.com/resultados/lista/arriendo/...?...` URL with filters. Operation, property type, location and the URL's filters (price, bedrooms, bathrooms, surfaces, amenities, sort) are taken from each URL. When URLs are given, the Search and Filters fields are ignored. ## `maxItems` (type: `integer`): Stop after this many properties in total (across all locations / URLs). TocToc serves up to 600 listings per API page, so large runs are fast. ## `maxItemsPerSearch` (type: `integer`): Optional limit for each location or start URL, so a multi-comuna run gets results from every comuna instead of filling `Max properties` with the first one. Leave empty or 0 for no per-search limit. ## `skipUnavailable` (type: `boolean`): TocToc's search index keeps serving ads that were already taken down (their page says "Propiedad no disponible"; typically 10–30% of results). When on, the actor checks every result against the live photo index and drops those, and you are not charged for them. Turn off to receive them with `available: false`. ## `includePublisherNames` (type: `boolean`): Fill `publisherName` for real-estate companies (brokers and developers) by opening one listing per company and caching the name for all its other ads. Private owners are never named. Turn off for slightly faster runs. ## `fetchDetails` (type: `boolean`): Open every listing page (1 extra request per property) to add: full description, street address, year built, delivery status (entrega inmediata / en verde / en blanco), video, page views, last-modified date and the broker's listing code. Billed as an extra `property-details` event per property. ## `proxyConfiguration` (type: `object`): TocToc's firewall answers datacenter IPs (Apify's included) with a JavaScript challenge, so the default is Apify RESIDENTIAL proxy with a Chilean IP. The actor keeps the IP-bound API token on one sticky session, rotates to a fresh IP if TocToc ever rate-limits it, and spreads listing pages over a few extra sessions. If you switch the proxy off and TocToc refuses the IP, the actor falls back to RESIDENTIAL (Chile) automatically. ## Actor input object example ```json { "locations": [ "Las Condes" ], "operation": "venta", "propertyTypes": [ "departamento" ], "condition": "any", "priceCurrency": "UF", "sort": "relevance", "maxItems": 50, "skipUnavailable": true, "includePublisherNames": true, "fetchDetails": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "CL" } } ``` # Actor output Schema ## `properties` (type: `string`): All property listings collected during the run ## `summary` (type: `string`): Per-search totals, delisted ads skipped, detail and proxy statistics # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "locations": [ "Las Condes" ], "propertyTypes": [ "departamento" ], "maxItems": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "CL" } }; // Run the Actor and wait for it to finish const run = await client.actor("fabrikit/toctoc-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "locations": ["Las Condes"], "propertyTypes": ["departamento"], "maxItems": 50, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "CL", }, } # Run the Actor and wait for it to finish run = client.actor("fabrikit/toctoc-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "locations": [ "Las Condes" ], "propertyTypes": [ "departamento" ], "maxItems": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "CL" } }' | apify call fabrikit/toctoc-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,fabrikit/toctoc-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/meeAVxO2Ol07647is/builds/Qlnp53gxwcJRQuKIk/openapi.json