# Chileautos Scraper — Chile Used & New Car Listings (`fabrikit/chileautos-scraper`) Actor

Scrape car listings from Chileautos.cl, Chile's largest car marketplace: make, model, trim, year, price (CLP), km, fuel, gearbox, body, region, dealer, photos, badges. Filter by make, model, year, price, km, region, seller. Full specs add-on. From US$3 per 1,000 vehicles.

- **URL**: https://apify.com/fabrikit/chileautos-scraper.md
- **Developed by:** [Fabrikit](https://apify.com/fabrikit) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 vehicle 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

## Chileautos Scraper — Chile Used & New Car Listings

Extract vehicle listings from **[Chileautos.cl](https://www.chileautos.cl)**, Chile's largest car marketplace (~70,000 active listings of cars, pickups, SUVs, motorcycles, trucks and more). Get clean, structured data: make, model, trim, year, price in CLP, mileage, fuel, transmission, body type, region, seller type, dealer name, photos and badges. Optionally add the full spec sheet, equipment list, color, comuna, publication date and the seller's description.

Built for **reliability**: the Actor reads the same JSON endpoints the website uses (no fragile HTML parsing), detects anti-bot challenges and switches automatically to Chilean residential proxies when needed, and **never finishes "successfully" with zero results when something went wrong** — it either returns data or fails with a clear message.

### What you can do with it

- **Price monitoring & market research** — track asking prices by make, model, year and region; build depreciation curves.
- **Dealer lead generation** — list automotoras (dealers) with their stock size, regions and price ranges.
- **Inventory analytics** — supply by body type, fuel (hybrid/electric adoption), transmission, mileage bands.
- **Car-buying alerts** — run daily with `sort: newest` and diff the results to catch new listings fast.
- **Valuation models / ML datasets** — tens of thousands of priced listings with mileage, year and specs.

### Features

- Filters: **make, model, keyword, vehicle type, condition (used/new), seller type (dealer/private), region, city, body type, fuel, transmission, year range, price range (CLP), mileage range**.
- Or paste **direct URLs**: any chileautos.cl search page (including filtered `?q=...` URLs) or individual listing pages.
- Sorting: newest, relevance, price, mileage, model year.
- **No 900-result ceiling**: the site only pages through 900 results per search; when you ask for more, the Actor transparently splits the search into price bands and keeps going (tested: 1,000 unique Toyotas in strict price order in 45 seconds).
- **Optional details add-on** (`fetchDetails`): exterior/interior color, comuna, doors, seats, engine cc, cylinders, drivetrain, publication date, saleStatus, description, 60+ spec fields (power, torque, dimensions, airbags, consumption...), equipment list and the financing simulation shown on the listing.
- Deduplicated by listing ID, exact `maxItems`, a `SUMMARY` record in the key-value store with request counts, transfer size and errors.
- **Privacy by design**: private sellers' names and phone numbers are never collected; phone numbers and e-mails typed into descriptions are redacted. Dealer names (businesses) are included.

### Input examples

**Toyota Corolla 2018+ under 15 million CLP in the Santiago Metropolitan Region, cheapest first:**

```json
{
    "make": "Toyota",
    "model": "Corolla",
    "region": "metropolitana",
    "yearMin": 2018,
    "priceMax": 15000000,
    "sort": "price_asc",
    "maxItems": 200
}
```

**All hybrid and electric SUVs from dealers, with full details:**

```json
{
    "bodyType": "suv",
    "fuel": "hybrid",
    "sellerType": "dealer",
    "fetchDetails": true,
    "maxItems": 500
}
```

**Direct URLs (search pages and/or single listings):**

```json
{
    "startUrls": [
        "https://www.chileautos.cl/vehiculos/land-rover/range-rover-evoque/",
        "https://www.chileautos.cl/vehiculos/?q=(And.Marca.Kia._.Ano.range(2020..).)&sort=~Price",
        "https://www.chileautos.cl/vehiculos/detalles/2019-toyota-corolla-1-8-xei-4x2-cvt-at-4p/CP-AD-8562919/"
    ],
    "maxItems": 100
}
```

**Daily new-listings feed (whole site):**

```json
{
    "sort": "newest",
    "maxItems": 1000
}
```

#### Input reference

| Field | Description |
|---|---|
| `startUrls` | Optional list of chileautos.cl search or listing URLs. When set, the filters are ignored. |
| `make`, `model` | As written on the site (`Mercedes-Benz`, `Land Rover`, `Rav4`). Case-insensitive; unknown names fail with a clear error. |
| `keyword` | Free-text keyword (e.g. `4x4`, `GT`). |
| `vehicleType` | `any`, `cars`, `motorcycles`, `trucks`, `buses`, `machinery`, `boats`, `motorhomes`. |
| `condition` | `any`, `used`, `new`. |
| `sellerType` | `any`, `dealer`, `private`. |
| `region` | One of Chile's 16 regions (`metropolitana`, `valparaiso`, `biobio`, ...). |
| `city` | City inside the region (`Temuco`, `Viña del Mar`). Requires `region`. |
| `bodyType` | `suv`, `sedan`, `hatchback`, `pickup`, `station_wagon`, `coupe`, `convertible`, `citycar`, `van`, `furgon`, `off_road`, `cabina_simple`, `cabina_extendida`. |
| `fuel` | `gasoline`, `diesel`, `hybrid`, `electric`, `gas`. |
| `transmission` | `automatic`, `manual`. |
| `yearMin` / `yearMax` | Model year range (0 = open). |
| `priceMin` / `priceMax` | Price range in CLP (0 = open). |
| `kmMin` / `kmMax` | Mileage range in km (0 = open). |
| `sort` | `newest` (default), `relevance`, `price_asc`, `price_desc`, `km_asc`, `km_desc`, `year_desc`, `year_asc`. |
| `maxItems` | Maximum vehicles to return (default 50). |
| `fetchDetails` | Add the listing-page data (add-on event). Default `false`. |
| `proxyConfiguration` | Optional. Leave the default: the Actor falls back to Chilean residential proxies automatically if the site challenges it. |

### Output example

One item per vehicle (with `fetchDetails: true`; without it, the detail-only fields are `null`):

```json
{
    "id": "CP-AD-8562919",
    "url": "https://www.chileautos.cl/vehiculos/detalles/2019-toyota-corolla-1-8-xei-4x2-cvt-at-4p/CP-AD-8562919/",
    "title": "2019 Toyota Corolla 1.8 XEI 4X2 CVT AT 4P",
    "make": "Toyota",
    "model": "Corolla",
    "version": "1.8 XEI 4X2 CVT AT 4P",
    "year": 2019,
    "price": 12590000,
    "currency": "CLP",
    "priceText": "$12.590.000 CLP",
    "mileageKm": 50000,
    "fuelType": "Bencina",
    "transmission": "Automática",
    "bodyType": "Sedán",
    "color": "Red",
    "interiorColor": "Gris",
    "doors": 4,
    "seats": 5,
    "engineLiters": 1.8,
    "engineCc": 1798,
    "cylinders": 4,
    "drivetrain": "4X2",
    "fuelEconomyKmL": 14.4,
    "condition": "used",
    "region": "Metropolitana de Santiago",
    "city": "Providencia",
    "sellerType": "dealer",
    "dealerName": "ZM Motors",
    "badges": ["TOP NITRO"],
    "isPromoted": true,
    "promotionType": "top spot nitro",
    "photos": [
        "https://chileautos.pxcrush.net/cars/dealer/3gb3b3i5wyotvhhlrpzby7sqa.jpg",
        "https://chileautos.pxcrush.net/cars/dealer/1kssugp637mh0aawmq6el4dok.jpg"
    ],
    "photoCount": 35,
    "publishedAt": "2026-06-11T00:15:23",
    "saleStatus": "in stock",
    "description": "TOYOTA COROLLA 2019 AUTOMÁTICO – único dueño, 3 meses de garantía...",
    "specs": {
        "Power": "140",
        "Torque": "173",
        "Cilindrada exacta (cc)": "1798",
        "Cantidad de airbags": "7",
        "Capacidad del maletero (L)": "470",
        "Tipo de transmisión": "Automática De 7 Velocidades"
    },
    "equipment": ["ABS", "Airbag", "Bluetooth", "Cámara de retroceso", "Climatización", "GPS", "USB"],
    "financing": { "monthlyPayment": 361102, "months": 48, "annualCae": "16,66%", "totalCost": 17332896 },
    "detailsFetched": true,
    "scrapedAt": "2026-10-12T16:42:19.091Z"
}
```

Field notes:

- `price` is in Chilean pesos (CLP). `priceText` is the label shown on the site.
- `sellerType` is `dealer` (automotora) or `private`. `dealerName` is only filled for dealers.
- `isPromoted` / `promotionType` mark paid placements (`top spot nitro`, `top spot`, `showcase dealer`), which the site injects at the top of "relevance" results.
- `engineLiters`, `doors` and `drivetrain` are parsed from the trim string when details are not fetched, and taken from the spec sheet when they are.
- `publishedAt` is the site's publish timestamp (Chile local time) and is `null` when the site does not expose one.
- `photos` holds the full-size photo URLs available on the card (up to 5) or listing page; `photoCount` is the total number of photos on the listing.

### Pricing

Pay per event — you only pay for results:

| Event | Price | When |
|---|---|---|
| Vehicle result | **US$3.00 per 1,000** (US$0.003 each) | Every vehicle saved to the dataset |
| Vehicle details (add-on) | **US$2.00 per 1,000** (US$0.002 each) | Each listing page opened when `fetchDetails` is on (and for direct listing URLs) |
| Actor start | US$0.00005 | Once per run |

Example: 1,000 vehicles without details ≈ US$3.00; with full details ≈ US$5.00. Platform usage (compute, proxy) is included.

### FAQ

**How many listings can I get?**
As many as the site has (~70,000). Searches above 900 results are split into price bands automatically, so one run can export a whole make or the entire site.

**How fast is it?**
About 300 vehicles in 10 seconds without details; details add one request per vehicle (5 in parallel), roughly 30 vehicles in 7 seconds.

**Do I need a proxy?**
No. The Actor connects directly and only switches to Apify residential proxies in Chile if the site's anti-bot protection challenges it. That switch is automatic and logged.

**What if the site blocks or changes?**
Every response is checked. Blocks trigger fresh sessions and the residential fallback; if data still cannot be fetched, the run fails with an explicit error instead of returning an empty dataset. A search that legitimately has no matches ends with a clear "0 listings match" status message.

**Can I get the seller's phone number?**
No. To respect Chilean data-protection law (Ley 19.628 / 21.719), the Actor does not collect private sellers' names or contact details, and redacts phone numbers and e-mails found inside descriptions. Dealer (business) names are included.

**Why are some fields null?**
Not every listing publishes every attribute (e.g. private sellers often skip interior color or specs). Detail-only fields are `null` unless `fetchDetails` is on.

**Is the `make`/`model` spelling important?**
Matching is case-insensitive and the Actor resolves common variants through the site's own catalog (`mercedes benz` → `Mercedes-Benz`). If a make or model does not exist on the site, the run fails immediately with a message instead of returning nothing.

### En español

**Chileautos Scraper** extrae avisos de autos usados y nuevos de Chileautos.cl: marca, modelo, versión, año, precio en pesos, kilometraje, combustible, transmisión, carrocería, región, tipo de vendedor (automotora o particular), nombre de la automotora, fotos y distintivos. Con el complemento de detalles agrega color, comuna, puertas, cilindrada, fecha de publicación, descripción, ficha técnica completa, equipamiento y simulación de financiamiento.

Filtra por marca, modelo, año, precio, kilometraje, región, ciudad, carrocería, combustible, transmisión, condición y tipo de vendedor, o pega URLs de búsqueda o de avisos. Supera el límite de 900 resultados por búsqueda dividiendo automáticamente en tramos de precio. No recopila nombres ni teléfonos de particulares (Ley 21.719).

Precio: US$3 por 1.000 vehículos; detalles US$2 por 1.000 adicionales.

# Actor input Schema

## `startUrls` (type: `array`):

Paste chileautos.cl URLs instead of using the filters below: search result pages (e.g. `https://www.chileautos.cl/vehiculos/toyota/corolla/` or a filtered URL with `?q=...`) and/or individual listing pages (`https://www.chileautos.cl/vehiculos/detalles/.../CP-AD-8562919/`). When this list is not empty, the filter fields are ignored. Listing URLs always include full details.

## `make` (type: `string`):

Brand as written on chileautos.cl, e.g. `Toyota`, `Mercedes-Benz`, `Land Rover`, `Chery`. Case-insensitive. Leave empty for all makes.

## `model` (type: `string`):

Model name, e.g. `Corolla`, `Hilux`, `RAV4`. Best used together with Make.

## `keyword` (type: `string`):

Free-text keyword matched against the listing (e.g. `4x4`, `hybrid`, `GT`).

## `vehicleType` (type: `string`):

Chileautos also lists motorcycles, trucks, buses, machinery, boats and motorhomes. `Cars, pickups & SUVs` covers ~90% of the site.

## `condition` (type: `string`):

Used or new vehicles.

## `sellerType` (type: `string`):

`dealer` = automotoras (car dealers), `private` = private sellers.

## `region` (type: `string`):

Chilean region where the vehicle is located.

## `city` (type: `string`):

City inside the selected Region, as the site names it (e.g. `Temuco`, `Concepcion`, `Viña del Mar`, `Santiago`). Requires a Region.

## `bodyType` (type: `string`):

Body style (carrocería).

## `fuel` (type: `string`):

Fuel type.

## `transmission` (type: `string`):

Gearbox type.

## `yearMin` (type: `integer`):

Oldest model year. 0 = no limit.

## `yearMax` (type: `integer`):

Newest model year. 0 = no limit.

## `priceMin` (type: `integer`):

Minimum price in Chilean pesos, e.g. `5000000`. 0 = no limit.

## `priceMax` (type: `integer`):

Maximum price in Chilean pesos, e.g. `15000000`. 0 = no limit.

## `kmMin` (type: `integer`):

Minimum odometer reading. 0 = no limit.

## `kmMax` (type: `integer`):

Maximum odometer reading, e.g. `100000`. 0 = no limit.

## `sort` (type: `string`):

`newest` = most recently published/updated first (best for monitoring). `relevance` is the site's default "Destacado" order, which puts paid promoted listings first.

## `maxItems` (type: `integer`):

Stop after this many vehicles. The site pages through at most 900 results per search; above that the Actor automatically splits the search into price bands, so you can export tens of thousands of listings in one run.

## `fetchDetails` (type: `boolean`):

Open each listing's page (1 extra request per vehicle) to add: exterior/interior color, comuna (city), doors, seats, exact engine size (cc), drivetrain, publication date, seller's description, the full spec sheet (60+ fields: power, torque, dimensions, airbags...), equipment list and the dealer's financing simulation. Charged as a separate "vehicle details" event.

## `proxyConfiguration` (type: `object`):

Optional. By default the Actor connects directly and, if Chileautos' anti-bot answers with a challenge, rotates sessions and switches automatically to Apify RESIDENTIAL proxies in Chile. You don't need to change this.

## Actor input object example

```json
{
  "startUrls": [],
  "make": "Toyota",
  "vehicleType": "any",
  "condition": "any",
  "sellerType": "any",
  "region": "any",
  "bodyType": "any",
  "fuel": "any",
  "transmission": "any",
  "yearMin": 0,
  "yearMax": 0,
  "priceMin": 0,
  "priceMax": 0,
  "kmMin": 0,
  "kmMax": 0,
  "sort": "newest",
  "maxItems": 50,
  "fetchDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `vehicles` (type: `string`):

All vehicle listings collected during the run

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [],
    "make": "Toyota",
    "maxItems": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("fabrikit/chileautos-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": [],
    "make": "Toyota",
    "maxItems": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("fabrikit/chileautos-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 '{
  "startUrls": [],
  "make": "Toyota",
  "maxItems": 50
}' |
apify call fabrikit/chileautos-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,fabrikit/chileautos-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 <APIFY_API_TOKEN>` 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/OGhSKvAcCzvhUnM3q/builds/Xz0bmcgo6odbN1BQ4/openapi.json