CarStat.dev
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.carstat.dev/brands?api_key=$CARS_API_KEY" \
  -H "Accept: application/json"
ПримерыЗаписано
[3 items
0: {3 keys
"id": 88
"name": "Mercedes-Benz"
"icon_url": "https://api.carstat.dev/media/brands/2f73746f726167652f6272616e64732f6d657263656465732e737667"
}
1: {3 keys
"id": 89
"name": "Mercury"
"icon_url": "https://api.carstat.dev/media/brands/2f73746f726167652f6272616e64732f4d6572637572792e737667"
}
2: {3 keys
"id": 500483
"name": "Farizon Auto"
"icon_url": "https://api.carstat.dev/media/brands/2f73746f726167652f6272616e64732f427836376e644471326d7936626163666e484837735747433944793030484f5446326b4b564d57362e69636f"
}
]

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

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

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