# \[Free] - Auto.ru Car Listings Scraper - Russia New & Used Cars (`confidential_gnat/autoru-cars-scraper`) Actor

\[Free] - Scrape new and used car listings from Auto.ru (auto.ru): price in RUB, USD and EUR, mark, model, year, mileage, engine, transmission, drive, owners, seller, city, coordinates and photos. Search by URL or filters, with caching of already scraped listings.

- **URL**: https://apify.com/confidential_gnat/autoru-cars-scraper.md
- **Developed by:** [ActorFlow](https://apify.com/confidential_gnat) (community)
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-usage

## 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

## Auto.ru Car Listings Scraper - Russia New & Used Cars

![Auto.ru Car Listings Scraper - Russia New & Used Cars cover](https://i.postimg.cc/SsZVD81W/Gemini-Generated-Image-3573vv3573vv3573.jpg)

**Scrape car listings from Auto.ru (auto.ru)**, Russia's largest car marketplace, and export them as JSON, CSV or Excel, or call the scraper as an **API**. Collect new and used **car listings** with price in rubles, dollars and euros, mark, model, year, mileage, engine, transmission, drive, owners, seller, city, coordinates and photos. Paste a search URL or pick a make, press Start and get clean, structured rows.

**Target website:** [auto.ru](https://auto.ru)

### ✨ Features of this Auto.ru car listings scraper

- **Car listing extraction** — new and used cars from any Auto.ru search, with price, specifications, owners, seller, location and photos.
- **Pagination support** — walks through the result pages of a search up to your item limit.
- **Large search splitting** — the site shows at most 3,663 results per search, so bigger searches are split automatically (by make, then model, then price ranges) to get past that cap.
- **Proxy support** — runs through Russian residential proxies, which the site requires.
- **Search filters** — region, condition (new or used), make, model, price range, production year and sort order.
- **Cache project** — scrape only new listings and price changes on every scheduled run.
- **Listing details** — optionally open each listing for the full description, option list and price history.

### 🚀 How to scrape Auto.ru car listings in 5 steps

1. [Sign up](https://apify.com/sign-up) for a free Apify account — includes **$5 monthly credit**.
2. Open the actor page and click **Try for free**.
3. Fill in the **Input** fields (a search URL, or the search filters, is required).
4. Click **Start** and wait for the run to complete.
5. Download results from the **Output** tab in JSON, CSV, or Excel format.

You can also run this actor via the [Apify API](https://docs.apify.com/api/v2) or integrate it directly into your workflows using [Zapier](https://zapier.com/apps/apify), [Make](https://www.make.com/), or [n8n](https://n8n.io/).

### 💰 Pricing for the Auto.ru scraper

This actor uses **pay-per-result** billing based on the compute units a run consumes.

- New Apify accounts include **$5 of free monthly credit**.
- The site only lets a real browser through, so runs use more compute and proxy traffic than a plain HTTP scraper. Leaving **Scrape listing pages** off keeps runs fastest and cheapest.

### 🔧 Auto.ru scraper input configuration

| Field | Type | Required | Default | Description |
| ----- | ---- | -------- | ------- | ----------- |
| Search or listing URLs (`startUrls`) | array | — | https://auto.ru/rossiya/cars/used/ | Auto.ru car search pages or single listing pages. Filters in the URL are kept. Leave empty to use the search filters below. |
| Max items per search (`maxItems`) | integer | — | 5 | Maximum listings saved for each search. Above 3,663 the search is split automatically by make, model and price. |
| Scrape listing pages (`scrapeDetails`) | boolean | — | false | Open each listing page for the full description, option list and price history. |
| Cache project name (`cacheProjectName`) | string | — | — | Reuse the same name on each run to get only new listings and price changes. Unchanged listings are skipped and not charged. |
| Region (`region`) | string | — | all of Russia | Region slug as in auto.ru URLs, for example `moskva` or `sankt-peterburg`. Used when no start URL is given. |
| Condition (`section`) | string | — | all | `all`, `new` or `used`. |
| Make (`mark`) | string | — | — | Make slug as in auto.ru URLs, for example `toyota`, `bmw` or `kia`. |
| Model (`model`) | string | — | — | Model slug, used together with the make, for example `camry` or `rio`. |
| Minimum price (`priceFrom`) | integer | — | — | Only listings priced at or above this amount in rubles. |
| Maximum price (`priceTo`) | integer | — | — | Only listings priced at or below this amount in rubles. |
| Year from (`yearFrom`) | integer | — | — | Earliest production year. |
| Year to (`yearTo`) | integer | — | — | Latest production year. |
| Sort by (`sortBy`) | string | — | relevance | `relevance`, `newest`, `price_asc` or `price_desc`. |
| Proxy configuration (`proxyConfiguration`) | object | — | Apify residential, RU | Russian residential proxies are needed. |

**Supported URL types:**

- All used cars in Russia: `https://auto.ru/rossiya/cars/used/`
- New cars of one make in a region: `https://auto.ru/moskva/cars/kia/new/`
- One model: `https://auto.ru/rossiya/cars/toyota/camry/used/`
- Filters in the URL are kept, for example `?price_from=1000000&price_to=2000000&year_from=2020`
- Single listing: `https://auto.ru/cars/used/sale/mercedes/c_klasse/1133771147-85c9975f/`

### 📦 Auto.ru scraper output data

The actor saves one JSON record per car listing with the fields `id`, `url`, `title`, `section`, `mark`, `markName`, `model`, `modelName`, `generation`, `trim`, `year`, `price`, `currency`, `priceUsd`, `priceEur`, `mileage`, `condition`, `bodyType`, `doors`, `engineType`, `displacement`, `power`, `transmission`, `driveType`, `steeringWheel`, `color`, `ownersCount`, `pts`, `vin`, `customsCleared`, `sellerType`, `sellerName`, `salonName`, `city`, `address`, `latitude`, `longitude`, `availability`, `exchange`, `daysOnSale`, `createdAt`, `updatedAt`, `tags`, `imagesCount`, `images`, `changeType`, `previousPrice`, `searchUrl`, `scrapedAt`. With **Scrape listing pages** on, each record also has `description`, `options` (the option codes) and `priceHistory`. The dataset has 1 view.

- **Overview** — a compact table of the listings with ID, title, year, price, mileage, engine, transmission, city, seller and link.

**Output at a glance:**

| Car | Year | Price (RUB) | Mileage (km) | Engine | Transmission | City | Seller |
| --- | --- | --- | --- | --- | --- | --- | --- |
| [Mercedes-Benz GLS 450 II (X167) Рестайлинг](https://auto.ru/cars/used/sale/mercedes/gls_klasse/1133935255-7825107b/) | 2024 | 13 500 000 | 27 000 | Petrol | Automatic | Москва | Private |
| [Volkswagen Tiguan L Pro III (China Market)](https://auto.ru/cars/used/sale/volkswagen/tiguan/1134015871-429f0763/) | 2026 | 4 560 000 | 10 | Petrol | Robot | Москва | Private |
| [Kia Rio IV Рестайлинг](https://auto.ru/cars/used/sale/kia/rio/1132526669-b02bbfb8/) | 2021 | 1 735 000 | 61 200 | Petrol | Automatic | Таганрог | Commercial |
| [Xiaomi SU7 I](https://auto.ru/cars/used/sale/xiaomi/su7/1134198242-72e139d6/) | 2024 | 6 690 000 | 18 000 | Electric | Automatic | Москва | Commercial |
| [Xiaomi SU7 I](https://auto.ru/cars/used/sale/xiaomi/su7/1133573099-9583d793/) | 2024 | 6 650 000 | 15 000 | Electric | Automatic | Химки | Private |

**Sample output (raw JSON):**

```json
[
  {
    "id": "1133935255-7825107b",
    "url": "https://auto.ru/cars/used/sale/mercedes/gls_klasse/1133935255-7825107b/",
    "title": "Mercedes-Benz GLS 450 II (X167) Рестайлинг",
    "section": "used",
    "mark": "MERCEDES",
    "markName": "Mercedes-Benz",
    "model": "GLS_KLASSE",
    "modelName": "GLS",
    "generation": "II (X167) Рестайлинг",
    "trim": "GLS 450 4MATIC",
    "year": 2024,
    "price": 13500000,
    "currency": "RUR",
    "priceUsd": 162871,
    "priceEur": 145096,
    "mileage": 27000,
    "condition": "CONDITION_OK",
    "bodyType": "Внедорожник 5 дв.",
    "doors": 5,
    "engineType": "GASOLINE",
    "displacement": 2999,
    "power": 381,
    "transmission": "AUTOMATIC",
    "driveType": "ALL_WHEEL_DRIVE",
    "steeringWheel": "LEFT",
    "color": "040001",
    "ownersCount": 2,
    "pts": "ORIGINAL",
    "vin": "4JG**************",
    "customsCleared": true,
    "sellerType": "PRIVATE",
    "sellerName": "Олег",
    "salonName": null,
    "city": "Москва",
    "address": null,
    "latitude": 55.755863,
    "longitude": 37.6177,
    "availability": "IN_STOCK",
    "exchange": true,
    "daysOnSale": 54,
    "createdAt": "2026-10-16T09:01:15.306Z",
    "updatedAt": "2026-10-18T08:50:55.818Z",
    "tags": [
      "allowed_for_credit",
      "pts_original"
    ],
    "imagesCount": 25,
    "images": [
      "https://avatars.avto.ru/get-autoru-vos/11635645/af55e4545b2be58887f1c62b710e406b/1200x900",
      "https://avatars.avto.ru/get-autoru-vos/19811519/402f3340c81eb4bac9af17b9aeefaee7/1200x900"
    ],
    "changeType": null,
    "previousPrice": null,
    "searchUrl": "https://auto.ru/rossiya/cars/used/",
    "scrapedAt": "2026-10-20T18:51:40.187Z"
  },
  {
    "id": "1134015871-429f0763",
    "url": "https://auto.ru/cars/used/sale/volkswagen/tiguan/1134015871-429f0763/",
    "title": "Volkswagen Tiguan L Pro III (China Market)",
    "section": "used",
    "mark": "VOLKSWAGEN",
    "markName": "Volkswagen",
    "model": "TIGUAN",
    "modelName": "Tiguan",
    "generation": "III (China Market)",
    "trim": "R-Line Smart Leadership",
    "year": 2026,
    "price": 4560000,
    "currency": "RUR",
    "priceUsd": 55014,
    "priceEur": 49010,
    "mileage": 10,
    "condition": "CONDITION_OK",
    "bodyType": "Внедорожник 5 дв. L Pro",
    "doors": 5,
    "engineType": "GASOLINE",
    "displacement": 1984,
    "power": 220,
    "transmission": "ROBOT",
    "driveType": "ALL_WHEEL_DRIVE",
    "steeringWheel": "LEFT",
    "color": "FAFBFB",
    "ownersCount": 1,
    "pts": "ORIGINAL",
    "vin": null,
    "customsCleared": true,
    "sellerType": "PRIVATE",
    "sellerName": "MatesCars",
    "salonName": null,
    "city": "Москва",
    "address": "Ленинский проспект, 105к2",
    "latitude": 55.663517,
    "longitude": 37.516476,
    "availability": "ON_ORDER",
    "exchange": true,
    "daysOnSale": 47,
    "createdAt": "2026-10-18T14:59:09.201Z",
    "updatedAt": "2026-09-04T09:29:53.000Z",
    "tags": [
      "pts_original",
      "verified_reseller"
    ],
    "imagesCount": 16,
    "images": [
      "https://avatars.avto.ru/get-autoru-vos/20360782/4280dc5d8ab33596b706046190b4122c/1200x900",
      "https://avatars.avto.ru/get-autoru-vos/5451090/afd0f29e64a5333550edb43ff9e9ad78/1200x900"
    ],
    "changeType": null,
    "previousPrice": null,
    "searchUrl": "https://auto.ru/rossiya/cars/used/",
    "scrapedAt": "2026-10-20T18:51:40.188Z"
  }
]
```

### 🔁 Scrape only new Auto.ru listings with the cache

Set the same **Cache project name** on every scheduled run. Listings already saved under that name are skipped, not charged and not counted towards **Max items**, so each run returns only what is new. Each record gets `changeType: "new"`, or `changeType: "price_change"` with the `previousPrice` when a listing you already have changed its price. Different cache names keep separate caches. Tip: create an Apify Schedule that runs the actor daily with the same cache name and **Sort by** set to newest to build a feed of fresh listings.

### 🐍 How to scrape Auto.ru with Python, JavaScript or the API

Run the actor programmatically with the official Apify clients. Replace `<YOUR_API_TOKEN>` with the token from your [Apify Console](https://console.apify.com/account/integrations).

**Python** (`pip install apify-client`):

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")

run = client.actor("confidential_gnat/autoru-cars-scraper").call(run_input={
    "startUrls": [{"url": "https://auto.ru/rossiya/cars/used/"}],
    "maxItems": 20,
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

**JavaScript** (`npm install apify-client`):

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_API_TOKEN>' });

const run = await client.actor('confidential_gnat/autoru-cars-scraper').call({
    startUrls: [{ url: 'https://auto.ru/rossiya/cars/used/' }],
    maxItems: 20,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

**cURL** — start a run and wait for the dataset:

```bash
curl -X POST "https://api.apify.com/v2/acts/confidential_gnat~autoru-cars-scraper/run-sync-get-dataset-items?token=<YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"startUrls": [{"url": "https://auto.ru/rossiya/cars/used/"}], "maxItems": 20}'
```

### 💡 What you can use Auto.ru car data for

- Used and new car price monitoring across regions and makes
- Market analysis of asking prices by model, year and mileage
- Lead lists for dealers and resellers tracking fresh listings
- Finding undervalued cars by comparing price, mileage and condition
- Building datasets for price prediction and depreciation research

Car dealers, resellers, automotive analysts, insurers and researchers typically use this data to follow the Russian car market.

### ⚠️ Limitations of the Auto.ru scraper

- **Proxy required** — the site shows a bot check to most IPs outside Russia, so Russian residential proxies are needed; some requests are retried several times before a page loads.
- **Result cap per search** — the site shows at most 3,663 results (99 pages of 37) for one search; the actor works around this by splitting large searches when **Max items** is above that.
- **Hidden seller contacts** — phone numbers are not shown to visitors who are not logged in, so they are not in the results.
- **Photos** — listing cards carry part of the photo set; the full set is on the listing page.

### ❓ Auto.ru scraper FAQ

#### Can I scrape Auto.ru legally?

The actor only collects data that is already publicly visible on auto.ru — it never logs in or opens private content. Scraping publicly available data is generally considered lawful (see *hiQ Labs v. LinkedIn*), but you remain responsible for complying with the site's Terms of Service and applicable laws such as GDPR, especially for the seller names and locations in the results.

#### What data does the Auto.ru scraper return?

Each record has the listing ID and link, title, make, model, generation, year, price in rubles, dollars and euros, mileage, body type, engine, power, transmission, drive, owners, seller type and name, city, coordinates and photos. Turning on **Scrape listing pages** adds the full description, option list and price history.

#### How many car listings can I scrape from one search?

**Max items** applies to each start URL or filter search separately. The site itself shows at most 3,663 results per search, so when you ask for more the actor splits the search by make, then model, then price range and removes duplicates.

#### Do I need a proxy to scrape auto.ru?

Yes. The input defaults to Russian residential proxies, because the site shows a bot check to most other IPs. Leave the default unless you have your own Russian proxies.

#### How do I scrape Auto.ru with Python?

Use the Python example above: install `apify-client`, start the actor with a search URL and iterate over the dataset items.

#### Can I run this Auto.ru scraper on a schedule?

Yes. Create an Apify Schedule for the actor. Set the same **Cache project name** on every run to skip listings you already have and receive only new listings and price changes.

#### What output formats are supported?

JSON, CSV, Excel, XML and RSS, either from the **Output** tab or through the Apify API.

#### Why do some listings have no VIN or phone number?

The site masks the VIN and hides seller phone numbers from visitors who are not logged in, so the VIN is partly hidden and phone numbers are not in the results.

### 🔗 Relevant actors for Auto.ru car data

| Scraper | Description |
| ------- | ----------- |
| [🏁 Cheapest Carsandbids Scraper](https://apify.com/confidential_gnat/cheapest-carsandbids-scraper) | Scrapes auction listings, sale prices, vehicle specs and photos from Cars & Bids. |
| [🚗 Copart Search Scraper — Salvage & Used Auction](https://apify.com/confidential_gnat/copart-search-scraper) | Scrapes vehicle auction lots from Copart: damage, odometer, current bid and photos. |
| [📋 Craigslist Listings Scraper - Housing, For Sale, Jobs, Cars](https://apify.com/confidential_gnat/craigslist-listings-scraper) | Scrapes Craigslist classified listings in any city and category, cars included. |
| [🛒 Mudah.my Classifieds Scraper - Cars, Property & Marketplace](https://apify.com/confidential_gnat/mudah-classifieds-scraper) | Scrapes Mudah.my classified ads: cars, property, phones and more, with seller details. |

### 🔗 Other actors you may find useful

| Scraper | Description |
| ------- | ----------- |
| [✈️ Kiwi.com Flight Scraper](https://apify.com/confidential_gnat/kiwi-flight-scraper) | Scrapes flight prices, schedules, layovers and booking links from Kiwi.com. |
| [🍷 Vivino Wine Scraper](https://apify.com/confidential_gnat/vivino-wine-scraper) | Scrapes wine names, vintages, ratings, prices and taste profiles from Vivino. |
| [💼 Dice Jobs Scraper - Search Tech Jobs by Keyword or URL](https://apify.com/confidential_gnat/dice-jobs-scraper) | Scrapes tech job listings from Dice with salary, skills and full descriptions. |
| [📈 Kalshi Markets Scraper - Prediction Market Prices & Odds](https://apify.com/confidential_gnat/kalshi-markets-scraper) | Scrapes Kalshi prediction markets: prices, implied probability and volume. |
| [🛍️ Mercari Japan Scraper - Listings, Prices & Sold Items](https://apify.com/confidential_gnat/mercari-japan-listings-scraper) | Scrapes Mercari Japan listings with prices, condition, photos and seller rating. |

### 🇷🇺 Парсер Авто.ру (Auto.ru) на русском языке: как собрать объявления об автомобилях

**Auto.ru Car Listings Scraper** — это парсер объявлений с **Авто.ру (auto.ru)**, крупнейшей автомобильной площадки России. Он собирает **новые и подержанные автомобили**: цену в рублях, долларах и евро, марку, модель, год выпуска, пробег, двигатель, коробку передач, привод, число владельцев, продавца, город, координаты и фотографии. Вставьте ссылку на поиск Авто.ру или задайте фильтры, нажмите **Start** и получите готовую таблицу. Результат можно скачать в JSON, CSV или Excel и получать через **API** Apify.

#### Как запустить парсер Авто.ру

1. Зарегистрируйтесь в [Apify](https://apify.com/sign-up) — новым аккаунтам доступно **5 $ бесплатного кредита в месяц**.
2. Откройте страницу актора и нажмите **Try for free**.
3. Укажите ссылку в поле **Search or listing URLs** (страница поиска или отдельное объявление) либо заполните фильтры: регион, состояние, марку, модель, цену, год и сортировку.
4. Нажмите **Start** и дождитесь завершения запуска.
5. Скачайте результат на вкладке **Output** в формате JSON, CSV или Excel.

#### Поля ввода

| Поле | Описание |
| ---- | -------- |
| Search or listing URLs (`startUrls`) | Ссылки на страницы поиска или на отдельные объявления Авто.ру. Фильтры из ссылки сохраняются. Если поле пустое, используются фильтры ниже. |
| Max items per search (`maxItems`) | Сколько объявлений сохранить для каждого поиска. По умолчанию 5. Если больше 3 663, поиск автоматически делится на части по марке, модели и цене. |
| Scrape listing pages (`scrapeDetails`) | Открывать каждое объявление для полного описания, списка опций и истории цены. Работает медленнее. |
| Cache project name (`cacheProjectName`) | Название кэша. Используйте одно и то же название при каждом запуске по расписанию, чтобы получать только новые объявления и изменения цены. |
| Region (`region`) | Регион так, как он записан в адресе auto.ru, например `moskva` или `sankt-peterburg`. Пусто — вся Россия. |
| Condition (`section`) | Состояние: `all` (все), `new` (новые) или `used` (с пробегом). |
| Make / Model (`mark`, `model`) | Марка и модель в формате адреса auto.ru, например `toyota` и `camry`. Модель задаётся вместе с маркой. |
| Minimum price / Maximum price (`priceFrom`, `priceTo`) | Нижняя и верхняя граница цены в рублях. |
| Year from / Year to (`yearFrom`, `yearTo`) | Диапазон годов выпуска. |
| Sort by (`sortBy`) | Сортировка: `relevance`, `newest`, `price_asc` или `price_desc`. |
| Proxy configuration (`proxyConfiguration`) | Настройки прокси. Нужны российские резидентные прокси, они выбраны по умолчанию. |

#### Только новые объявления: кэш

Укажите одно и то же **Cache project name** при каждом запуске. Объявления, которые уже сохранялись под этим названием, пропускаются: они не оплачиваются и не учитываются в **Max items**. Новые объявления получают `changeType: "new"`, а объявления с изменившейся ценой — `changeType: "price_change"` и поле `previousPrice` со старой ценой. Для ежедневной выгрузки новинок создайте расписание (Apify Schedules) с одним и тем же названием кэша и сортировкой `newest`.

#### Ограничения и частые вопросы

- **Лимит выдачи.** Авто.ру показывает не более 3 663 результатов на один поиск (99 страниц по 37). Если вы просите больше, парсер сам делит поиск по маркам, затем по моделям и диапазонам цен и убирает дубликаты.
- **Прокси.** Сайт показывает проверку на робота большинству адресов за пределами России, поэтому нужны российские резидентные прокси. Часть запросов повторяется несколько раз, пока страница не загрузится.
- **Скрытые контакты.** Телефоны продавцов не видны без входа в аккаунт, поэтому их нет в результатах. VIN также скрыт.
- **Фотографии.** В карточке поиска часть фотографий, полный набор доступен при включённом **Scrape listing pages**.
- **Законность.** Парсер собирает только общедоступные данные без входа в аккаунт. Ответственность за соблюдение правил сайта и применимого законодательства о персональных данных несёт пользователь.
- **Расписание и API.** Запускайте актор по расписанию или из кода через Python, JavaScript и cURL — примеры есть в разделе выше.

### 💬 Support & contact

If you encounter any issues or have questions, please [open an issue](https://apify.com/confidential_gnat/autoru-cars-scraper/issues/open) or reach out via the [Apify Community Forum](https://community.apify.com/).

You can also find more of our actors on the [Actor Flow](https://apify.com/confidential_gnat) page.

# Actor input Schema

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

Auto.ru car search pages or single listing pages, for example https://auto.ru/rossiya/cars/used/toyota/camry/ or https://auto.ru/cars/used/sale/mercedes/c_klasse/1133771147-85c9975f/. Filters already in the URL are kept. Leave empty to search with the filters below.

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

Maximum listings saved for each search. The site shows at most 3,663 results per search; above that the search is split automatically by mark and price.

## `scrapeDetails` (type: `boolean`):

Open every listing page for the full description, option list and price history. Slower and uses more proxy traffic.

## `cacheProjectName` (type: `string`):

Use the same name on each scheduled run to get only new listings and price changes. Listings already seen with the same price are skipped and not charged. Each record gets a changeType: new or price_change.

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

Region slug as it appears in auto.ru URLs, for example moskva, sankt-peterburg or tatarstan. Empty means all of Russia.

## `section` (type: `string`):

New cars, used cars or both.

## `mark` (type: `string`):

Make slug as in auto.ru URLs, for example toyota, bmw, kia or vaz.

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

Model slug, used together with the make, for example camry or rio.

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

Only listings priced at or above this amount in rubles.

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

Only listings priced at or below this amount in rubles.

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

Earliest production year.

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

Latest production year.

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

Order of the results.

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

The site shows a bot check to most IPs outside Russia, so Russian residential proxies are needed.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://auto.ru/rossiya/cars/used/"
    }
  ],
  "maxItems": 5,
  "scrapeDetails": true,
  "section": "all",
  "sortBy": "relevance",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "RU"
  }
}
```

# Actor output Schema

## `overview` (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 = {
    "startUrls": [
        {
            "url": "https://auto.ru/rossiya/cars/used/"
        }
    ],
    "maxItems": 5,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "RU"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("confidential_gnat/autoru-cars-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": [{ "url": "https://auto.ru/rossiya/cars/used/" }],
    "maxItems": 5,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "RU",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("confidential_gnat/autoru-cars-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": [
    {
      "url": "https://auto.ru/rossiya/cars/used/"
    }
  ],
  "maxItems": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "RU"
  }
}' |
apify call confidential_gnat/autoru-cars-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,confidential_gnat/autoru-cars-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/upl24eepHQ3Edefx4/builds/xhf0JJQckde6syh3j/openapi.json