Drom
Drom
/drom/v1/search1 creditSearch 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| make | optional | — | Make slug exactly as it appears in a drom URL (auto.drom.ru/<make>/). Omit it to search every make in Russia. |
| model | 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 | 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 = 1 | optional | 1–100 | Result page, 20 cars each. Drom stops at page 100. |
| sort = relevance | optional | relevance · price_asc · price_desc · year_desc · year_asc · price_rating · mileage_asc · engine_volume_desc | Drom's own result order. `relevance` is drom's default. |
| min_year | optional | 1940–2030 | Oldest model year to include. |
| max_year | optional | 1940–2030 | Newest model year to include. |
| min_price | optional | 0– | Lowest asking price, roubles. |
| max_price | optional | 0– | Highest asking price, roubles. |
| min_mileage | optional | 0– | Lowest odometer reading, kilometres. |
| max_mileage | optional | 0– | Highest odometer reading, kilometres. |
| min_engine_volume | optional | 0.1–15 | Smallest engine, litres (drom's own steps, e.g. 0.7 … 8.0). |
| max_engine_volume | optional | 0.1–15 | Largest engine, litres. |
| min_power | optional | 1–2000 | Lowest engine power, metric horsepower. |
| max_power | optional | 1–2000 | Highest engine power, metric horsepower. |
| transmission | optional | manual · automatic · cvt · robot · other | Gearbox. `automatic` is drom's own umbrella and includes CVT cars; `cvt` selects CVT only. |
| fuel_type | optional | petrol · diesel · electric · hybrid · lpg | Fuel, as drom classifies it. |
| drive | optional | front · rear · awd | Driven wheels. |
| body_type | optional | sedan · hatchback_5d · hatchback_3d · liftback · suv_5d · suv_3d · wagon · minivan · pickup · coupe · convertible | Body style, from drom's own list. |
| wheel | optional | left · right | Steering side. Russia's used market carries a large right-hand-drive Japanese import stock, so this is a real filter there. |
| seller_type | optional | private · dealer | Who is selling. Drom's own split; it partitions the result set exactly. |
| damaged_only | optional | — | Only cars drom marks as damaged / not roadworthy. |
| with_documents | optional | — | Only cars sold with full registration paperwork. |
| unsold_only | optional | — | Hide ads drom has already marked as sold. |
| with_photo_only | optional | — | Only ads that carry photos. |
| distance_km | optional | 100 · 200 · 500 · 1000 | Widen the search that many kilometres around `region`. Drom ignores this without a region, so it is refused without one. |
/drom/v1/detail1 creditRead 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 the dealership's name), 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| listing | required | — | The ad's numeric id (the number in the URL before `.html`) or the full auto.drom.ru ad URL. |
/drom/v1/models1 creditList 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| make | required | — | Make slug exactly as it appears in a drom URL (auto.drom.ru/<make>/). |
curl -X POST https://api.reefapi.com/drom/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"make":"toyota","model":"camry"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.