Разделы документации

Начало

Быстрый старт Ключи и заголовки Базы и поля

Методы

GET /v1/me GET /v1/{base}/makes GET /v1/{base}/models GET /v1/{base}/filters GET /v1/{base}/lots GET /v1/{base}/lots/{id} GET /v1/rates

Правила

Ошибки Лимиты Капча посетителя Фото и Referer

Инструменты

Песочница SDK для PHP Примеры

Поиск лотов

GET /v1/{base}/lots

Список лотов с фильтрами и сортировкой. Все параметры необязательны. Перечисления можно передавать списком через запятую: fuel=hybrid,phev.

ПараметрОписание
make, modelslug марки и модели (model — только вместе с make)
year_from, year_toгод, включительно
mileage_toпробег до, км
price_from, price_toцена в валюте базы
engine_from, engine_toобъём двигателя, см³
fuelpetrol diesel hybrid electric phev gas other
transmissionat mt cvt robot other
drivefwd rwd awd 4wd
bodysedan suv hatchback wagon minivan coupe pickup van truck other
auctionплощадка или несколько через запятую (до 20), значения — из /filters; jp, jpstat
date, date_from, date_toдата торгов YYYY-MM-DD; jp, jpstat
sortdate (по умолчанию: 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. Для глубокой навигации сужайте фильтры, а не листайте дальше.