Подключить ключ
GET/generations/{model_id}Справочники

Поколения транспорта

Активные поколения модели: ID, годы выпуска, поиск и пагинация. По умолчанию автомобили; vehicle_type=motorcycle — мотоциклы.

  • Без vehicle_type возвращаются автомобили; motorcycle / 2 выбирает мотоциклы. Сохраняйте тип на каждом шаге.
  • ID модели берите из /models/{brand_id}. Возвращает активные поколения с from_year, to_year, ordinal, code; query ищет и эти обозначения. Неизвестный родитель или другой тип даёт пустые данные.
  • per_page — 1–100, по умолчанию 100. Используйте page или after_id, но не оба. Для страниц: page × per_page ≤ 10000. Для полной выгрузки передавайте next_after_id как after_id без page до has_more=false. Тогда total считает оставшиеся совпадения.

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

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

Положительный ID родителя из предыдущего справочника; сохраняйте 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

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

Возвращает · {data,meta}: идентификаторы, точное количество и следующая страница / ID-курсор.
GET/generations/{model_id}
curl -g "https://api.auctionsapi.com/generations/201?api_key=$CARS_API_KEY" \
  -H "Accept: application/json"
ПримерыПример
{2 keys
"data": [1 item
0: {9 keys
"id": 301
"name": "Example generation"
"brand_id": 101
"model_id": 201
"vehicle_type": 1
"from_year": 2020
"to_year": null
"ordinal": null
"code": "EX1"
}
]
"meta": {8 keys}
}

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

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

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