Поиск лотов
GET /v1/{base}/lots
Список лотов с фильтрами и сортировкой. Все параметры необязательны. Перечисления можно передавать списком через запятую: fuel=hybrid,phev.
| Параметр | Описание |
|---|---|
make, model | slug марки и модели (model — только вместе с make) |
year_from, year_to | год, включительно |
mileage_to | пробег до, км |
price_from, price_to | цена в валюте базы |
engine_from, engine_to | объём двигателя, см³ |
fuel | petrol diesel hybrid electric phev gas other |
transmission | at mt cvt robot other |
drive | fwd rwd awd 4wd |
body | sedan suv hatchback wagon minivan coupe pickup van truck other |
auction | площадка или несколько через запятую (до 20), значения — из /filters; jp, jpstat |
date, date_from, date_to | дата торгов YYYY-MM-DD; jp, jpstat |
sort | date (по умолчанию: jp — ближайшие торги первыми, jpstat — свежие итоги первыми, остальные — по обновлению), price_asc, price_desc, year_desc, mileage_asc, updated |
page | страница, 1–100 |
per_page | лотов на странице, 1–50, по умолчанию 20 |
Неизвестное значение параметра — ошибка 400 bad_request с перечнем допустимых значений. При сортировке по цене и пробегу лоты без этих значений не попадают в выдачу.
curl -G "https://api.lotavto.ru/v1/jp/lots" \
--data-urlencode "make=toyota" --data-urlencode "model=prius" \
--data-urlencode "year_from=2019" --data-urlencode "fuel=hybrid" \
--data-urlencode "sort=price_asc" --data-urlencode "per_page=20" \
-H "X-Api-Key: la_live_…" -H "X-Visitor-Ip: 203.0.113.7"{
"ok": true,
"data": [
{
"id": "jp-1048213",
"make": "Toyota", "model": "Prius", "generation": "ZVW50", "grade": "S Safety Plus",
"year": 2019, "mileage_km": 42000, "engine_cc": 1800, "power_hp": 98,
"fuel": "hybrid", "transmission": "cvt", "drive": "fwd", "body": "hatchback",
"price": 1250000, "currency": "JPY",
"auction": "USS Tokyo", "auction_date": "2026-11-24", "lot_number": "40312", "score": "4.5",
"result": null, "city": null, "status": "active",
"photo": "https://img1.lotavto.ru/k/k3j9x0aa2b/…/1.jpg", "photo_count": 18
}
],
"meta": { "base": "jp", "updated_at": "2026-11-22T10:05:00+03:00",
"page": 1, "per_page": 20, "total": 318, "total_capped": false, "pages": 16, "sort": "price_asc" }
}Постраничный вывод
Доступно не больше 100 страниц. total при сложных фильтрах считается до 10 000 — тогда total_capped: true. Для глубокой навигации сужайте фильтры, а не листайте дальше.