Connect key
GET/brandsDictionaries

Vehicle brands

List or search brands for automobiles or motorcycles.

  • Omit vehicle_type for automobiles, or send motorcycle / 2 for motorcycles. Keep the type on every model, generation, variant and trim request.
  • Without pagination parameters, keeps the legacy array: up to 10,000 brands, or 50 with query. Send per_page=100 to enable pagination.
  • Paged results sort by ID. Follow meta.next_page, or send meta.next_after_id as after_id with page omitted. Cursor traversal has no 10,000-result limit.

Query parameters

6
vehicle_typestringdefault automobile

vehicle_type=automobile / 1 is the default; motorcycle / 2 selects motorcycles on /search, /search/count and /cars. Use the same type for dictionaries.

querystring≤ 200 chars

Optional literal name or synonym search, up to 200 characters. Blank disables search; * and ? are literal text.

pageinteger1–10,000 · default 1

per_page is 1–100, default 100. Use page or after_id, never both. Offset: page × per_page ≤ 10000. For complete traversal, send next_after_id as after_id with page omitted until has_more=false. total then counts remaining matches.

per_pageinteger1–100 · default 100

per_page is 1–100, default 100. Use page or after_id, never both. Offset: page × per_page ≤ 10000. For complete traversal, send next_after_id as after_id with page omitted until has_more=false. total then counts remaining matches.

after_idinteger≥ 1

per_page is 1–100, default 100. Use page or after_id, never both. Offset: page × per_page ≤ 10000. For complete traversal, send next_after_id as after_id with page omitted until has_more=false. total then counts remaining matches.

langstring

Response locale. Option translations are also limited by the account languages. The page selects its current language automatically.

Returns · A bare array of Brand objects, or {data, meta} when page, per_page or after_id is supplied.
GET/brands
curl -g "https://api.auctionsapi.com/brands?api_key=$CARS_API_KEY" \
  -H "Accept: application/json"
ExamplesRecorded
[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"
}
]

Get API access

Connect your key to run every request on these pages against your own data. No key yet? Ask us for a demo key: the same JSON as the paid plans.

I have a key