Начало работы
Лимиты кратко
| Что | Лимит | При превышении |
|---|---|---|
Размер страницы /search | perPage 2–50, по умолчанию 50 | 422 |
Глубина /search | page × perPage ≤ 10,000 | 422 "Max num of offset is 10k" |
/search meta.total | Ограничен 10,000 | Используйте /search/count |
Размер пакета /cars | limit 1–500, по умолчанию 500 | 400 с your_value |
Время жизни курсора /cars | scroll_time 1–15 мин, по умолчанию 10 | 400; истёкший курсор 403/404 |
| Поиск по VIN | 16–19 букв и цифр | 422 |
/brands | 10,000 без query, 50 с ним | Обрезается |
/models/{brand_id} | До 1,000 моделей | Обрезается |
/countries, /locations | per_page 1–1,000, по умолчанию 100; ids[] ≤ 100 | 422 |
/car-options | per_page 1–100, по умолчанию 25; page × per_page ≤ 10,000 | Приводится к допустимому; 422 после 10,000 |
| Дневной лимит | Задаётся для каждого ключа; см. Запросов сегодня на панели | Обратитесь в поддержку, чтобы увеличить |
| Частота запросов | На публичных маршрутах нет фиксированного лимита в минуту | 429/503: соблюдайте Retry-After |
Справочники автомобилей и мотоциклов
per_page — 1–100, по умолчанию 100. Используйте page или after_id, но не оба. Для страниц: page × per_page ≤ 10000. Для полной выгрузки передавайте next_after_id как after_id без page до has_more=false. Тогда total считает оставшиеся совпадения.
Без пагинации /brands и /models сохраняют прежние массивы и лимиты. Передайте per_page=100 для {data,meta}. Вложенные generations сохраняют {name,from,to}; ID поколений берите из /generations/{model_id}.
Получите доступ к API
Подключите ключ, чтобы выполнять любой запрос с этих страниц на своих данных. Ключа ещё нет? Попросите у нас демо-ключ: тот же JSON, что и в платных тарифах.