API DOCUMENTATION

How can we help?

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

🚀 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"

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.

⚙️
Product Core

Detailed documentation with expanded examples for comprehensive API exploration and integration guides.

👤
API Dashboard

Simplified view for quick endpoint lookup and API reference. Perfect for experienced developers.

Customization Tips

Advanced integration patterns, best practices, and optimization tips for production applications.

👥
Target Advertising

Learn how to leverage tire data for targeted automotive advertising and personalized user experiences.

🔗
Integrations

Machine-readable OpenAPI specs for code generation and testing tools like Postman or Insomnia.

🔗 API Endpoints

GET
/api/v1/tire_dimensions
High Impact

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}
Medium Impact

Get vehicle data by query type: make, model, trim, or tiresize. Perfect for building cascading selection interfaces.

GET
/api/v1/by_size/{query}
Medium Impact

Get tire size data including aspect ratios and diameters. Build tire size selection interfaces based on width filters.

GET
/api/v1/search_allyear
Low Impact

Get all available years in the tire database. Perfect for populating year dropdown menus. Highly cacheable.

GET
/api/v1/search_allwidth
Low Impact

Get all available tire widths from database. Use for tire size-based search interfaces. Highly cacheable.

GET
/api/v1/usage
No Impact

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"

# Get all available makes
curl -H "x-api-key: your-api-key-here" \
  "/api/v1/by_vehicle/make"

# Check your API usage
curl -H "x-api-key: your-api-key-here" \
  "/api/v1/usage"
Need Help?

Our support team is here to help

Get assistance with integration, troubleshooting, or technical questions about the Tire API.

📞 Contact Information

Email Support:
support@vdimtech.com
API Portal:
tire.vdim.app
API Status:
System Status