Automotive Tire Listings

This documentation provides detailed information about the Automotive Tire Listings API. This endpoint allows you to query tire listings. You can filter tire listings based on various parameters to retrieve the exact data you need.

tires_listing Model

The tire listing model represents the structure of tire data. It contains all relevant information such as retailer details, tire specifications, pricing, availability, and more.

Properties

Name
inventory_product_detail_history_id
Type
bigint
Description
Unique identifier for the tire listing.
Name
retailer_key
Type
string
Description
Identifier for the retailer associated with the tire listing.
Name
dma_code
Type
string
Description
Designated Market Area (DMA) code.
Name
last_extracted
Type
date
Description
Date when the tire listing was last extracted or updated.
Name
brand
Type
string
Description
Brand of the tire.
Name
store_num
Type
string
Description
Store number where the tire is available.
Name
tire_size
Type
string
Description
Size specification of the tire.
Name
manufacturer_product_number
Type
string
Description
Manufacturer's product number.
Name
model
Type
string
Description
Model name of the tire.
Name
rim_diameter
Type
decimal
Description
Diameter of the tire rim.
Name
aspect_ratio
Type
decimal
Description
Aspect ratio of the tire.
Name
width
Type
decimal
Description
Width of the tire.
Name
price
Type
string
Description
Price of the tire.
Name
availability
Type
string
Description
Availability status of the tire.
Name
latitude
Type
decimal
Description
Latitude of the store location.
Name
longitude
Type
decimal
Description
Longitude of the store location.
Name
zip_code
Type
string
Description
ZIP code of the store location.
Name
state
Type
string
Description
State where the store is located.
Name
product_url
Type
string
Description
URL to the product page.

GET/v1/tires_listing

tires_listing

This endpoint retrieves a list of tire listings. You can filter the results using query parameters to narrow down the data.

Query Parameters

Name
retailer_key
Type
string
Description
Filter by retailer key.
Name
dma_code
Type
string
Description
Filter by DMA code.
Name
last_extracted
Type
date
Description
Filter listings updated since this date.
Name
brand
Type
string
Description
Filter by tire brand.
Name
store_num
Type
string
Description
Filter by store number.
Name
tire_size
Type
string
Description
Filter by tire size.
Name
limit
Type
integer
Description
Number of records to return per page (default is 10).
Name
offset
Type
integer
Description
Number of records to skip for pagination.

Request

GET

/v1/tires_listing

curl -G https://api.411data.io/v1/tires_listing \
  -H "Authorization: Bearer {token}" \
  --data-urlencode "retailer_key=retailer123" \
  --data-urlencode "dma_code=DMA001" \
  --data-urlencode "last_extracted=2023-01-01" \
  --data-urlencode "brand=Michelin" \
  --data-urlencode "store_num=100" \
  --data-urlencode "tire_size=225/50R17" \
  --data-urlencode "limit=10" \
  --data-urlencode "offset=0"

Response

{
  "has_more": false,
  "data": [
  {
    "store_num": "1261",
    "retailer_key": "MIDAS",
    "dma_code": "862",
    "manufacturer_product_number": "RSX07",
    "model": "4XS",
    "brand": "Sceptor",
    "tire_size": "235/60R17",
    "rim_diameter": 17.00,
    "aspect_ratio": 60.00,
    "width": 235.00,
    "zip_code": "95212",
    "state": "CA",
    "sku": "9912",
    "single_price": "117.99",
    "last_extracted": "2024-11-26",
    "last_extracted_time": "2024-11-26",
    "promo_json": "[]",
    "promo": null,
    "product_url": "https://www.midas.com/store/ca/stockton/7730-holman-rd-95212/tires/tire-details/sceptor-sceptor-4xs-tbc-rsx07?shopnum=1261&v=generic"
  },
  {
    "store_num": "5254",
    "retailer_key": "MIDAS",
    "dma_code": "546",
    "manufacturer_product_number": "03206301",
    "model": "Custom Built Radial VIII",
    "brand": "Vogue",
    "tire_size": "245/45R19",
    "rim_diameter": 19.00,
    "aspect_ratio": 45.00,
    "width": 245.00,
    "zip_code": "29201",
    "state": "SC",
    "sku": "15797",
    "single_price": "393.99",
    "last_extracted": "2024-11-26",
    "last_extracted_time": "2024-11-26",
    "promo_json": "[]",
    "promo": null,
    "product_url": "https://www.midas.com/store/sc/columbia/1517-gervais-st-29201/tires/tire-details/vogue-custom-built-radial-vogu-03206301?shopnum=5254&v=lookup"
  }

    // ... additional tire listings
  ]
}