All you need to know before start working with our comprehensive Tire API - vehicle-specific tire data at your fingertips.
View all endpoints ↓
/search_allmake — get all vehicle makes
🔄 /reverse_lookup — tire size → vehicles
📅 /year_range — year range for any make or model
Get started with the Tire API in seconds. Test your first request below.
curl -H "x-api-key: YOUR_API_KEY" \
"/api/v1/tire_dimensions?year=2023&make=Toyota&model=Camry&trim=LE AWD"
Interactive Swagger UI with try-it-out functionality. Test all endpoints directly in your browser with your API key.
All endpoints fully expanded with parameters, response schemas, and examples. Best for deep integration work.
Manage your API key, monitor usage, and handle your subscription from your account dashboard.
Collapsed endpoint list for fast lookup. Perfect when you already know the API and just need a parameter name.
Download the machine-readable YAML spec to import directly into Postman, Insomnia, or your code generator.
Raw OpenAPI 3.0 JSON spec for tools that prefer JSON format or for automated pipeline integration.
Get all vehicle makes available in the database. Use to populate the first dropdown in a search UI without needing a year first. Highly cacheable.
Given a tire size, returns every vehicle (year / make / model / trim) that uses it. Accepts a full tiresize string or individual width, aspectratio, diameter params.
Returns the earliest year, latest year, and total model years for a given make — or a make + model combo. Useful for year sliders and input validation.
Get tire dimensions (width, aspect ratio, diameter) for a specific vehicle configuration. Essential for vehicle-based tire search applications.
Get vehicle data by query type: make, model, trim, or tiresize. Perfect for building cascading selection interfaces.
Get tire size data including aspect ratios and diameters. Build tire size selection interfaces based on width filters.
Get all available years in the tire database. Perfect for populating year dropdown menus. Highly cacheable.
Get all available tire widths from database. Use for tire size-based search interfaces. Highly cacheable.
Get your API usage statistics including daily limits and current usage counts. Does not count against rate limits.
// Modern async/await approach with error handling
async function getTireDimensions(year, make, model, trim) {
const API_KEY = 'your-api-key-here';
const BASE_URL = '/api/v1';
try {
const params = new URLSearchParams({ year, make, model, trim });
const response = await fetch(`${BASE_URL}/tire_dimensions?${params}`, {
headers: { 'x-api-key': API_KEY }
});
if (!response.ok) {
throw new Error(`API Error: ${response.status}`);
}
const data = await response.json();
return data.dimensions;
} catch (error) {
console.error('Failed to fetch tire dimensions:', error);
return null;
}
}
import requests
from typing import Optional, Dict
class TireAPIClient:
def __init__(self, api_key: str):
self.api_key = api_key
self.base_url = '/api/v1'
self.headers = {'x-api-key': self.api_key}
def get_tire_dimensions(self, year: str, make: str, model: str, trim: str) -> Optional[Dict]:
try:
response = requests.get(
f'{self.base_url}/tire_dimensions',
params={'year': year, 'make': make, 'model': model, 'trim': trim},
headers=self.headers
)
response.raise_for_status()
return response.json()
except requests.RequestException as e:
print(f"API request failed: {e}")
return None
# Get tire dimensions for specific vehicle
curl -H "x-api-key: your-api-key-here" \
"/api/v1/tire_dimensions?year=2023&make=Toyota&model=Camry&trim=LE%20AWD"
# Browse makes available for a given year
curl -H "x-api-key: your-api-key-here" \
"/api/v1/by_vehicle/make?year=2023"
# Check your API usage
curl -H "x-api-key: your-api-key-here" \
"/api/v1/usage"
# Get all vehicle makes (great for first dropdown, 1-hour cache)
curl -H "x-api-key: your-api-key-here" \
"/api/v1/search_allmake"
# Reverse lookup — which vehicles use 225/60R16?
curl -H "x-api-key: your-api-key-here" \
"/api/v1/reverse_lookup?tiresize=225/60R16"
# Reverse lookup using individual dimensions
curl -H "x-api-key: your-api-key-here" \
"/api/v1/reverse_lookup?width=225&aspectratio=60&diameter=16"
# Year range for Toyota (all models)
curl -H "x-api-key: your-api-key-here" \
"/api/v1/year_range?make=Toyota"
# Year range for Toyota Camry specifically
curl -H "x-api-key: your-api-key-here" \
"/api/v1/year_range?make=Toyota&model=Camry"
Get assistance with integration, troubleshooting, or technical questions about the Tire API.