# Drom API scraper — auto.drom.ru, Russia's largest car marketplace: search used and new cars by make, model and region with drom's own filters and sorts, and read the full ad record. Every car comes back with the price in roubles checked against the price string drom prints beside it, the published year, odometer, engine, gearbox, drive and body, whether a private person or a dealer is selling, and drom's own below/at/above-market price rating. No account, no browser.

> Search auto.drom.ru the way its own visitors do: pick a make and model, narrow to a city or region with a radius, and apply drom's own year, price, odometer, engine volume, power, gearbox, fuel, drive, body, steering-side, damage, paperwork and seller-type filters. Every car returns the rouble price cross-checked against the price string drom renders next to it, the model year drom publishes, the odometer with drom's own formatted reading beside it, engine volume and power, gearbox, fuel and drive in both a stable code and drom's own Russian word, the body type, the city, whether a private person or a dealership is selling (drom's own flag, never inferred), drom's own price rating against the market, its row badges (only-on-drom, from-the-owner, brand-new, never-registered-in-Russia) and the ad's photos. Sort by price, model year, odometer, engine size or drom's price rating, and page through the result set 20 cars at a time up to page 100. The answer repeats every filter drom actually applied, read back out of drom's own echo — a filter drom dropped is an error, never a quietly widened result.
> ReefAPI engine `drom` · 3 endpoints · clean JSON, no scraping or browsers to manage.

## Measured
- Drom API, measured on live customer calls 17 Oct – 16 Nov 2026: 99.7% of calls succeeded, median response 1.1 s. Failures count only when the problem is ours (blocked, source error, parse error, timeout); not-found results and invalid parameters are not failures.
- OpenAPI 3.0 spec for this API: https://api.reefapi.com/openapi/drom.json

## How to call
- **Endpoint:** `POST https://api.reefapi.com/drom/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/drom/v1/search — 1 credit
Search auto.drom.ru the way its own visitors do: pick a make and model, narrow to a city or region with a radius, and apply drom's own year, price, odometer, engine volume, power, gearbox, fuel, drive, body, steering-side, damage, paperwork and seller-type filters. Every car returns the rouble price cross-checked against the price string drom renders next to it, the model year drom publishes, the odometer with drom's own formatted reading beside it, engine volume and power, gearbox, fuel and drive in both a stable code and drom's own Russian word, the body type, the city, whether a private person or a dealership is selling (drom's own flag, never inferred), drom's own price rating against the market, its row badges (only-on-drom, from-the-owner, brand-new, never-registered-in-Russia) and the ad's photos. Sort by price, model year, odometer, engine size or drom's price rating, and page through the result set 20 cars at a time up to page 100. The answer repeats every filter drom actually applied, read back out of drom's own echo — a filter drom dropped is an error, never a quietly widened result.

**Parameters:**
- `make` (string, optional) — Make slug exactly as it appears in a drom URL (auto.drom.ru/<make>/). Omit it to search every make in Russia.
- `model` (string, optional) — Model slug exactly as it appears in a drom URL (auto.drom.ru/<make>/<model>/). Requires `make`. Call `models` to list the slugs drom publishes for a make.
- `region` (string, optional) — City or region slug exactly as it appears in a drom URL (auto.drom.ru/<region>/<make>/). A slug drom does not know is reported as not found, never silently ignored.
- `page` (integer, optional, default 1) — Result page, 20 cars each. Drom stops at page 100.
- `sort` (enum, optional, default "relevance") — Drom's own result order. `relevance` is drom's default. [one of: relevance, price_asc, price_desc, year_desc, year_asc, price_rating, mileage_asc, engine_volume_desc]
- `min_year` (integer, optional) — Oldest model year to include.
- `max_year` (integer, optional) — Newest model year to include.
- `min_price` (integer, optional) — Lowest asking price, roubles.
- `max_price` (integer, optional) — Highest asking price, roubles.
- `min_mileage` (integer, optional) — Lowest odometer reading, kilometres.
- `max_mileage` (integer, optional) — Highest odometer reading, kilometres.
- `min_engine_volume` (number, optional) — Smallest engine, litres (drom's own steps, e.g. 0.7 … 8.0).
- `max_engine_volume` (number, optional) — Largest engine, litres.
- `min_power` (integer, optional) — Lowest engine power, metric horsepower.
- `max_power` (integer, optional) — Highest engine power, metric horsepower.
- `transmission` (enum, optional) — Gearbox. `automatic` is drom's own umbrella and includes CVT cars; `cvt` selects CVT only. [one of: manual, automatic, cvt, robot, other]
- `fuel_type` (enum, optional) — Fuel, as drom classifies it. [one of: petrol, diesel, electric, hybrid, lpg]
- `drive` (enum, optional) — Driven wheels. [one of: front, rear, awd]
- `body_type` (enum, optional) — Body style, from drom's own list. [one of: sedan, hatchback_5d, hatchback_3d, liftback, suv_5d, suv_3d, wagon, minivan, pickup, coupe, convertible]
- `wheel` (enum, optional) — Steering side. Russia's used market carries a large right-hand-drive Japanese import stock, so this is a real filter there. [one of: left, right]
- `seller_type` (enum, optional) — Who is selling. Drom's own split; it partitions the result set exactly. [one of: private, dealer]
- `damaged_only` (boolean, optional) — Only cars drom marks as damaged / not roadworthy.
- `with_documents` (boolean, optional) — Only cars sold with full registration paperwork.
- `unsold_only` (boolean, optional) — Hide ads drom has already marked as sold.
- `with_photo_only` (boolean, optional) — Only ads that carry photos.
- `distance_km` (integer, optional) — Widen the search that many kilometres around `region`. Drom ignores this without a region, so it is refused without one. [one of: 100, 200, 500, 1000]

**Returns:** { query: {make, model, region, page, sort, url}, total, page, page_size, pages_available, has_more, filters_applied, filters_echoed, results: [ {listing_id, url, title, trim, year, price, price_shown, currency, price_rating, price_rating_label, mileage_km, mileage_label, engine_volume_l, power_hp, fuel_type, gearbox, drive, body_type, is_new, is_sold, seller_type, dealer_name, location, published_label, badges, image_count, images } ] }

**Example request body:**
```json
{
  "make": "toyota",
  "model": "camry"
}
```

### POST https://api.reefapi.com/drom/v1/detail — 1 credit
Read one drom ad in full, by its numeric id or by its URL. Returns the asking price in roubles cross-checked against the price string drom prints, drom's own estimate of what the car is worth on the market and its below/at/above-market rating, the published year, odometer (checked against drom's own formatted reading), engine volume and power, fuel with the hybrid and LPG flags drom sets, gearbox, drive, body, colour, steering side and owner count in drom's own words, the generation and trim with links to drom's catalogue, the masked VIN, whether drom records damage and full paperwork, the summary of drom's public vehicle-history check, the seller's kind (private person or dealership) with what the ad page publishes about it — the dealership's name, page, age, listing count and official flag, or a private seller's account age and avatar letter (drom prints no private name; the phone sits behind drom's click-to-reveal and is not fetched), the city, the publication date, the view counter, the seller's own description and every photo. A withdrawn or non-existent ad is reported as not found.

**Parameters:**
- `listing` (string, required) — The ad's numeric id (the number in the URL before `.html`) or the full auto.drom.ru ad URL.

**Returns:** { listing: {listing_id, url, title, make, model, year, price, market_price, price_rating, mileage_km, engine_volume_l, power_hp, fuel_type, is_hybrid, gearbox_label, drive, body_type, colour_label, owners_label, wheel, generation, trim, vin_masked, has_damage, has_documents, seller{kind, dealer_name, dealer_url, dealer_official, dealer_listing_count, account_age, avatar_letter}, location, published_date, views_total, description, images, history_checks } }

**Example request body:**
```json
{
  "listing": "616952799"
}
```

### POST https://api.reefapi.com/drom/v1/models — 1 credit
List every model auto.drom.ru publishes for one make, with the slug `search` needs and the live ad count drom shows for it — so a caller never has to guess a slug. Drom's own top-models block is flagged. A make drom does not know is reported as not found.

**Parameters:**
- `make` (string, required) — Make slug exactly as it appears in a drom URL (auto.drom.ru/<make>/).

**Returns:** { make: {slug, name, url}, count, results: [ {slug, name, url, ads_used, ads_new, is_top} ] }

**Example request body:**
```json
{
  "make": "toyota"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=drom
- Human docs page: https://reefapi.com/docs/drom
- Overview page: https://reefapi.com/drom-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
