The Developer-Friendly Vehicle Specifications API

import requests

API_KEY = 'YOUR_API_KEY'

# Get all makes for 2025 model year
headers = {
    'Authorization': f'Bearer {API_KEY}',
    'Referer': 'https://your-website.com'  # Required for demo tokens
}

year_response = requests.get(
    'https://v3.api.car2db.com/years/2025',
    headers=headers
)
year_data = year_response.json()
first_make_id = year_data['makeIds'][0]

# Get details of the first make
make_response = requests.get(
    f'https://v3.api.car2db.com/makes/{first_make_id}',
    headers=headers
)
make = make_response.json()

print(f"{make['name']} (ID: {make['id']})")
# → "Audi (ID: 10)"

<?php
$apiKey = 'YOUR_API_KEY';

// Get all makes for 2025 model year
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://v3.api.car2db.com/years/2025');
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer {$apiKey}"]);
curl_setopt($ch, CURLOPT_REFERER, 'https://your-website.com');  // Required for demo tokens
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$yearResponse = curl_exec($ch);
$yearData = json_decode($yearResponse, true);
$firstMakeId = $yearData['makeIds'][0];

// Get details of the first make
curl_setopt($ch, CURLOPT_URL,
    "https://v3.api.car2db.com/makes/{$firstMakeId}");
$makeResponse = curl_exec($ch);
$make = json_decode($makeResponse, true);

echo "{$make['name']} (ID: {$make['id']})";
// → "Audi (ID: 10)"

API_KEY="YOUR_API_KEY"

# Step 1: Get all make IDs for 2025
curl -X GET "https://v3.api.car2db.com/years/2025" \
     -H "Authorization: Bearer $API_KEY" \
     -H "Referer: https://your-website.com"

# Response:
{
  "year": 2025,
  "typeId": 1,
  "makeIds": [10, 9, 34, 56, 72],
  "modelIds": [120, 245, 678],
  "generationIds": [1234, 5678],
  "seriesIds": [9876, 5432],
  "trimIds": [11111, 22222]
}

# Step 2: Get details of first make (ID: 10)
curl -X GET "https://v3.api.car2db.com/makes/10" \
     -H "Authorization: Bearer $API_KEY" \
     -H "Referer: https://your-website.com"

# Response:
{
  "id": 10,
  "name": "Audi",
  "dateCreate": 1609459200,
  "dateUpdate": 1704067200,
  "typeId": 1,
  "modelIds": [120, 121, 122]
}