Початок роботи
Ліміти коротко
| Що | Ліміт | Понад ліміт |
|---|---|---|
Розмір сторінки /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, що й у платних планах.