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

Начало

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

Методы

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 Примеры

Примеры

curl

# марки Кореи
curl "https://api.lotavto.ru/v1/kr/makes" -H "X-Api-Key: $LOTAVTO_KEY" -H "X-Visitor-Ip: 203.0.113.7"

# итоги торгов Японии за неделю, Land Cruiser Prado, сначала дорогие
curl -G "https://api.lotavto.ru/v1/jpstat/lots" \
  -d make=toyota -d model=land-cruiser-prado \
  -d date_from=2026-11-15 -d date_to=2026-11-22 -d sort=price_desc \
  -H "X-Api-Key: $LOTAVTO_KEY" -H "X-Visitor-Ip: 203.0.113.7"

# карточка
curl "https://api.lotavto.ru/v1/dongchedi/lots/dongchedi-52211" -H "X-Api-Key: $LOTAVTO_KEY" -H "X-Visitor-Ip: 203.0.113.7"

PHP без SDK

<?php
function lotavto_get($path, array $query = array())
{
    $url = 'https://api.lotavto.ru' . $path . ($query ? '?' . http_build_query($query) : '');
    $headers = array(
        'X-Api-Key: ' . getenv('LOTAVTO_KEY'),
        'X-Visitor-Ip: ' . $_SERVER['REMOTE_ADDR'],
        'X-Visitor-Ua: ' . substr(isset($_SERVER['HTTP_USER_AGENT']) ? $_SERVER['HTTP_USER_AGENT'] : '', 0, 300),
    );
    if (!empty($_COOKIE['la_pass'])) $headers[] = 'X-Visitor-Pass: ' . $_COOKIE['la_pass'];

    $ch = curl_init($url);
    curl_setopt_array($ch, array(
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_CONNECTTIMEOUT => 5,
        CURLOPT_TIMEOUT => 10,
    ));
    $body = curl_exec($ch);
    $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    $res = json_decode((string)$body, true);
    if (!is_array($res)) return array('ok' => false, 'error' => array('code' => 'network', 'message' => 'Нет ответа'), 'http' => $code);
    $res['http'] = $code;
    return $res;
}

$res = lotavto_get('/v1/jp/lots', array('make' => 'honda', 'model' => 'vezel', 'per_page' => 12));
if ($res['ok']) {
    foreach ($res['data'] as $lot) {
        printf("%s %s %d, %s км — %s %s\n", $lot['make'], $lot['model'], $lot['year'],
            number_format((int)$lot['mileage_km'], 0, ',', ' '), number_format((int)$lot['price'], 0, ',', ' '), $lot['currency']);
    }
} elseif ($res['error']['code'] === 'captcha_required') {
    // показать посетителю капчу — см. раздел «Капча посетителя»
}

Пересчёт цены в рубли

<?php
$rates = lotavto_get('/v1/rates');
$rub = $lot['price'] * $rates['data']['rates'][$lot['currency']];
echo number_format($rub, 0, ',', ' ') . ' ₽';

Каталог с фильтрами (SDK)

<?php
require __DIR__ . '/lotavto_client.php';
$api = new LotavtoClient(getenv('LOTAVTO_KEY'), array('cacheDir' => __DIR__ . '/cache'));

$base = 'kr';
$params = array_intersect_key($_GET, array_flip(array(
    'make', 'model', 'year_from', 'year_to', 'price_to', 'fuel', 'sort', 'page',
)));
$makes   = $api->makes($base);                                // для выпадающего списка
$filters = $api->filters($base, array_intersect_key($params, array('make' => 1, 'model' => 1)));
$lots    = $api->lots($base, $params + array('per_page' => 24));
if ($lots === false && $api->isCaptchaRequired()) { echo $api->captchaHtml(); exit; }