API DOCUMENTATION  ยท  v1.1.0

Tire & Wheel Fitment API โ€” Full Documentation help?

All you need to know before start working with our comprehensive Tire API - vehicle-specific tire data at your fingertips.

View all endpoints โ†“
NEW IN v1.1.0
๐Ÿ” /search_allmake โ€” get all vehicle makes ๐Ÿ”„ /reverse_lookup โ€” tire size โ†’ vehicles ๐Ÿ“… /year_range โ€” year range for any make or model

๐Ÿš€ Quick Start

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"

Rate Limits & Plans

Free: 300/day Growth: 5K/day Enterprise: 50K/day Premium: 200K/day
๐ŸŽฏ
Getting Started โ†’
  • Interactive Swagger UI with try-it-out functionality. Test all endpoints directly in your browser with your API key.
๐Ÿ“–
Full Reference โ†’
  • All endpoints fully expanded with parameters, response schemas, and examples. Best for deep integration work.
๐Ÿ“Š
API Dashboard โ†’
  • Manage your API key, monitor usage, and handle your subscription from your account dashboard.
โšก
Quick Reference โ†’
  • Collapsed endpoint list for fast lookup. Perfect when you already know the API and just need a parameter name.
๐Ÿ“„
OpenAPI Spec (YAML) โ†’
  • Download the machine-readable YAML spec to import directly into Postman, Insomnia, or your code generator.
๐Ÿ”—
OpenAPI Spec (JSON) โ†’
  • Raw OpenAPI 3.0 JSON spec for tools that prefer JSON format or for automated pipeline integration.

๐Ÿ”— API Endpoints

GET
/api/v1/search_allmake
New in v1.1.0
  • 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.
GET
/api/v1/reverse_lookup
New in v1.1.0
  • 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.
GET
/api/v1/year_range
New in v1.1.0
  • 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
/api/v1/tire_dimensions
Stable
  • Get tire dimensions (width, aspect ratio, diameter) for a specific vehicle configuration. Essential for vehicle-based tire search applications.
GET
/api/v1/by_vehicle/{query}
Stable
  • Get vehicle data by query type: make, model, trim, or tiresize. Perfect for building cascading selection interfaces.
GET
/api/v1/by_size/{query}
Stable
  • Get tire size data including aspect ratios and diameters. Build tire size selection interfaces based on width filters.
GET
/api/v1/search_allyear
Stable
  • Get all available years in the tire database. Perfect for populating year dropdown menus. Highly cacheable.
GET
/api/v1/search_allwidth
Stable
  • Get all available tire widths from database. Use for tire size-based search interfaces. Highly cacheable.
GET
/api/v1/usage
Stable
  • Get your API usage statistics including daily limits and current usage counts. Does not count against rate limits.

๐Ÿ’ป Integration Examples

// 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"
Need Help?

Our support team is here to help

Chat with us