# Autovit Scraper (`ribtools/autovit-scraper`) Actor

Scrape Autovit.ro car, motorcycle and van listings: type vehicles (Dacia Duster) with filters for county, city, year, price and mileage, or paste any search, ad or dealer URL. Add-ons: ad details, dealer phones. Proxies included.

- **URL**: https://apify.com/ribtools/autovit-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

## Autovit Scraper

Extract car, motorcycle and van listings from **Autovit**, Romania's largest vehicle marketplace — specs, price (gross or net, in EUR or RON), Autovit's own market-price rating, price drops, location and dealer — plus optional ad details and dealer phone numbers.

### What is Autovit Scraper?

**Autovit Scraper** is a powerful data extraction tool that automatically collects vehicle listings from [Autovit.ro](https://www.autovit.ro/), Romania's largest marketplace for new and used cars, motorcycles and vans. Simply type the vehicles you want (such as `Dacia Duster`) or provide Autovit URLs, and get structured data including make, model, generation, version, year, mileage, fuel, power, price (with or without VAT), the site's below/in/above-market price rating, price drops, county, city and seller — with optional add-ons for the full ad description, every photo and map coordinates, and the dealer's contact profile with phone numbers.

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, generation, version, year, mileage, fuel, transmission, power, engine size, body type, color, doors, seats, drivetrain, country of origin, equipment and every listing attribute
- **Market-price insight** — Autovit's own price rating (BELOW / IN / ABOVE market), price drops and the previous price
- **Three categories** — cars (`autoturisme`), motorcycles (`motociclete`) and vans (`autoutilitare`)
- **Search by typing vehicles** — a make, a model or both (`Dacia Duster`, `dacia`, `Skoda Octavia`), matched against Autovit's own catalog, with filters for vehicle type, condition, county, city, year, seller type, price and mileage
- **Handle multiple entry points** — category searches with any filters, single ad URLs (in every form the site uses) and dealer pages
- **Automatic pagination** — crawls through all search result pages (32 vehicles per page), in the same order as the site
- **Ad details add-on** — full description, all photos, original publication and update dates, map coordinates, negotiable flag
- **Seller data add-on** — dealer phone numbers, address, postal code, coordinates, website, number of active ads and member-since year
- **No duplicates** — each vehicle is returned (and charged) once per run, even when listings move between pages
- **Romanian proxies included** — high-quality 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 Autovit Scraper extract?

| Field | Description | Example |
| ----- | ----------- | ------- |
| **ID** | Autovit ad identifier | 7049446512 |
| **Title** | Ad title | Audi e-tron Sportback 55 quattro S line |
| **Category** | Cars, motorcycles or vans | autoturisme, motociclete, autoutilitare |
| **Make / Model / Generation / Version** | Vehicle identity | Suzuki, Vitara, IV \[2014 - Prezent], 1.4 Boosterjet MHEV Luxus |
| **Price** | Gross price, currency, listed-gross flag, net price | 41128, EUR, false, 33990 |
| **Price Evaluation** | Autovit's market rating (cars) | BELOW, IN, ABOVE |
| **Price Drop** | Drop percentage and previous price | 1.45, 41733 |
| **Year** | Production year | 2021 |
| **Mileage** | Kilometers driven | 8500 |
| **Fuel / Transmission / Power** | Powertrain | Electric, Automata, 408 |
| **Body Type / Color / Doors / Seats** | Body | SUV, Gri, 5, 5 |
| **Drivetrain / Condition / Origin** | Drive, new or used, country of origin | 4x4 (automat), used, Germania |
| **Features** | Equipment set to yes | esp, keyless_go, apple_carplay, rear_view_camera |
| **Attributes** | Every listing parameter | no_accident: Da, vat: Da, engine_power: 408 CP |
| **Location** | City and county | Galati, Galati |
| **Seller** | Type, dealer trading name and Autovit page | dealer, LEASING AUTOMOBILE |
| **Details** (add-on) | Description, photos, dates, coordinates | See below |
| **Seller profile** (add-on) | Dealer phones, address, website, active ads | See below |

### How to scrape Autovit

#### Step-by-step tutorial:

1. **Type vehicles** — Add one make, model or both per line in *Search vehicles*, as you would in Autovit's search box
2. **Or paste URLs** — Add Autovit search, ad or dealer URLs in *Autovit URLs* (see below). You can use both; each vehicle and each URL is its own search
3. **Set filters** (optional) — Vehicle type, condition, county, 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

Romanian proxies are included automatically — no setup required.

#### Search by vehicle

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

- `Dacia Duster` — the model Duster (Dacia)
- `dacia` — every model of the make Dacia
- `Skoda Octavia` — the model Octavia (Skoda)
- `mercedes` — every model of the make Mercedes-Benz

Typed vehicles search cars by default; set *Vehicle type* to Motorcycles or Vans for the other two. For vans only the make is matched, so type the make (`mercedes`, `renault`). *County* narrows the search to one of the 42 counties, and *City* searches the city and 50 km around it; type the city as Autovit names it (`Cluj-Napoca`, not `Cluj`). A city Autovit does not know is skipped and named in the status message. A vehicle Autovit does not know is skipped the same way, never returning unrelated results. *Max results per search* caps each vehicle separately.

#### Compatible URL examples:

- **Cars search**: `https://www.autovit.ro/autoturisme`
- **Filtered search (make, model, price, sort)**: `https://www.autovit.ro/autoturisme/bmw/seria-3?search[filter_float_price:to]=20000&search[order]=filter_float_price:asc`
- **Filtered search (county)**: `https://www.autovit.ro/autoturisme/bmw/cluj-judet`
- **Filtered search (year from, body type)**: `https://www.autovit.ro/autoturisme/de-la-2018`, `https://www.autovit.ro/autoturisme/seg-suv`
- **Keyword search**: `https://www.autovit.ro/autoturisme/q-golf`
- **New or used only**: `https://www.autovit.ro/autoturisme/nou`, `https://www.autovit.ro/autoturisme/second`
- **Motorcycles search**: `https://www.autovit.ro/motociclete/yamaha`
- **Vans search**: `https://www.autovit.ro/autoutilitare/ford`
- **Single ad**: `https://www.autovit.ro/autoturisme/anunt/bmw-x3-ver-xdrive20d-at-m-sport-ID7HQTVC.html`
- **Single ad, short form**: `https://www.autovit.ro/anunt/bmw-x3-ver-xdrive20d-at-m-sport-ID7HQTVC.html`
- **Dealer page (whole inventory)**: `https://bdvbestauto.autovit.ro`

Mobile (`m.autovit.ro`) and bare-domain (`autovit.ro`) links work too.

**Important**: Only URLs matching these patterns will work. Other categories (`camioane` trucks, `remorci` trailers, `constructii` construction and `agro` agricultural machinery, parts) are not supported and are skipped.

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

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

#### Is scraping Autovit free?

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

- **Base extraction**: one charge per scraped vehicle (specs, price, market rating, location, seller)
- **Ad details add-on**: one additional charge per vehicle when the details add-on is enabled and the ad returns data
- **Seller data add-on**: one additional charge per vehicle, but only when at least one dealer phone number is returned — private sellers and dealers without a published phone are never charged for this add-on

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. `Dacia Duster`, `dacia`, `Skoda Octavia`. Each line is its own search. For vans only the make is matched
- **Autovit URLs** (`startUrls`) — Search, ad or dealer 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. Pages of 32 vehicles are fetched until the cap is reached or the site's results end
- **Vehicle type** (`vehicleType`) — Cars, motorcycles, or vans
- **Condition** (`condition`) — Used and new, used, or new
- **County** (`county`) and **City** (`city`) — One of the 42 Romanian counties, and a city (searched with 50 km around it). A city Autovit does not know, or one shared by several places when no county is picked, is skipped and named in the status message
- **Year from / to** (`yearFrom`, `yearTo`) — Production year range
- **Seller type** (`sellerType`) — Dealers (firme) and private sellers, dealers only, or private sellers only
- **Price from / to** (`priceFrom`, `priceTo`) — Asking price in euros; "to" is 1 or more
- **Mileage from / to** (`kmFrom`, `kmTo`) — Kilometers driven; "to" is 1 km or more (for 0 km vehicles, set Condition to New)
- **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 Romanian proxies are built into the Actor at no additional cost — no proxy configuration is required.

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

Open each ad to add the full description, every photo, publication and update dates, map coordinates and whether the price is negotiable. Phone numbers and emails typed into the description are hidden. Charged per vehicle with details.

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

Add the seller profile: dealer phone numbers, address, postal code, map coordinates, website, number of active ads and member-since year. Phone numbers and names are returned for dealers only; private sellers return the seller type and nothing personal. You are charged only when a phone number is returned.

### Output example

```json
{
  "type": "vehicle",
  "id": 7049446512,
  "url": "https://www.autovit.ro/autoturisme/anunt/audi-e-tron-sportback-ver-55-quattro-s-line-ID7H4L4c.html",
  "search": "Audi e-tron Sportback",
  "title": "Audi e-tron Sportback 55 quattro S line",
  "category": "autoturisme",
  "price": 41128,
  "currency": "EUR",
  "make": "Audi",
  "model": "e-tron Sportback",
  "price_is_gross": false,
  "net_price": 33990,
  "price_evaluation": "IN",
  "price_drop_pct": 1.45,
  "old_price": 41733,
  "version": "55 quattro S line",
  "generation": null,
  "year": 2021,
  "km": 8500,
  "fuel": "Electric",
  "transmission": "Automata",
  "engine_cc": null,
  "power_hp": 408,
  "body_type": "SUV",
  "color": "Gri",
  "doors": 5,
  "seats": 5,
  "drivetrain": "4x4 (automat)",
  "condition": "used",
  "origin": "Germania",
  "features": [
    "soundsystem",
    "quick_charging_function",
    "windscreenwiper_other",
    "electronic_controlled_suspension",
    "sport_suspension",
    "multi_functional_steering_wheel",
    "independent_vehicle_heater",
    "basic_autonomous_driving"
  ],
  "attributes": {
    "make": "Audi",
    "model": "e-tron Sportback",
    "version": "55 quattro S line",
    "year": "2021",
    "mileage": "8500 km",
    "fuel_type": "Electric",
    "engine_power": "408 CP",
    "gearbox": "Automata",
    "body_type": "SUV",
    "color": "Gri",
    "door_count": "5",
    "nr_seats": "5",
    "transmission": "4x4 (automat)",
    "new_used": "Utilizat",
    "country_origin": "Germania",
    "no_accident": "Da",
    "vat": "Da",
    "has_vin": "Da"
  },
  "city": "Galati",
  "region": "Galati",
  "seller_type": "dealer",
  "seller_id": "428035",
  "seller_name": "LEASING AUTOMOBILE",
  "seller_url": "https://leasingautomobile.autovit.ro",
  "is_promoted": true,
  "is_highlighted": false,
  "thumbnail": "https://ireland.apollo.olxcdn.com/v1/files/dmunfq12hzen3-AUTOVITRO/image;s=640x480",
  "listed_at": "2026-10-15T13:30:20Z",
  "bumped_at": "2026-10-15T13:50:27Z",
  "details": {
    "description": "Contact: Adi [phone hidden] / Denis [phone hidden], [email hidden].\nPret 22 970 EUR, an 2021, 133687 km.",
    "photos": [
      "https://ireland.apollo.olxcdn.com/v1/files/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmbiI6ImRtdW5mcTEyaHplbjMtQVVUT1ZJVFJPIiwidyI6W3siZm4iOiJxN216NTNiaWZwemstQVVUT1ZJVFJPIiwicyI6IjE2IiwiYSI6IjAiLCJwIjoiMTAsLTEwIn1dfQ.b7FdbCh6SwIXRCr8um0eEjC8Zqo2Oy6R9nSvVeLkGRY/image",
      "https://ireland.apollo.olxcdn.com/v1/files/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmbiI6IjZqZTdobWd1Mno3ZTEtQVVUT1ZJVFJPIiwidyI6W3siZm4iOiJxN216NTNiaWZwemstQVVUT1ZJVFJPIiwicyI6IjE2IiwiYSI6IjAiLCJwIjoiMTAsLTEwIn1dfQ.tQLotqa9fMZf_kHyXMNfqBl_wW4dXGux4SWYW2GncBY/image"
    ],
    "first_listed_at": "2022-10-06T07:36:31Z",
    "updated_at": "2026-10-13T13:50:01.288279Z",
    "latitude": 45.45574,
    "longitude": 28.032764,
    "subregion": "galati-galati",
    "is_negotiable": false
  },
  "seller": {
    "id": "428035",
    "uuid": "9d215f08-a58e-45cb-a593-ee74a1a4c492",
    "type": "dealer",
    "name": "LEASING AUTOMOBILE",
    "phones": [
      "0700000001",
      "0700000002"
    ],
    "website": "http://leasingautomobile.ro",
    "profile_url": "https://leasingautomobile.autovit.ro",
    "active_ads": 105,
    "address": null,
    "postal_code": "800522",
    "city": "Galati",
    "latitude": 45.45574366,
    "longitude": 28.03276489,
    "member_since": "2015"
  }
}
```

`features`, `attributes`, `description` and `photos` are shortened here; real items carry every equipment flag, every listing parameter, the full description and every photo (the phone numbers above are placeholders). Prices are whole units of `currency` (EUR on almost every ad, RON on some): `price` is always the gross figure (what the listing card shows), `price_is_gross` is `false` when the seller lists the vehicle at a net price (VAT invoice), and `net_price` then carries that net figure. `old_price` is the price before the drop, on the same gross basis as `price`. A single ad URL yields the same price fields as the search card for the same vehicle. For single ad URLs, the search-only fields (`price_evaluation`, `price_drop_pct`, `old_price`, `is_promoted`, `is_highlighted`, `listed_at`, `bumped_at`) are empty. The VIN, the licence plate and the first-registration date are never extracted. Phone numbers and email addresses that sellers type into the title or description — including numbers spelled out or spaced to get past the site's own masking — are replaced with `[phone hidden]` and `[email hidden]`, and VINs and personal registry ids (CNP; a company's CUI or trade-register number on a private seller's ad) with `[id hidden]`.

You can download the dataset extracted by **Autovit 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 market research** — track prices, mileage and supply by make, model, generation, year and county across Romania
- **Pricing and valuation** — benchmark against Autovit's own below/in/above-market rating and price drops
- **Dealer lead generation** — build lists of dealers with phone numbers, addresses and inventory size
- **Inventory monitoring** — follow a dealer's whole stock or a filtered search on a schedule
- **Import and fleet sourcing** — compare net prices from VAT-registered dealers and the country of origin of used imports

### Integrations and API access

Autovit 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. Autovit runs bot-protection services that can block direct requests, so the Actor includes high-quality Romanian proxies automatically at no additional cost. There's nothing to configure.

#### Why are there no phone numbers or names for private sellers?

To respect the privacy of private individuals under the EU's GDPR, the seller data add-on returns phone numbers and names for dealers (professional sellers) only, and the dealer name is the trading name, never the account holder's personal name. Private sellers come back with their seller type and nothing personal, and are not charged for the add-on. The VIN, the licence plate and the registration date are not extracted either.

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

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

#### What does the price evaluation mean?

It is Autovit's own rating of the asking price against similar vehicles: `BELOW`, `IN` or `ABOVE` market. It appears on search results for cars; motorcycles, vans and vehicles without a rating return `null`.

#### Why are some prices in RON?

Most Autovit sellers list in EUR and some in RON. Each vehicle carries its own `currency`; prices are never converted.

#### How often is the data updated?

Autovit 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 Autovit. Ensure your URLs match the compatible formats listed above. URLs outside these patterns (trucks, trailers, machinery, parts) are skipped with a warning in the log.

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

### În limba română

**Autovit Scraper** extrage anunțurile de autoturisme, motociclete și autoutilitare de pe [Autovit.ro](https://www.autovit.ro/): marcă, model, generație, versiune, an de fabricație, kilometraj, combustibil, putere, preț (cu sau fără TVA, în EUR sau RON), evaluarea prețului făcută de Autovit (sub / în / peste prețul pieței), reduceri de preț, localitate, județ și vânzător. Proxy-uri din România incluse, fără configurare.

**Scrie vehiculele în loc de adrese:** în câmpul *Search vehicles* este suficient să scrii marca, modelul sau ambele (de ex. `Dacia Duster`, `dacia`, `Skoda Octavia`); textul este potrivit cu catalogul Autovit, iar filtrele (tip vehicul, stare, județ, localitate, an, vânzător, preț, kilometraj) restrâng rezultatele.

**Adrese URL acceptate:** căutări din `/autoturisme`, `/motociclete` sau `/autoutilitare` cu orice filtre (marcă, model, județ, an, caroserie, preț, cuvânt cheie, nou sau second, sortare), anunțuri individuale (`/autoturisme/anunt/...-ID7HQTVC.html`, și forma scurtă `/anunt/...`) și paginile dealerilor (`https://bdvbestauto.autovit.ro`, tot stocul dealerului). Alte categorii (camioane, remorci, utilaje de construcții și agricole, piese) nu sunt acceptate și sunt omise.

**Add-on-uri opționale:**

- **Detalii anunț** — descrierea completă, toate fotografiile, datele publicării și actualizării, coordonatele și dacă prețul este negociabil. Numerele de telefon și adresele de email scrise în descriere sunt ascunse. Se taxează fiecare vehicul cu detalii.
- **Date vânzător** — telefoanele dealerului, adresa, codul poștal, coordonatele, site-ul, numărul de anunțuri active și anul înscrierii pe Autovit. Telefoanele și denumirile comerciale doar pentru dealeri (vânzători profesioniști; niciodată numele titularului contului), conform GDPR: vânzătorii persoane fizice returnează doar tipul vânzătorului, fără date personale, și nu sunt taxați pentru acest add-on. Se taxează doar când este returnat cel puțin un număr de telefon.

Fiecare vehicul este returnat (și taxat) o singură dată pe rulare. Seria de șasiu (VIN), numărul de înmatriculare și data primei înmatriculări nu sunt extrase; o serie de șasiu scrisă în descriere este înlocuită cu `[id hidden]`. Pentru anunțurile individuale, câmpurile disponibile doar în rezultatele căutării (`price_evaluation`, `price_drop_pct`, `old_price`, `is_promoted`, `is_highlighted`, `listed_at`, `bumped_at`) rămân goale.

# Changelog

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

# Actor input Schema

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

Type it the way you would in Autovit's search box: a make (`dacia`), a model (`Duster`) or both (`Skoda Octavia`). One per line, each becomes its own search. Spelling is matched against Autovit's own catalog. For vans only the make is matched. Leave empty if you only paste URLs below.

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

Autovit URLs copied from your browser: searches for cars (`/autoturisme`), motorcycles (`/motociclete`) or vans (`/autoutilitare`) with any filters, e.g. `https://www.autovit.ro/autoturisme/bmw/seria-3?search[filter_float_price:to]=20000`, single ads (`/autoturisme/anunt/...-ID7HQTVC.html` or `/anunt/...`) and dealer pages (`https://bdvbestauto.autovit.ro`).

## `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 vans. Applies to the vehicles typed above.

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

Used, new, or both.

## `county` (type: `string`):

Romanian county (județ). Leave empty to search the whole country.

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

A city, for example `Cluj-Napoca`. Searches the city and 50 km around it, Autovit's default radius; the name is checked against Autovit's own location list, and an unknown name, or one shared by several places when no county is picked, is skipped and named in the status message. If you also pick a county, the city must be in it.

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

Oldest production year to include.

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

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

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

Dealers (firme), private sellers, or both.

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

Lowest asking price to include, in euros.

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

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

## `kmFrom` (type: `integer`):

Lowest mileage to include.

## `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 full description, every photo, publication and update dates, map coordinates and whether the price is negotiable. Phone numbers and emails typed into the description are hidden. Charged per vehicle with details.

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

Add the seller profile: dealer phone numbers, address, postal code, map coordinates, website, number of active ads and member-since year. Phone numbers and names are returned for dealers only; private sellers return the seller type and nothing personal. You are charged only when a phone number is returned.

## Actor input object example

```json
{
  "vehicles": [
    "Dacia Duster",
    "Skoda Octavia"
  ],
  "startUrls": [
    "https://www.autovit.ro/autoturisme/bmw/seria-3?search[filter_float_price:to]=20000"
  ],
  "maxRequests": 10,
  "vehicleType": "car",
  "condition": "all",
  "sellerType": "all",
  "detailsAddon": false,
  "sellerDataAddon": false
}
```

# Actor output Schema

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

All scraped items.

# 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": [
        "Dacia Duster",
        "Skoda Octavia"
    ],
    "maxRequests": 10,
    "detailsAddon": false,
    "sellerDataAddon": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("ribtools/autovit-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": [
        "Dacia Duster",
        "Skoda Octavia",
    ],
    "maxRequests": 10,
    "detailsAddon": False,
    "sellerDataAddon": False,
}

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

```

## MCP server setup

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