GET/models/{brand_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 считает оставшиеся совпадения.

Параметры пути

1
brand_idinteger≥ 1Обязательный

Positive brand ID from /brands for the same vehicle_type.

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

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/models/{brand_id}
curl -g "https://api.auctionsapi.com/models/88?api_key=$CARS_API_KEY" \
  -H "Accept: application/json"
ПримерыЗаписано
[2 items
0: {3 keys
"id": 1968
"name": "Flying Spur"
"generations": [2 items]
}
1: {3 keys
"id": 2489
"name": "Bentayga"
"generations": [2 items]
}
]

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

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

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