# Mexico Vehicle Auctions Scraper: Subastas de Autos (`allanmxr/mexico-vehicle-auctions-scraper`) Actor

Clean JSON of car, motorcycle and truck auction lots in Mexico from Subastas Ventura, Subastas JJ and INDEP: brand, model, year, VIN, state, current bid and market value in MXN, damage status and photos. Filter by brand, year, price and state. No login, API key or browser needed.

- **URL**: https://apify.com/allanmxr/mexico-vehicle-auctions-scraper.md
- **Developed by:** [Allan Marcelino](https://apify.com/allanmxr) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Features:** Limited permissions
- **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 lots

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

## Mexico Vehicle Auctions Scraper (Subastas de Autos en México)

Scrape car, SUV, pickup, motorcycle and truck auction lots in **Mexico** from three sources in one run and get one flat, consistent dataset in **MXN**:

- **Subastas Ventura** (subastasventura.com): insurer salvage, recovered-theft, fleet and used vehicles. The largest catalog (1,000 to 1,700 lots).
- **Subastas JJ** (subastasjjauctions.com): live online auctions of insurer salvage (GNP and others).
- **INDEP** (Instituto para Devolver al Pueblo lo Robado, formerly SAE): federal government auctions of seized vehicles.

No login, no API key, no browser: everything is read over plain HTTP, so runs are short and cheap. Built for dealers, importers, parts buyers and anyone hunting for a bargain vehicle.

### Who it is for

Dealers, importers, parts buyers, salvage buyers, insurers and anyone hunting for a bargain vehicle in Mexico.

### Input

| Field | Description |
|---|---|
| `searchTerms` | Vehicle names, e.g. `["onix", "hilux sr"]`. A lot matches when it contains every word of at least one term (accents and case ignored). Empty means all vehicles. |
| `vehicleType` | `all` (default), `car` (includes SUVs and pickups), `motorcycle` or `truck`. |
| `brands` | Only these brands (Nissan, Chevrolet, Volkswagen, Toyota...). |
| `maxItems` | Maximum lots, shared fairly across the sources. |
| `yearMin`, `yearMax` | Model year range. |
| `priceMin`, `priceMax` | In MXN, compared with the current bid or, without bids, the starting price. |
| `states` | Mexican states where the vehicle is. |
| `damage` | `all`, `no_damage` (only lots explicitly listed as used/like-new) or `damaged_only` (salvage, scrap, parts). |
| `auctionDateFrom`, `auctionDateTo` | Auction date range. |
| `sources` | `ventura`, `jj`, `indep`. All by default. |
| `proxyConfiguration` | Optional. By default the actor connects directly and only uses Apify Proxy (Mexico) if a site blocks it. |

#### Example

```json
{ "searchTerms": ["onix"], "yearMin": 2020, "states": ["Jalisco", "Nuevo León"], "damage": "damaged_only", "maxItems": 50 }
```

### Output

One flat item per lot, same fields for every source (`null` when a source does not publish a field):

`source`, `lotId`, `url`, `title`, `vehicleType`, `brand`, `model`, `version`, `yearModel`, `color`, `vin`, `seller`, `origin`, `city`, `state`, `currentBid`, `startingPrice`, `marketValue`, `hasBids`, `currency` (always `MXN`), `auctionStart`, `auctionEnd`, `auctionDate`, `condition`, `isSalvage`, `imageUrl` (main photo), `images` (full photo gallery, main photo first; about 20 photos per lot on Ventura and JJ, about 12 on INDEP), `scrapedAt`.

```json
{
  "source": "jj",
  "title": "CHEVROLET ONIX 2023",
  "brand": "CHEVROLET", "model": "ONIX", "yearModel": 2023,
  "state": "Veracruz", "currentBid": 26000, "marketValue": 167400,
  "currency": "MXN", "condition": "para reparar", "isSalvage": true,
  "auctionEnd": "2026-11-17T16:53:50-06:00"
}
```

What each source provides: Ventura has starting price, market value, category, VIN and auction date. JJ has live bid, start and end time, color, version, VIN and market value. INDEP has starting price, current bid, seller agency, state and sale window. No source publishes the odometer reading (Ventura only shows a photo of it), so there is no mileage field or filter.

### Data and privacy

Only vehicle data and company or agency names (insurers, government bodies) are collected. No personal data of individuals (names, phones, e-mails of debtors or owners) is read. The VIN identifies a vehicle, not a person.

### Pricing

Pay per event: **US$ 3.00 per 1,000 lots** (US$ 0.003 per lot, event `result-item`), charged for each lot written to the dataset. Platform usage is included. Filters are applied before charging, so you only pay for the lots you get.

| Lots | Cost |
|---|---|
| 50 | US$ 0.15 |
| 500 | US$ 1.50 |
| 1,000 | US$ 3.00 |

### FAQ

**Which sources are covered?** Subastas Ventura, Subastas JJ and INDEP (federal government).

**Are prices in pesos?** Yes, everything is MXN.

**Is there a mileage field?** No. No source publishes the odometer reading.

**Do I need a proxy?** No. The Actor connects directly and only uses Apify Proxy (Mexico) if a site blocks it.

**Can I run it on a schedule?** Yes. Use an Apify schedule and compare `lotId` between runs.

***

## Scraper de Subastas de Autos en México (Español)

Extrae lotes de **subastas de autos, camionetas, motos y camiones en México** de tres fuentes en una sola corrida, en un dataset limpio y en **pesos mexicanos (MXN)**:

- **Subastas Ventura**: salvamentos de aseguradoras, recuperadas de robo, flotillas y seminuevos. El catálogo más grande (de 1,000 a 1,700 lotes).
- **Subastas JJ**: subastas en línea de salvamentos de aseguradoras (GNP y otras).
- **INDEP** (Instituto para Devolver al Pueblo lo Robado, antes SAE): subastas del gobierno federal de vehículos asegurados.

Sin login, sin API key y sin navegador. Útil para compradores de salvamentos, importadores, refaccionarias y cazadores de oportunidades.

Búsquedas típicas: **subasta de autos siniestrados**, **subastas de camionetas en Monterrey**, **autos de remate en Guadalajara**, **vehículos del INDEP**, **subastas de motos**, **salvamentos GNP**, **autos para reparar CDMX**.

Cada lote incluye `images` con la galería completa de fotos (la foto principal primero) y `imageUrl` con la foto principal.

Filtros: marca, modelo, año, precio en MXN, estado de la república, daño (siniestrado o sin daño), tipo de vehículo, fecha de subasta y casa de subastas.

**Precio:** US$ 3.00 por cada 1,000 lotes (US$ 0.003 por lote entregado). Ejemplo: 50 lotes cuestan US$ 0.15.

### Other Actors by the same author

- [Brazil Vehicle Auctions Scraper](https://apify.com/allanmxr/brazil-vehicle-auctions-scraper)
- [Brazil Public Tenders Scraper](https://apify.com/allanmxr/brazil-public-tenders)
- [Brazil Real Estate Scraper](https://apify.com/allanmxr/brazil-real-estate-scraper)
- [Brazil Real Estate Auctions Scraper](https://apify.com/allanmxr/brazil-real-estate-auctions)

# Actor input Schema

## `searchTerms` (type: `array`):

Vehicle names, for example "onix" or "hilux sr". A lot matches when it contains every word of at least one term (accents and case are ignored). Leave empty to list all vehicles, up to Max items.

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

Keep every type, or only cars (SUVs and pickups included), motorcycles, or trucks and heavy equipment.

## `brands` (type: `array`):

Only lots of these brands. Leave empty for all brands.

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

Maximum number of lots in the dataset, shared across the auction houses (each one contributes in turn, so the biggest does not use up the limit). You are charged per lot returned.

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

Skip vehicles older than this model year. Lots whose year cannot be read are skipped when a year filter is set.

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

Skip vehicles newer than this model year.

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

Compared with the current bid, or the starting price when there is no bid yet.

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

Compared with the current bid, or the starting price when there is no bid yet.

## `states` (type: `array`):

Only lots located in these Mexican states. Leave empty for the whole country. Lots whose location is unknown are dropped when a state is selected.

## `damage` (type: `string`):

Insurer salvage, recovered-theft, scrap and parts-only lots are flagged isSalvage = true. "Without damage" keeps only lots the source explicitly lists as used or like-new (Ventura SEMINUEVAS); lots whose condition is unknown are not kept by either damage option.

## `auctionDateFrom` (type: `string`):

Only lots whose auction ends on or after this date.

## `auctionDateTo` (type: `string`):

Only lots whose auction ends on or before this date.

## `sources` (type: `array`):

Which auction houses to scrape. Leave all selected to search everywhere.

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

Optional. By default the actor connects directly and only climbs to Apify Proxy (Mexico) if a site blocks it. Set this to force a specific proxy.

## Actor input object example

```json
{
  "searchTerms": [
    "onix"
  ],
  "vehicleType": "all",
  "maxItems": 20,
  "yearMin": 2020,
  "damage": "all",
  "sources": [
    "ventura",
    "jj",
    "indep"
  ]
}
```

# Actor output Schema

## `results` (type: `string`):

All scraped items in the default dataset.

# 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 = {
    "searchTerms": [
        "onix"
    ],
    "maxItems": 20,
    "yearMin": 2020,
    "sources": [
        "ventura",
        "jj",
        "indep"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("allanmxr/mexico-vehicle-auctions-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 = {
    "searchTerms": ["onix"],
    "maxItems": 20,
    "yearMin": 2020,
    "sources": [
        "ventura",
        "jj",
        "indep",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("allanmxr/mexico-vehicle-auctions-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 '{
  "searchTerms": [
    "onix"
  ],
  "maxItems": 20,
  "yearMin": 2020,
  "sources": [
    "ventura",
    "jj",
    "indep"
  ]
}' |
apify call allanmxr/mexico-vehicle-auctions-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,allanmxr/mexico-vehicle-auctions-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/drmE0sXVfXbhAktWT/builds/XjDMY85zHlWabT9qg/openapi.json
