# Avito Cars Scraper - Vehicle Listings, Prices & Specs (`abotapi/avito-auto-listings-scraper`) Actor

Scrape Avito transport: used and new car listings with year, mileage, price, the site's own make facet (186 makes), seller type and the full vehicle attribute table on detail reads. City search or paste links. Resume, incremental updates and MCP export included.

- **URL**: https://apify.com/abotapi/avito-auto-listings-scraper.md
- **Developed by:** [Abot API](https://apify.com/abotapi) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.40 / 1,000 listing records

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

## Avito Auto Scraper - Used & New Car Listings

Avito Auto Scraper turns Avito's transport section into a clean data API. Search used and new car listings by city with the site's own make facet (186 makes) plus price range, keyword, sort and owner-only, or paste search links - and get structured records with year, mileage, price, the full vehicle attribute table (engine, gearbox, drive, owners, VIN signals) and the private-vs-dealer seller signal - then export to JSON, CSV or Excel, or pull the results straight into your app through the API.

### Why This Scraper?

- **Five ways in.** Walk the full catalog page by page, follow selected categories or genres (two independent, live-resolved taxonomies), read the homepage trending rails with rail name and position, or paste your own drama links.
- **Nineteen site languages.** The same numeric title id across every localized catalog - collect one language or all of them, with localized titles, synopses and slugs.
- **Full episode lists.** Every enriched record carries its episode list (number + URL) plus the all-episodes link.
- **Trending rails with rank.** The homepage rails come back with the rail name and the exact position of every title in it.
- **Built for schedules.** Incremental mode returns only new and changed titles on recurring runs, and a refused run fails loudly instead of returning an empty dataset.
- **Honest failures.** An unknown category or genre value is named in the error; a refused run never reads as an empty catalog.

### Use Cases

- **Who:** short-drama analysts - track view and follow counters, episode counts and trending positions across the ShortMax catalog on a schedule.
- **Who:** content researchers - collect descriptions, creators and both genre taxonomies for market studies.
- **Who:** localization teams - compare the same title id across 19 site languages.

### Data You Get

> Sample shape: one title record, from a live record.

| Field | Example |
|---|---|
| `id` | 8062141126 |
| `title` | BMW X5 2.0 AT, 2026 |
| `price` | 4950000 |
| `priceText` | 4 950 000 ₽ |
| `year` | 2026 |
| `mileageKm` | 37750 |
| `make` | bmw |
| `category` | avtomobili |
| `subcategory` | s_probegom |
| `region` | moskva |
| `city` | moskva |
| `address` | Москва, ...| |
| `metro` | (detail read) |
| `sellerType` | private |
| `sellerName` | (detail read) |
| `attributes` | {"Двигатель": "2.0 л / 190 л.с.", ...} |
| `photoUrls` | \["https://..."] |
| `isVerified` | true |
| `url` | https://www.avito.ru/moskva/avtomobili/... |
| `changeType` | NEW |

### How to Use

1. Pick a mode: **Search** builds tokenized car searches from your filters; **URL** scrapes exactly the avito search links you paste (the site's own filter links work as-is).
2. Pick the deal type (used or new cars), then narrow with the make facet, price range, keyword and owner filter.
3. Set **Max items** for the run cap (20 by default) and keep **Fetch detail pages** on for the vehicle attribute table and the seller signal.
4. Run the actor and export the dataset, or select an MCP connector to send records into your apps.

**Used cars in Moscow:**

```json
{"mode": "search", "regions": ["Moscow"], "dealType": "s_probegom", "maxListings": 30}
```

**BMW under 8M RUB, cheapest first:**

```json
{"mode": "search", "regions": ["Moscow"], "make": "bmw", "maxPrice": 8000000, "sortBy": "price_asc", "maxListings": 20}
```

**Private-owner listings only:**

```json
{"mode": "search", "regions": ["Moscow"], "ownerOnly": true, "maxListings": 20}
```

**Watch a make on a schedule:**

```json
{"mode": "search", "regions": ["Moscow"], "make": "toyota", "incrementalMode": true, "stateKey": "aa-watch", "maxListings": 0}
```

#### Run it from your code

**Run it from Python:**

```python
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("abotapi/shortmax-scraper").call(run_input={
    "mode": "catalog",
    "maxItems": 5,
})
items = client.dataset(run["defaultDatasetId"]).list_items().items
```

**Run it from JavaScript:**

```js
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('abotapi/shortmax-scraper').call({
  mode: 'catalog', maxItems: 5,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
```

#### Tips

- Residential proxies are required: the listing routes refuse datacenter IPs. The exit country rotates per session for maximum reliability.
- The make facet uses the site's slug form (vaz_lada, land_rover, mercedes); 186 makes are available.
- Motorcycles, trucks, parts and other transport categories work in URL mode: paste a tokenized link from the site.

### Send results into your apps (MCP connectors)

Optionally send records into the apps you already use through MCP connectors: set **MCP connectors** (for example a Notion database) and cap the export with **Max records to connectors**. The export is a gated side channel: it never changes the dataset.

| Field | What it does |
|---|---|
| `mcpConnectors` | Connector ids to export to (empty = no export). |
| `notionParentPageUrl` | URL or id of the Notion parent page (required for the Notion connector). |
| `maxNotifyListings` | Cap on records written to each connector per run. |

### Input Parameters

| Parameter | Type | Default | Description |
|---|---|---|---|
| `mode` | string | `search` | Filter-driven search, or paste your own avito links. |
| `regions` | array | \["Moscow"] | City names (Москва / Moscow) or avito slugs. |
| `dealType` | string | `s_probegom` | Used cars or new cars. Motorcycles/trucks/parts work in URL mode. |
| `make` | string | - | Make slug (the site's own facet; 186 makes). |
| `minPrice` | integer | - | Price range floor in rubles. |
| `maxPrice` | integer | - | Price range ceiling in rubles. |
| `query` | string | - | Free-text keyword. |
| `sortBy` | string | `default` | Relevance, newest, price up, price down. |
| `ownerOnly` | boolean | false | Exclude dealers. |
| `urls` | array | \[{"url": "https://www.avito.ru/moskva/avtomobili/s_probegom-ASgBAgICAUSGFMjmAQ"}, {"url": "https://www.avito.ru/moskva/avtomobili/bmw-ASgBAgICAUTgtg3klyg"}, {"url": "https://www.avito.ru/moskva/avtomobili/bmw-ASgBAgICAUTgtg3klyg?p=2"}] | Tokenized avito transport links (url mode). |
| `maxListings` | integer | 20 | Hard global cap on records per run (0 = billing cap only). |
| `maxPages` | integer | 0 | Cap on pages per search (0 = no page cap). |
| `fetchDetails` | boolean | true | Read each listing's page for attributes, seller type, coordinates, price history. |
| `proxy` | object | {"useApifyProxy": true, "apifyProxyGroups": \["RESIDENTIAL"]} | Residential required - datacenter is refused on listing routes. |
| `resumeFromRunId` | string | - | Paste a previous run ID to continue without re-collecting or re-charging. |
| `incrementalMode` | boolean | false | Track changes across scheduled runs; suppress and never bill unchanged records. |
| `stateKey` | string | - | Optional name for the incremental baseline. |
| `emitUnchanged` | boolean | false | Also return unchanged records, marked and billed. |
| `emitExpired` | boolean | false | Also return disappeared records, marked and billed. |
| `ignoreFieldsForChanges` | array | - | Extra top-level fields excluded from change detection. |
| `mcpConnectors` | array | - | Connector ids to export to (empty = no export). |
| `notionParentPageUrl` | string | - | URL or id of the Notion parent page (required for the Notion connector). |
| `maxNotifyListings` | integer | 50 | Cap on records written to each connector per run. |

### Output Example

> Sample shape: one listing record, from a live record.

**Live record: BMW X5 2.0 AT, 2026**

```json
{
  "id": "8062141126",
  "title": "BMW X5 2.0 AT, 2026",
  "price": 4950000,
  "year": 2026,
  "mileageKm": null,
  "make": "bmw",
  "category": "avtomobili",
  "subcategory": "s_probegom",
  "region": "moskva",
  "url": "https://www.avito.ru/moskva/avtomobili/bmw_x5_20_at_2026-8062141126"
}
```

### Plan Requirement

Charges include a start fee per run, a per-record fee for every listing returned, and a detail surcharge for each listing whose page was read for full enrichment. Listings returned as search cards without the detail read carry no detail surcharge. Exact prices are on the actor's Pricing tab.

### FAQ

#### How much does it cost?

Charges include a start fee per run, a per-record fee for every listing returned, and a detail surcharge per enriched listing. `Max items` caps the records a run returns, so it also caps the bill. Exact prices are on the actor's Pricing tab.

#### Is it legal to scrape Avito?

The actor reads publicly accessible Avito vehicle listings and listing details. It does not access private accounts or checkout. You are responsible for using the data in line with the site's terms of use, privacy law such as GDPR or CCPA, and applicable regulations; personal data of identifiable individuals requires a lawful basis.

#### Does it scrape comments or reviews?

No. This actor returns vehicle listings and optional listing details; it does not collect comments or reviews.

#### Can I get only new or changed listings on a schedule?

Yes. Turn on **Incremental mode** and schedule the actor. The first run returns everything matching as NEW; later runs return only NEW and UPDATED records. Listing content changes are tracked; rotating photo URLs and view counters are excluded as noise by default. Use **State key** to keep a monitoring campaign stable, and **Emit unchanged** or **Emit expired** only if you also want those rows (they return and bill extra rows).

#### Why did my run fail instead of returning an empty dataset?

A run that never got a single readable answer fails loudly with a connection message instead of reporting an empty dataset. Check the city, vehicle filters, links and proxy settings before retrying.

#### Can I use it with AI agents or MCP?

Yes. Every record is plain JSON over the dataset API, and the MCP connector export sends rows straight into tools like Notion. Point an agent at the dataset items endpoint with the input above.

### 🔗 Want more Avito data?

Pair this actor with these related scrapers from the same team:

<table>
<tr><td>🏷️ <a href="https://apify.com/abotapi/avito-ru-scraper"><b>Avito.ru Scraper</b></a><br>Scrape structured listings from Avito.ru by region, category, filters, or direct URL...</td><td>🧩 <a href="https://apify.com/abotapi/shortmax-scraper"><b>ShortMax Scraper</b></a><br>Scrape the ShortMax short-drama catalog: titles, descriptions, creators, view and follow...</td></tr>
<tr><td>🚗 <a href="https://apify.com/abotapi/drom-auto-listings-scraper"><b>Drom.ru Scraper</b></a><br>Scrape drom.ru vehicle listings: make/model/year/mileage, price, engine and transmission...</td><td>🚗 <a href="https://apify.com/abotapi/cars-com-scraper"><b>Cars.com Scraper</b></a><br>Scrape cars.com listings by make, ZIP and radius. 90+ fields per car: price, MSRP...</td></tr>
<tr><td>🚗 <a href="https://apify.com/abotapi/mobile-de-scraper"><b>mobile.de Scraper</b></a><br>Scrape mobile.de vehicle listings with 30+ fields including price, mileage, registration...</td><td>🚗 <a href="https://apify.com/abotapi/autotrader-com-scraper"><b>Autotrader US</b></a><br>Scrape US car listings from Autotrader by make, model, ZIP, price, year, body style...</td></tr>
</table>

👉 [Browse all abotapi scrapers](https://apify.com/abotapi)

### 💬 Support

- 🐞 **Found a bug or a missing field?** Open a ticket on the [Issues tab](https://apify.com/abotapi/avito-auto-listings-scraper/issues/open). We usually reply within hours.
- 🛠️ **Need another site, extra fields or a private build?** Email <contact@abotapi.com>.
- ⭐ **Enjoying it?** A quick review on the actor page helps other users find it.

# Actor input Schema

## `mode` (type: `string`):

search builds tokenized car searches from your filters. url scrapes exactly the avito search/category links you paste (tokenized links from the site work as-is).

## `regions` (type: `array`):

City names (Москва / Moscow) or avito slugs (moskva). Every search is city-scoped on avito.

## `dealType` (type: `string`):

s_probegom = used cars, novyy = new cars. Motorcycles, trucks, parts and other transport categories work in url mode - paste a link from the site.

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

Car make slug (the site's own facet; 186 makes available - BMW, Toyota, Lada/Vaz_lada, Kia, ...). Use the site's slug form (e.g. vaz_lada, land_rover, mercedes).

## `minPrice` (type: `integer`):

Minimum listing price in rubles.

## `maxPrice` (type: `integer`):

Maximum listing price in rubles.

## `query` (type: `string`):

Free-text search keyword (e.g. a model name).

## `sortBy` (type: `string`):

default = relevance, date_desc = newest, price_asc / price_desc.

## `ownerOnly` (type: `boolean`):

Exclude dealers (the site's own owner filter).

## `urls` (type: `array`):

Paste Avito transport search or category links copied from the site, including their filter tokens. Use the example links as a guide.

## `maxListings` (type: `integer`):

Maximum number of listings per run (a hard global cap across all searches). 0 means the per-result billing cap applies.

## `maxPages` (type: `integer`):

Maximum pages walked per search. 0 means no page cap, so Max items is the only cap that stops a run early.

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

Read each listing's page for the seller type (private vs dealer), the full vehicle attribute table (engine, gearbox, drive, owners, VIN signals), coordinates and price history.

## `proxy` (type: `object`):

Residential proxies are required - the site refuses datacenter IPs for the listing routes. The exit country rotates per session for maximum reliability.

## `resumeFromRunId` (type: `string`):

Run or dataset ID whose collected listings should be skipped (for continuing after an interrupted run).

## `incrementalMode` (type: `boolean`):

Track state between runs and classify every listing as NEW, UPDATED, UNCHANGED or EXPIRED instead of always NEW. Rows already known and unchanged are suppressed.

## `stateKey` (type: `string`):

Named baseline for incremental runs. Leave empty to derive the key from the run scope.

## `emitUnchanged` (type: `boolean`):

In incremental mode, also push rows that did not change (changeType UNCHANGED).

## `emitExpired` (type: `boolean`):

In incremental mode, emit EXPIRED tombstone rows for listings that disappeared from the walked scope.

## `ignoreFieldsForChanges` (type: `array`):

Extra field names that must never mark a row UPDATED (photo URL churn and view counters are already excluded by default).

## `mcpConnectors` (type: `array`):

Apify MCP connector IDs that receive pushed records while the run executes.

## `notionParentPageUrl` (type: `string`):

Notion parent page for the Notion MCP connector.

## `maxNotifyListings` (type: `integer`):

Cap on records sent to MCP connectors per run.

## Actor input object example

```json
{
  "mode": "search",
  "regions": [
    "Moscow"
  ],
  "dealType": "s_probegom",
  "make": "",
  "query": "",
  "sortBy": "default",
  "ownerOnly": false,
  "urls": [
    {
      "url": "https://www.avito.ru/moskva/avtomobili/s_probegom-ASgBAgICAUSGFMjmAQ"
    },
    {
      "url": "https://www.avito.ru/moskva/avtomobili/bmw-ASgBAgICAUTgtg3klyg"
    },
    {
      "url": "https://www.avito.ru/moskva/avtomobili/bmw-ASgBAgICAUTgtg3klyg?p=2"
    }
  ],
  "maxListings": 20,
  "maxPages": 0,
  "fetchDetails": true,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  },
  "resumeFromRunId": "",
  "incrementalMode": false,
  "stateKey": "",
  "emitUnchanged": false,
  "emitExpired": false,
  "ignoreFieldsForChanges": [],
  "mcpConnectors": [],
  "notionParentPageUrl": "",
  "maxNotifyListings": 50
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `detail` (type: `string`):

No description

## `changes` (type: `string`):

No description

# 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 = {
    "regions": [
        "Moscow"
    ],
    "urls": [
        {
            "url": "https://www.avito.ru/moskva/avtomobili/s_probegom-ASgBAgICAUSGFMjmAQ"
        },
        {
            "url": "https://www.avito.ru/moskva/avtomobili/bmw-ASgBAgICAUTgtg3klyg"
        },
        {
            "url": "https://www.avito.ru/moskva/avtomobili/bmw-ASgBAgICAUTgtg3klyg?p=2"
        }
    ],
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/avito-auto-listings-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 = {
    "regions": ["Moscow"],
    "urls": [
        { "url": "https://www.avito.ru/moskva/avtomobili/s_probegom-ASgBAgICAUSGFMjmAQ" },
        { "url": "https://www.avito.ru/moskva/avtomobili/bmw-ASgBAgICAUTgtg3klyg" },
        { "url": "https://www.avito.ru/moskva/avtomobili/bmw-ASgBAgICAUTgtg3klyg?p=2" },
    ],
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/avito-auto-listings-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 '{
  "regions": [
    "Moscow"
  ],
  "urls": [
    {
      "url": "https://www.avito.ru/moskva/avtomobili/s_probegom-ASgBAgICAUSGFMjmAQ"
    },
    {
      "url": "https://www.avito.ru/moskva/avtomobili/bmw-ASgBAgICAUTgtg3klyg"
    },
    {
      "url": "https://www.avito.ru/moskva/avtomobili/bmw-ASgBAgICAUTgtg3klyg?p=2"
    }
  ],
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call abotapi/avito-auto-listings-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,abotapi/avito-auto-listings-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/7xwSBV3gqy5Ia1rFt/builds/y6EPR7YvgKDV3QIFb/openapi.json