1. Home
  2. Wheel Size API - V2 vs V1

Comparison of API version 1 and API version 2

API v1

API v2
Wheel Size Data
The returning wheel fitment data is the same for both versions of the API
Market
Market - The global automotive market in which the same vehicle has some differences in wheel fitment params.

  • US domestic market (USDM) - key market
  • European domestic market (EUDM) - key market
  • Japanese domestic market (JDM)
  • Southeast Asian Market (SAM)
  • Australian Domestic Market (AUDM)
  • Latin American domestic market (LADM)
  • Middle East Domestic Market (MEDM)
  • Mexican domestic market (MXNDM)
  • South Korean Domestic Market (SKDM)
  • Canadian domestic market (CDM)
  • South African Domestic Market (SADM)
  • Chinese Domestic Market (CHDM)

If you have been unable to find the information on the requested market, try using the car’s details taken from the key markets.
Region
Region - The global automotive region in which the vehicle was officially sold or is currently being sold officially.

Please check this webpage for details

List of regions we cover:
  • USA+ (USDM)
  • Canada (CDM)
  • Mexico (MXNDM)
  • Central & South America (LADM)
  • Europe (EUDM)
  • Russia+ (RUS) -new
  • Japan (JDM)
  • China (CHDM)
  • South Korea (SKDM)
  • Southeast Asia (SAM)
  • Middle East (MEDM)
  • North Africa (NADM) -new
  • South Africa (SADM)
  • Oceania (AUDM)
Notes:
You can also check what countries are behind the name of region by checking this webpage or using /v2/regions/ API method. All endpoints excluding /v2/search/by_model/ support multiple regions filtering, example: &region=eudm&region=russia&region=jdm&...
Geo Filtering
/upsteps/ API method
Get all possible rim and tire combinations based on pre-fitted original equipment (OE) wheel specs.
Wheel Fitment Calculator is a great demo how you can use it and offer your customers safe replacement options based on factory sizes.
Note All unavailable options on the tire market are filtered out from result.
TiresVote.com API
TiresVote.com - The world's largest database of tire information: ratings, professional tire tests, bestseller lists. Summary of each tire model. See TiresVote.com OpenAPI Specification

  • /v2/tires/benchmarks/tests/ - Get list - Professional tire tests and rankings. See the list on the website
  • /v2/tires/benchmarks/charts/ - Get list - Third-party tire ratings, bestsellers and top lists. See the list on the website
  • /v2/tires/benchmarks/{benchmark_slug}/ - Detailed information for the test or top-chart. See the example on the website
  • /v2/tires/catalog/ - Tire brands catalog
  • /v2/tires/catalog/{brand}/ - Tires catalog for specific brand
  • /v2/tires/catalog/{brand}/{product}/ - General information of the tire
  • /v2/tires/catalog/{brand}/{product}/modes/ - Tire modifications. See the example on the website
  • /v2/tires/catalog/{brand}/{product}/bnb/ - Reasons to buy or not to buy the tire. See the example on the website
  • /v2/tires/catalog/{brand}/{product}/materials/ - Materials (videos, articles, links) related to the tire. See the example on the website
  • /v2/tires/search/ Search for tires by query
  • /v2/tires/search/advanced/ Search for tires using advanced filters
Improved performance
Meta information in responses
Using for SEO
See details how you can use Wheel Fitment API for SEO.
API methods inheritance /v1/makes/ =>
/v1/models/ =>
/v1/years/ =>
/v1/trims/ =>
/v1/generations/ =>
/v1/search/by_model/, /v1/vehicles/ =>
/v1/search/by_tire/ =>
/v1/search/by_rim/ =>

 /v2/makes/
/v2/models/
/v2/years/
/v2/modifications/
/v2/generations/
/v2/search/by_model/
/v2/by_tire/search/
/v2/by_rim/search/
/v2/regions/ - new

Deprecation notice

Wheel Fitment API version 1 is deprecated effective November 1, 2021

Wheel Size is deprecating all API's version 1 APIs to make way for more usable and maintainable alternatives in version 2. We heard from many of you that consistency was lacking with /v1/ of Wheel Fitment's API, and we're focusing on delivering a more consistent experience with this update. With more exciting changes to come, you can expect more thoughtful design and uniformity moving forward.
With that in mind, as of November 1, 2021 the Wheel Fitment version 1 API is deprecated, and in accordance with the our REST API policy, all version 1 APIs will be removed on July 1, 2023.

What will happen if I do nothing?

Since the /v1/ APIs were removed, any apps or services still using 1.0 resources will not work. If you rely on a script, integration, or app that makes requests using /v1/ resources, you'll need to update it to use a /v2/ alternative as soon as possible.

We Want Your Feedback

There are many improvements we plan on implementing in the near-term. We want you to tell us how we can make our RESTful API experience better - just email us, and we will get back to you as soon as possible.
Search by Vehicle

Demo #1 Detailed
Step-by-step wizard

makes models years modifications search by model tires or rims search tire info
Search by Vehicle

Demo #2
Form with 'Select' controls

makes years model modifications

Search by Vehicle

Demo #3
Wizard with car images and generations (year ranges)

makes models generations modifications search by model
Search by Rim

Demo #4
Find vehicles matching your criteria

complete the wheel description with a list of car models that fit this wheel
Search by Rim

Demo #5
Find vehicles by rim parameters

bolt patterns rim diameter rim width offset center bore
/upsteps/ API Method

Demo #6
Get Secure Wheel Replacement Options Derived from Factory Sizes

wheel calculator
Tiresvote API

Demo #7
Tire tests

tire rankings derived from evaluations conducted by independent and reputable bodies
Search by Vehicle

Demo #8
Wizard with Year as a starting parameter

years makes models modifications search by model ...
Classified methods

Demo #9

generate Product Card with Vehicle Compatibility for Package (Rim + Tire)
Classified methods

Demo #10
Search by Rim Size - (Aftermarket options)

generate Product Card with Vehicle Compatibility for Rim
OpenAPI specification

Wheel Configurator API

Wheel Configurator Demo #1

Basic scenario: Product Description Page (web page selling car rims)
Customers can test wheels on any vehicle by searching with year, make, model, body (optional), and color (optional). Users will then see a custom HQ image (1600px*900px) of the car fitted with the displayed rims on the page.

Wheel Configurator Demo #2

Basic scenario: Product Description Page (web page selling car rims)
Get list of vehicles that are compatible with the provided rim (using Wheel Fitment API). Provide instant wheel visualizer that allows to try rim for every vehicle of this list.
Extended version of Demo #1
Page Menu Navigation:
FAQs Configurator FAQs SEO / Data Parsing Technology Stack Terms of usage About Regions API Plans OpenAPI specification - API v2 OpenAPI specification - API v1, deprecated Get Your API Key Payment API Status Page API Latest Updates Comparison of API version 2 and API version 1
Specify settings
Regions

Note: the term “region” means a global automotive region in which the vehicle was officially sold or is currently being sold officially. Example: if you select the Middle East, the list of manufacturers, models will be provided only for this region, which are present in this region.

Choose regions, your search will be limited to these regions:
Clear Save
Note For /makes/, /models/, /generations/ , /years/ API methods you can pass multiple region values. But for /search/by_model/ the only region can be used in filters.