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

Начало

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

Методы

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

Лимиты

ЧтоЛимитПри превышении
Запросы ключа к базе10 000 в сутки на каждый продукт подписки (Япония = jp + jpstat)429 limit_exceeded до полуночи МСК
Песочница1 000 в сутки на ключ, все базы вместе429 limit_exceeded
Один посетитель (X-Visitor-Ip)60 в минуту, 600 в час, 3 000 в сутки в рамках ключасначала 428 captcha_required, после капчи — повторно 429
Разные карточки /lots/{id}за сутки — не больше 15 % размера базы продукта429 coverage_exceeded для новых карточек

Сутки — по московскому времени. Остаток суточного лимита — в заголовках ответа X-RateLimit-Remaining / X-RateLimit-Reset, в /v1/me и в кабинете (раздел «Использование», с задержкой до минуты).

Запросы с ошибкой в параметрах (400) лимит не расходуют.

Как уложиться

  • Кэшируйте справочники (makes, models, filters, rates) на 10–60 минут.
  • Кэшируйте выдачу популярных страниц каталога на несколько минут — особенно главную и страницы марок.
  • Не делайте запросов для поисковых роботов на каждой странице: отдавайте им кэш.
  • Передавайте настоящий IP посетителя — иначе лимит «одного посетителя» быстро закончится у всех.
Защита настроена против массовой выгрузки, а не против обычных посетителей. Если сайт упирается в лимиты при честном трафике — проверьте, что передаёте IP посетителя, и включите кэш.