GET/brandsСправочники

Бренды транспорта

Бренды автомобилей по умолчанию; vehicle_type=motorcycle выбирает мотоциклы. Поиск query и явная пагинация через page/per_page/after_id.

  • Без vehicle_type возвращаются автомобили; motorcycle / 2 выбирает мотоциклы. Сохраняйте тип на каждом шаге.
  • Без пагинации /brands и /models сохраняют прежние массивы и лимиты. Передайте per_page=100 для {data,meta}. Вложенные generations сохраняют {name,from,to}; ID поколений берите из /generations/{model_id}.
  • per_page — 1–100, по умолчанию 100. Используйте page или after_id, но не оба. Для страниц: page × per_page ≤ 10000. Для полной выгрузки передавайте next_after_id как after_id без page до has_more=false. Тогда total считает оставшиеся совпадения.

Параметры запроса

6
vehicle_typestringdefault automobile

vehicle_type=automobile / 1 — по умолчанию; motorcycle / 2 выбирает мотоциклы в /search, /search/count и /cars. В справочниках используйте тот же тип.

querystring≤ 200 chars

Необязательный поиск по именам и синонимам, до 200 символов. Пустая строка отключает поиск; * и ? — обычный текст.

pageinteger1–10,000 · default 1

per_page — 1–100, по умолчанию 100. Используйте page или after_id, но не оба. Для страниц: page × per_page ≤ 10000. Для полной выгрузки передавайте next_after_id как after_id без page до has_more=false. Тогда total считает оставшиеся совпадения.

per_pageinteger1–100 · default 100

per_page — 1–100, по умолчанию 100. Используйте page или after_id, но не оба. Для страниц: page × per_page ≤ 10000. Для полной выгрузки передавайте next_after_id как after_id без page до has_more=false. Тогда total считает оставшиеся совпадения.

after_idinteger≥ 1

per_page — 1–100, по умолчанию 100. Используйте page или after_id, но не оба. Для страниц: page × per_page ≤ 10000. Для полной выгрузки передавайте next_after_id как after_id без page до has_more=false. Тогда total считает оставшиеся совпадения.

langstring

Локаль ответа. Переводы опций также ограничены языками аккаунта. Страница автоматически подставляет текущий язык.

Возвращает · Без пагинации /brands и /models сохраняют прежние массивы и лимиты. Передайте per_page=100 для {data,meta}. Вложенные generations сохраняют {name,from,to}; ID поколений берите из /generations/{model_id}.
GET/brands
curl -g "https://api.auctionsapi.com/brands?api_key=$CARS_API_KEY" \
  -H "Accept: application/json"
ПримерыЗаписано
[3 items
0: {3 keys
"id": 88
"name": "Mercedes-Benz"
"icon_url": "https://api.zvelta.com/storage/brands/mercedes.svg"
}
1: {3 keys
"id": 89
"name": "Mercury"
"icon_url": "https://api.zvelta.com/storage/brands/Mercury.svg"
}
2: {3 keys
"id": 500483
"name": "Farizon Auto"
"icon_url": "https://api.zvelta.com/storage/brands/Bx67ndDq2my6bacfnHH7sWGC9Dy00HOTF2kKVMW6.ico"
}
]

Получите доступ к API

Подключите ключ, чтобы выполнять любой запрос с этих страниц на своих данных. Ключа ещё нет? Попросите у нас демо-ключ: тот же JSON, что и в платных тарифах.

У меня есть ключ