# Mobiauto Scraper (`ribtools/mobiauto-scraper`) Actor

Scrape Mobiauto car, motorcycle and truck listings in Brazil: type a make or model with filters, or paste any search, dealer or ad URL. Prices, specs, FIPE, locations, seller contacts.

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

## Pricing

from $1.99 / 1,000 vehicle data results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## Mobiauto Scraper

Extract car, motorcycle and truck listings from **Mobiauto**, one of Brazil's large vehicle marketplaces — make, model, version, year, mileage, price, Mobiauto's price badge, city and dealer — plus optional ad details (FIPE price and code, equipment, market price range) and seller contacts.

### What is Mobiauto Scraper?

**Mobiauto Scraper** is a powerful data extraction tool that automatically collects vehicle listings from [Mobiauto](https://www.mobiauto.com.br/), the Brazilian marketplace for carros usados e novos, motos and caminhões sold by dealers (revendas, concessionárias, locadoras) and private sellers. Type a make or model (or paste Mobiauto URLs) and get structured data including make, model, version, production and model year, mileage, fuel, transmission, body type, price, Mobiauto's "super price" / "good price" badge, city and state, and the dealer — with optional add-ons for the ad details (tabela FIPE price and code, the plate's last digit, equipment, conditions and Mobiauto's market price range) and the seller's contacts.

This scraper handles pagination, anti-bot protection, and data normalization automatically, delivering clean, structured datasets ready for analysis or integration into your systems.

### What can this Actor do?

- **Extract comprehensive vehicle data** — make, model, version, year, model year, mileage, fuel, transmission, body type, doors, price, photos, city and state
- **Three categories** — cars (carros), motorcycles (motos) and trucks (caminhões), new and used
- **Search by vehicle** — type a make, a model or both (`Tiggo 7`, `chery`, `Volkswagen Polo`), matched against Mobiauto's own catalog, with filters for condition, state, city, year, seller type, price and mileage
- **Handle multiple entry points** — searches with any filters (state, city, make, model, version, new/used, Mobiauto's filter codes), dealer stock pages and single ads
- **Automatic pagination** — crawls through all search result pages (24 vehicles per page)
- **Ad details add-on** — description, color, FIPE price and code, the plate's last digit, equipment list, ad conditions, trade-in and armored flags, engine size, power, seats, drivetrain and Mobiauto's min/max/average market price
- **Seller data add-on** — seller name and type, phones and WhatsApp when the ad shows them, website, and for dealers the address, postal code, map location and Mobiauto stock page
- **Privacy by design** — private sellers' names and locations stay out of the base results; full plates are never returned
- **No duplicates** — each vehicle is returned (and charged) once per run
- **Premium proxies included** — high-quality Brazilian residential proxies built in at no additional cost
- **Structured output** — JSON, CSV, Excel formats available
- **API integration** — real-time data access through Apify API
- **Scheduled runs** — automated daily/weekly data collection

### What data can Mobiauto Scraper extract?

| Field | Description | Example |
| ----- | ----------- | ------- |
| **ID** | Mobiauto ad identifier | 31645354 |
| **Title** | Make, model and version | Nissan Versa 1.0 12V S (Flex) |
| **Category** | Cars, motorcycles or trucks | carros, motos, caminhoes |
| **Make / Model / Version** | Vehicle identity | Nissan, Versa, 1.0 12V S (Flex) |
| **Condition** | New (0 km) or used | used |
| **Price** | Asking price in BRL | 51900 |
| **Price Tag** | Mobiauto's below-market badge | SUPER_PRICE, GOOD_PRICE |
| **Year / Model Year** | Production and model year | 2018, 2018 |
| **Mileage** | Kilometers | 86000 |
| **Fuel / Transmission / Body** | Powertrain and body | Flex, Manual, Sedan |
| **City / State** | Location | São Paulo, SP |
| **Seller** | Seller type, dealer name and id | dealer, MERCES VEÍCULOS, 13473 |
| **Photos** | Photo URLs | https://image1.mobiauto.com.br/... |
| **Details** (add-on) | FIPE price and code, color, final plate digit, equipment, conditions, engine, power, market price range | 49055, 023132-0, Preto, 8 |
| **Seller** (add-on) | Name, type, phones, WhatsApp, website, address, postal code, map location | Loja, (11) 0000-0000 |

### How to scrape Mobiauto

#### Step-by-step tutorial:

1. **Type vehicles** — Add one make, model or both per line in *Search vehicles*, as you would in Mobiauto's search box
2. **Or paste URLs** — Add Mobiauto search, dealer stock or ad URLs in *Mobiauto URLs* (see below). You can use both; each vehicle and each URL is its own search
3. **Set filters** (optional) — Vehicle type, condition, state, city, year, seller type, price and mileage. They apply to typed vehicles only; a URL keeps the filters it carries
4. **Enable add-ons** (optional) — Ad details and/or seller data
5. **Run the scraper** — Click "Start" and monitor progress in real-time
6. **Download results** — Export data in JSON, CSV, or Excel format

Proxies are included automatically — no setup required.

#### Search by vehicle

Typed text is matched against Mobiauto's own catalog, so spelling does not have to be exact. The status message of the run shows what each line resolved to.

- `Tiggo 7` — the model Tiggo 7 (CAOA Chery)
- `chery` or `cherry` — every model of the make CAOA Chery
- `Volkswagen Polo` — the model Polo (Volkswagen)
- `mercedes` — every model of the make Mercedes-Benz

Typed vehicles search cars by default; set *Vehicle type* to Motorcycles or Trucks for the other two (a motorcycle typed as a car, like `cg 160`, is skipped with that hint). A vehicle or a city Mobiauto does not know is skipped and named in the status message; it never returns unrelated results. `Max results per search` caps each vehicle separately.

With a *City*, Mobiauto searches around it: 25 km, widened by Mobiauto itself (up to 250 km seen) when few vehicles match. The run's status message names the radius it used, e.g. `'Tiggo 7' (CAOA Chery Tiggo 7 within 100 km of Campinas/SP)`.

#### Mobiauto URLs

- **All of Brazil**: `https://www.mobiauto.com.br/comprar/carros/brasil`
- **State or city**: `https://www.mobiauto.com.br/comprar/carros/sp-sao-paulo`
- **Make, model, version**: `https://www.mobiauto.com.br/comprar/carros/brasil/fiat/mobi/like-1-0`
- **New or used only**: `https://www.mobiauto.com.br/comprar/carros-usados/rj`
- **Motorcycles and trucks**: `https://www.mobiauto.com.br/comprar/motos/brasil/honda`, `https://www.mobiauto.com.br/comprar/caminhoes/brasil`
- **Filtered searches**: any Mobiauto search URL with its `?sop=...` filters, and `/pagina-N` to start on a later page
- **Dealer stock**: `https://www.mobiauto.com.br/estoque/merces-veiculos-13473`
- **Single ad**: `https://www.mobiauto.com.br/comprar/carros/sp-sao-paulo/nissan/versa/2018/1-0-12v-s-flex/detalhes/31645354` or `https://www.mobiauto.com.br/comprar/detalhes/31645354`

**Important**: Only URLs matching these patterns will work. A URL keeps exactly the filters it carries. Searches and dealer stock pages are read in **lowest-price order** (or highest-price order, when your URL already sorts that way), because Mobiauto reshuffles its other orders on every page, which would skip and repeat vehicles. Mobiauto shows at most **9,984 results per search**: split a larger search by state or make to get everything.

### How much does it cost to scrape Mobiauto?

Mobiauto Scraper uses **pay-per-result (PPR)** pricing — you only pay for successfully extracted vehicles.

#### Is scraping Mobiauto free?

The scraper follows Apify's PPR model with the following structure:

- **Base extraction**: one charge per vehicle returned, with every field from the search results
- **Add-ons**: the ad details add-on is charged per vehicle returned with details; the seller data add-on per vehicle returned with a seller name or phone. Both come from a single extra request per vehicle.

Pricing is optimized for efficiency, using minimal compute units while maintaining high success rates. Contact support for volume discounts on large-scale projects.

### Input configuration

The scraper accepts the following inputs:

Fields are listed in the order of the input form. A run needs at least one vehicle or one URL.

- **Search vehicles** (`vehicles`) — One make, model or both per line, e.g. `Tiggo 7`, `chery`, `Volkswagen Polo`. Each line is its own search
- **Mobiauto URLs** (`startUrls`) — Search, dealer stock or ad URLs (see the examples above). Plain strings or `{"url": ...}` objects
- **Max results per search** (`maxRequests`) — Cap on vehicles for each vehicle and each URL separately. Default 10. Mobiauto itself serves at most 9,984 results per search (416 pages of 24)
- **Vehicle type** (`vehicleType`) — Cars, motorcycles or trucks
- **Condition** (`condition`) — Used and new, used, or new
- **State** (`state`) and **City** (`city`) — Brazilian state (UF) and a city inside it. Mobiauto searches around the city: 25 km, widened by Mobiauto itself (up to 250 km seen) when few vehicles match; the status message names the radius used. A city Mobiauto does not know, or a city without a state, is skipped and named in the status message
- **Year from / to** (`yearFrom`, `yearTo`) — Model year range
- **Seller type** (`sellerType`) — Dealers and private sellers, dealers only, or private sellers only. Dealers include stores, franchised dealerships and rental companies; private sellers are rare on Mobiauto
- **Price from / to** (`priceFrom`, `priceTo`) — Asking price in reais; "to" is 1 or more
- **Mileage to** (`kmTo`) — Highest kilometers driven, 1 km or more (for 0 km vehicles, set Condition to New). Mobiauto has no minimum-mileage filter
- **Fetch ad details** (`detailsAddon`) and **Fetch seller data** (`sellerDataAddon`) — Optional add-ons, described below

The filters apply to typed vehicles only. Pasted URLs keep the filters they carry.

**Proxies included**: high-quality residential proxies are built into the Actor at no additional cost — no proxy configuration is required.

#### Fetch ad details (add-on)

Opens each ad to add the description, color, FIPE price and code, the plate's last digit, equipment list, ad conditions (IPVA paid, inspected, accepts trade-in), armored flag, engine size, power, seats, drivetrain and Mobiauto's market price range for the same version.

#### Fetch seller data (add-on)

Adds the seller's name and type (Loja, Concessionária, Locadora, Pessoa Física), the phone the ad shows (and a dealer's WhatsApp when the ad has one), website and description; for dealers also the street address, postal code, map location and Mobiauto stock page. Private sellers are included, with their name and the phones their ad shows, but never an address or location.

### Output example

```json
{
  "type": "vehicle",
  "id": 31645354,
  "url": "https://www.mobiauto.com.br/comprar/carros/sp-sao-paulo/nissan/versa/2018/1-0-12v-s-flex/detalhes/31645354",
  "title": "Nissan Versa 1.0 12V S (Flex)",
  "category": "carros",
  "search": "Nissan Versa",
  "currency": "BRL",
  "make": "Nissan",
  "model": "Versa",
  "price": 51900,
  "condition": "used",
  "version": "1.0 12V S (Flex)",
  "year": 2018,
  "model_year": 2018,
  "km": 86000,
  "fuel": "Flex",
  "transmission": "Manual",
  "body_type": "Sedan",
  "doors": 4,
  "city": "São Paulo",
  "region": "SP",
  "latitude": -23.6213442,
  "longitude": -46.607954,
  "seller_type": "dealer",
  "seller_id": "13473",
  "seller_name": "MERCES VEÍCULOS",
  "photos": [
    "https://image1.mobiauto.com.br/images/api/images/v1.0/704235433/transform/fl_progressive,f_webp,q_70,w_800",
    "https://image1.mobiauto.com.br/images/api/images/v1.0/704235439/transform/fl_progressive,f_webp,q_70,w_800"
  ],
  "price_tag": null,
  "details": {
    "description": "Escolha a Nissan e garanta qualidade, conforto e tecnologia de ponta em seu veículo. O Nissan Versa 1.0 12V S (Flex) é a...",
    "color": "Preto",
    "final_plate": "8",
    "fipe_price": 49055,
    "fipe_code": "023132-0",
    "features": ["Ar condicionado", "Direção hidráulica", "Controle elétrico do vidros dianteiros", "Travas elétricas"],
    "conditions": ["Ipva pago", "Aceita troca", "Possui vistoria"],
    "accepts_trade": true,
    "armored": false,
    "engine_cc": 999,
    "power_hp": 77,
    "seats": 5,
    "drivetrain": "dianteira",
    "market_price": {"min": 40900, "max": 51900, "average": 48445}
  },
  "seller": {
    "id": "13473",
    "name": "MERCES VEÍCULOS",
    "type": "Loja",
    "phones": ["(11) 0000-0000"],
    "whatsapp": null,
    "profile_url": "https://www.mobiauto.com.br/comprar/estoque/merces-veiculos-13473",
    "website": "https://www.icarros.com.br/ache/estoque.jsp?id=225604",
    "address": "Dom Vilares, 1227",
    "neighborhood": "Vila das Mercês",
    "postal_code": "04160000",
    "city": "São Paulo",
    "region": "SP",
    "latitude": -23.6213442,
    "longitude": -46.607954,
    "description": "há quase 30 anos na mesma avenida trabalhando com transparência e honestidade, v..."
  }
}
```

You can download the dataset extracted by **Mobiauto Scraper** in various formats such as **JSON, HTML, CSV, or Excel**. The data is automatically cleaned and normalized for immediate use in analysis tools, databases, or business applications.

### Use cases and applications

- **Used-car price research** — compare asking prices with the FIPE table and Mobiauto's market range by make, model and year
- **Dealer and inventory monitoring** — track a dealer's stock, new arrivals and price drops across Brazil
- **Lead generation** — build lists of revendas and concessionárias with phones, addresses and websites
- **Market analysis** — measure supply by state, city, fuel, body type and price band for cars, motorcycles and trucks

### Integrations and API access

Mobiauto Scraper seamlessly integrates with popular platforms:

- **Zapier** — Automate data workflows and notifications (via [Apify Zapier integration](https://docs.apify.com/platform/integrations/zapier))
- **Make (Integromat)** — Create complex automation scenarios (via [Apify Make integration](https://www.make.com/en/integrations/apify))
- **Google Sheets** — Direct data export for analysis
- **REST API** — Programmatic access to extracted data ([instructions here](https://docs.apify.com/academy/api/run-actor-and-retrieve-data-via-api))
- **Python/Node.js SDKs** — Easy integration into applications ([instructions here](https://docs.apify.com/academy/api/run-actor-and-retrieve-data-via-api#javascript-and-python-client))

### FAQ and Support

#### Do I need to configure a proxy?

No. Mobiauto sits behind Cloudflare, so the Actor routes every request through high-quality Brazilian residential proxies, included automatically at no additional cost. There's nothing to configure.

#### Why are some sellers' names missing?

Private sellers (Pessoa Física) get no name, seller id or map location in the base results: those are personal data. The seller data add-on returns a private seller's name and the phones their own ad shows, never an address or location. Full license plates are never returned; the details add-on gives the plate's last digit only (used for São Paulo's driving rotation).

#### Why does my search stop at 9,984 vehicles?

Mobiauto itself serves at most 416 pages of 24 vehicles (9,984) per search, typed or pasted. To get the rest of a larger search, split it: type the models one per line in *Search vehicles*, or narrow it by state, city, year or price.

#### Can I filter by specific brands or models?

Yes. Type the make or model in *Search vehicles* (for example `Tiggo 7` or `chery`); it is matched against Mobiauto's own catalog, and the filters (vehicle type, condition, state, city, year, seller type, price, mileage) narrow it down. Or use Mobiauto's search filters in your browser and copy the filtered URL into *Mobiauto URLs*; the URL keeps every filter it carries.

#### How often is the data updated?

Mobiauto updates listings in real-time. For fresh data, schedule regular scraper runs or use our API for on-demand extraction.

#### What if some URLs don't work?

The scraper only supports specific URL patterns from Mobiauto. Ensure your URLs match the compatible formats listed above. URLs outside these patterns will be automatically blocked.

#### Do you offer custom solutions?

Absolutely! We can customize the scraper for specific requirements, additional data points, or integration with your existing systems. Contact us through the Issues tab for enterprise solutions.

#### Need help or have feedback?

- **Report issues**: Use the Issues tab for bug reports and feature requests
- **Custom development**: Contact us for tailored solutions and enterprise integrations

# Changelog

This Actor's version history is a separate document: https://apify.com/ribtools/mobiauto-scraper/changelog.md

# Actor input Schema

## `vehicles` (type: `array`):

Type it the way you would in Mobiauto's search box: a make (`chery`), a model (`Tiggo 7`) or both (`Volkswagen Polo`). One per line, each becomes its own search. Spelling is matched against Mobiauto's own catalog, so `cherry` finds CAOA Chery. Leave empty if you only paste URLs below.

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

Mobiauto URLs copied from your browser: searches for cars, motorcycles and trucks with any filters (e.g. `https://www.mobiauto.com.br/comprar/carros/sp-sao-paulo/fiat/mobi`), dealer stock pages (`/estoque/<dealer>-<id>`) and single ads (`.../detalhes/<id>`). Searches run in lowest-price order (highest, if the URL asks), at most 9,984 results each. A URL keeps exactly the filters it carries.

## `maxRequests` (type: `integer`):

Maximum number of vehicles for each vehicle and each URL above. Each result is a charged event. Default 10.

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

Cars, motorcycles or trucks. Applies to the vehicles typed above.

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

Used, new, or both.

## `state` (type: `string`):

Brazilian state (UF). Leave empty to search the whole country.

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

A city inside the state above, e.g. `Campinas`. Mobiauto searches around the city: 25 km, widened by Mobiauto itself (up to 250 km seen) when few vehicles match; the run's message names the radius used. Leave empty for the whole state. Spelling is checked against Mobiauto's city list.

## `yearFrom` (type: `integer`):

Oldest model year to include.

## `yearTo` (type: `integer`):

Newest model year to include. Leave empty for no upper limit.

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

Dealers (stores, franchised dealerships and rental companies), private sellers, or both. Private sellers are rare on Mobiauto.

## `priceFrom` (type: `integer`):

Lowest asking price to include, in reais.

## `priceTo` (type: `integer`):

Highest asking price to include, in reais: 1 or more (no vehicle is listed at 0).

## `kmTo` (type: `integer`):

Highest mileage to include: 1 km or more. For 0 km vehicles, set Condition to New instead.

## `detailsAddon` (type: `boolean`):

Open each ad to add the description, color, FIPE price and code, the plate's last digit, equipment list, ad conditions (IPVA paid, inspected, ...), trade-in and armored flags, engine size, power, seats, drivetrain and Mobiauto's market price range. Charged per vehicle with details.

## `sellerDataAddon` (type: `boolean`):

Add the seller's name, type, phones and WhatsApp (only when the ad shows them), website and description; for dealers also the address, postal code, map location and Mobiauto stock page. Private sellers included. Charged per vehicle that returns a seller name or phone.

## Actor input object example

```json
{
  "vehicles": [
    "Tiggo 7",
    "Tiggo 8"
  ],
  "startUrls": [
    "https://www.mobiauto.com.br/comprar/carros/sp-sao-paulo/fiat/mobi"
  ],
  "maxRequests": 10,
  "vehicleType": "car",
  "condition": "all",
  "sellerType": "all",
  "detailsAddon": false,
  "sellerDataAddon": false
}
```

# Actor output Schema

## `items` (type: `string`):

All scraped vehicles.

# 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 = {
    "vehicles": [
        "Tiggo 7",
        "Tiggo 8"
    ],
    "maxRequests": 10,
    "detailsAddon": false,
    "sellerDataAddon": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("ribtools/mobiauto-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 = {
    "vehicles": [
        "Tiggo 7",
        "Tiggo 8",
    ],
    "maxRequests": 10,
    "detailsAddon": False,
    "sellerDataAddon": False,
}

# Run the Actor and wait for it to finish
run = client.actor("ribtools/mobiauto-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 '{
  "vehicles": [
    "Tiggo 7",
    "Tiggo 8"
  ],
  "maxRequests": 10,
  "detailsAddon": false,
  "sellerDataAddon": false
}' |
apify call ribtools/mobiauto-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,ribtools/mobiauto-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/Bqdi3w0OMU8LllbV8/builds/s8Po30b1ZqOFiaWGn/openapi.json