Data Definitions

Detailed definitions of all fields in the MarketCheck Inventory dataset

This guide provides detailed definitions of all fields in the MarketCheck Inventory dataset. Understanding these fields is essential for developers and analysts to effectively use our inventory data feeds and APIs.

Field Definitions

`id`

Unique identifier assigned to each listing. This field ensures that every listing is distinctly identified across the entire feed. The identifier is generated as an MD5 hash of the VDP (Vehicle Details Page) URL, providing both uniqueness and consistency throughout the feed.

Source: Generated - MD5 hash of the VDP URL.

Attribute	Data Feed	API
Name	`id`	`id`
Type	`string`	`string`
Format	64 characters	64 characters
Sample	`f82b04c877b4cc338d5beadb3115d350-594d8e54-40ec`	`cd4922d37eaaee6e01fca5a2a8e16d76-5c7914d2-be73`

API Parameters

Not available as a search parameter

See Also

vin - VIN information

`vin`

The Vehicle Identification Number (VIN) is a unique 17-character alphanumeric code assigned to every vehicle by the manufacturer. It serves as the vehicle's fingerprint and encodes key details such as the make, model, year, engine type, manufacturing plant, and serial number.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`vin`	`vin`
Type	`string`	`string`
Format	17 characters	17 characters
Sample	`JTEBU14R760085015`	`WBA83GG06T7T68443`

API Parameters

vin - Filter by specific vin listings

See Also

id - Listing identifier

`heading`

Represents the heading or display name of a vehicle listing as shown on the source website. It is typically a short, human-readable string combining key details such as year, make, model, and trim. The vehicle_title is useful for quickly identifying and displaying vehicle listings in search results or feeds.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`heading`	`heading`
Type	`string`	`string`
Format	Variable, typically 256 characters	Variable, typically 256 characters
Sample	`2016 Kenworth T440`	`2006 Sterling ACTERRA`

API Parameters

Not available as a search parameter

See Also

make - Manufacturer information
model - Vehicle model details
year - Vehicle year details

`dp_url`

The URL of the Vehicle Details Page (VDP) on the source website where the vehicle listing is published. This page typically contains comprehensive information about the vehicle, including photos, specifications, pricing, seller details, and contact information. The vdp_url allows direct access to the original listing for reference or validation purposes.

Source: Generated - Extracted from the source website.

Attribute	Data Feed	API
Name	`dp_url`	`vdp_url`
Type	`string`	`string`
Format	Variable, typically 1024 characters	Variable, typically 1024 characters
Sample	`https://woodequipmentinc.com/case-ih-1255-planter/`	`http://www.crysteeltruck.com/proddetail_estore.asp?partnum=999-02937`

API Parameters

Not available as a search parameter

`price`

The listed price of the vehicle as displayed on the source website. This value represents the sale price, which may include or exclude additional fees such as taxes, registration, or dealer charges. The price is typically presented in the currency relevant to the region of the source website.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`price`	`price`
Type	`integer`	`integer`
Format	Positive integer values	Positive integer values.
Sample	`50500`	`65000`

API Parameters

price - Sort listings by price
price_range - Filter listings based on price ranges

See Also

msrp - Manufacturer’s Suggested Retail Price information.

`msrp`

The Manufacturer’s Suggested Retail Price (MSRP) is the price recommended by the vehicle’s manufacturer for retail sale. This value reflects the base price of the vehicle without dealer-added options, taxes, registration fees, or discounts. It is used as a reference to compare against the listed sale price and evaluate potential savings or markups.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`msrp`	`msrp`
Type	`integer`	`integer`
Format	Positive integer values	Positive integer values
Sample	`130000`	`165000`

API Parameters

msrp - Sort listings by msrp
msrp_range - Filter listings based on msrp ranges

See Also

price - Listed sale price information.
trim - Trim information.

`miles`

Indicates the total distance the vehicle has been driven, as reported on the source website. This value represents the vehicle's odometer reading and is a key indicator of wear, usage, and overall condition. It is especially important for used vehicles and is often a major factor in pricing and buyer decision-making.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`miles`	`miles`
Type	`integer`	`integer`
Format	Positive integer values	Positive integer values
Sample	`5250`	`6000`

API Parameters

miles - Sort listings by miles
miles_range - Filter listings based on miles ranges

See Also

price - Price information

`stock_no`

The stock number is a unique identifier assigned by the dealership to track and manage a specific vehicle in their inventory system. It is used internally for inventory control and often appears on vehicle listings, window stickers, and sales documents.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`stock_no`	`stock_no`
Type	`string`	`string`
Format	Variable, typically 3-20 characters	Variable, typically 3-20 characters
Sample	`BM01D`	`C5103`

API Parameters

stock_no - Filters listings by dealer stock number

See Also

vin - VIN information
vdp_url - VDP URL information

`year`

Represents the model year of the heavy equipment as designated by the manufacturer. The model year indicates the manufacturing or release year and helps determine depreciation, resale value, and compliance with industry standards.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`year`	`build[].year`
Type	`integer`	`integer`
Format	4-digit number	4-digit number
Sample	`2024`	`2020`

API Parameters

year - Filter by specific model year
year_range - Filter by year range (e.g., "2023-2025")

See Also

make - Manufacturer information
model - Vehicle model details

`make`

Indicates the manufacturer or brand of the heavy equipment. The make helps identify the company that designed, built, or marketed the equipment, and it is essential for valuation, compatibility, and market analysis.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`make`	`build[].make`
Type	`string`	`string`
Format	Variable, typically 3-16 characters	Variable, typically 3-16 characters
Sample	`Caterpillar`	`John Deere`

API Parameters

make - Filter by manufacturer name

See Also

model - Vehicle model information

`model`

Specifies the model designation of the heavy equipment as assigned by the manufacturer. The model provides details on the equipment’s series, configuration, or generation, and is critical for distinguishing between variations within the same make.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`model`	`build[].model`
Type	`string`	`string`
Format	Variable, typically 3-64 characters	Variable, typically 3-64 characters
Sample	`D8T`	`944K`

API Parameters

model - Filter by vehicle model name

See Also

make - Manufacturer information
trim - Vehicle trim level details

`trim`

Specifies the variant, configuration, or additional designation of the heavy equipment model as defined by the manufacturer. While not always available for heavy equipment, the trim field may capture special editions, package codes, or equipment-specific identifiers.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`trim`	`build[].trim`
Type	`string`	`string`
Format	Variable, typically 2-64 characters	Variable, typically 2-64 characters
Sample	`XL`	`Premium`

API Parameters

trim - Filter by specific trim level

See Also

make - Manufacturer information
model - Vehicle model details

`category`

Specifies the type/classification of heavy equipment. This field identifies the primary use case or equipment family (e.g., excavator, loader, bulldozer) to help with segmentation, filtering, and search.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`category`	`build[].category`
Type	`string`	`string`
Format	Variable, typically 3-16 characters	Variable, typically 3-16 characters
Sample	`Excavator`	`Backhoe`

API Parameters

Not available as a search parameter

See Also

make - Manufacturer information
model - Vehicle model details

`sub_category`

Specifies the detailed classification of heavy equipment within a broader category. This field provides granularity by identifying specific variants, use-cases, or configurations under each equipment type.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`sub_category`	`build[].sub_category`
Type	`string`	`string`
Format	Variable, typically 3-16 characters	Variable, typically 3-16 characters
Sample	`Mini Excavator`	`Track Loader`

API Parameters

Not available as a search parameter

See Also

make - Manufacturer information
model - Vehicle model details

`engine`

Specifies the engine details of the heavy equipment, including displacement, horsepower, cylinder configuration, or model code as provided by the manufacturer or listing source.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`engine`	`build[].engine`
Type	`string`	`string`
Format	Variable, typically 10-40 characters	Variable, typically 10-40 characters
Sample	`CAT C7 ACERT 7.2L`	`Cummins QSX15 565 HP`

API Parameters

Not available as a search parameter

See Also

transmission - Transmission type
fuel_type - Fuel type information

`fuel_type`

Specifies the type of fuel that powers the heavy equipment’s engine. This attribute indicates whether the machine runs on diesel, gasoline, electric, hybrid, or other fuel types.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`fuel_type`	`build[].fuel_type`
Type	`string`	`string`
Format	Variable, typically 3-64 characters	Variable, typically 3-64 characters
Sample	`Petrol`	`Diesel`

API Parameters

Not available as a search parameter

See Also

engine - Engine information

`transmission`

Specifies the type of transmission system used in the heavy equipment. This determines how engine power is delivered to the drivetrain and affects performance, fuel efficiency, and operator control.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`transmission`	`build[].transmission`
Type	`string`	`string`
Format	Variable, typically 6-15 characters	Variable, typically 6-15 characters
Sample	`Automatic`	`Manual`

API Parameters

transmission - Filter by transmission type

See Also

drivetrain - Drive system configuration
engine - Engine specifications

`interior_color`

Represents the color of the vehicle's interior, as listed on the source website.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`interior_color`	`interior_color`
Type	`string`	`string`
Format	Variable, typically 4-64 characters	Variable, typically 4-64 characters
Sample	`Black`	`Gray`

API Parameters

Not available as a search parameter

See Also

exterior_color - Exterior color information

`exterior_color`

Represents the color of the vehicle's exterior, as listed on the source website.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`exterior_color`	`exterior_color`
Type	`string`	`string`
Format	Variable, typically 4-64 characters	Variable, typically 4-64 characters
Sample	`White`	`Black`

API Parameters

Not available as a search parameter

See Also

interior_color - Interior color information

`status_date`

Indicates the date and time when MarketCheck last verified the inventory on the source website. This field is updated daily during crawling operations to confirm the continued availability of the listing.

Source: Generated - Updated automatically during daily crawling operations (set to current date when inventory is found during crawl)

Attribute	Data Feed	API
Name	`status_date`	`status_date`
Type	`string` (ISO 8601 format)	`string` (ISO 8601 format)
Format	ISO-8601 datetime string (YYYY-MM-DDThh:mm:ssZ)	ISO-8601 datetime string (YYYY-MM-DDThh:mm:ssZ)
Sample	`2024-04-15T14:30:00Z`	`2024-01-15T14:30:00Z`

API Parameters

status_date_range - Filter by last verification date range

See Also

scraped_at_date - Initial discovery date
Listing Lifecycle

`scraped_at_date`

The date and time when the listing was scraped from the source website. This value reflects the most recent verification time for the listing. If the source website has not made any changes to the listing’s price or miles in subsequent scraping cycles, this timestamp is retained and not updated.

Source: Generated - Set during initial inventory scraped (date of first successful crawl capturing the inventory)

Attribute	Data Feed	API
Name	`scraped_at_date`	`scraped_at_date`
Type	`string` (ISO 8601 format)	`string` (ISO 8601 format)
Format	ISO-8601 datetime string (YYYY-MM-DDThh:mm:ssZ)	ISO-8601 datetime string (YYYY-MM-DDThh:mm:ssZ)
Sample	`2024-02-01T09:15:00Z`	`2024-01-01T09:15:00Z`

API Parameters

scraped_at_date_range - Filter by initial discovery date range

See Also

status_date - Last verification date
Listing Lifecycle

`dealer_id`

A unique MarketCheck-assigned identifier representing a specific source website (domain) from which vehicle listings are collected. This field allows users to distinguish listings based on their origin — helping in filtering, analysis, and source-level validation.

Source: Derived – Mapped using dealership management process.

Attribute	Data Feed	API
Name	`dealer_id`	`dealer_id`
Type	`integer`	`integer`
Format	Positive integer values	Positive integer values
Sample	`1008611`	`1088721`

API Parameters

dealer_id - Filter by specific mc_website_id

See Also

source - Source website information

`source`

The name of the source website from which the vehicle listing was scraped. This identifies the origin of the listing and is used to track data provenance.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`source`	`source`
Type	`string`	`string`
Format	Variable, typically 5-64 characters	Variable, typically 5-64 characters
Sample	`lithia.com`	`carmax.com`

API Parameters

source - Filter by specific source

See Also

mc_website_id - Website id information

`seller_name`

The name of the dealership or seller, as displayed on the source website.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`seller_name`	`seller_name`
Type	`string`	`string`
Format	Variable, typically 4-128 characters	Variable, typically 4-128 characters
Sample	`Alfa Autos`	`BMW of Austin`

API Parameters

Not available as a search parameter

See Also

source - Source website information

`street`

The street address of the dealership or seller location where the vehicle is listed. This is typically the first line of the full address and may include a number, street name, and any directional or unit information.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`street`	`street`
Type	`string`	`string`
Format	Variable, typically 4-128 characters	Variable, typically 4-128 characters
Sample	`123 Main Street`	`544 Lindon Park Drive`

API Parameters

Not available as a search parameter

See Also

city - City information

`city`

The city in which the dealership or seller is located. This value is part of the full address and typically appears along with street, state, and zip fields.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`city`	`city`
Type	`string`	`string`
Format	Variable, typically 4-32 characters	Variable, typically 4-32 characters
Sample	`Los Angeles`	`San Jose`

API Parameters

city - Filter by specific city

See Also

state - State information

`state`

The state or province where the dealership or vehicle seller is located. This is a part of the full address and is typically represented by its two-letter abbreviation in the U.S. and Canada.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`state`	`state`
Type	`string`	`string`
Format	Variable, typically 4-32 characters	Variable, typically 4-32 characters
Sample	`Los Angeles`	`San Jose`

API Parameters

city - Filter by specific city

See Also

city - City information

`zip`

The ZIP or postal code associated with the dealership's address.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`zip`	`zip`
Type	`string`	`string`
Format	Variable, typically 5-9 characters	Variable, typically 5-9 characters
Sample	`90210`	`SW1A 1AA`

API Parameters

zip - Filter by specific zip codes

See Also

state - State information

`seller_type`

Indicates who is selling the vehicle — whether it's a dealership, private individual, or auction.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`seller_type`	`seller_type`
Type	`string`	`string`
Format	Variable, typically 4-7 characters	Variable, typically 4-7 characters
Sample	`dealer`	`dealer`

API Parameters

Not available as a search parameter

See Also

source - Source website information

`inventory_type`

Indicates whether the vehicle is part of a new or used inventory, based on how it is listed on the source website.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`inventory_type`	`car_type`
Type	`string`	`string`
Format	Variable, typically 4-7 characters	Variable, typically 4-7 characters
Sample	`used`	`new`

API Parameters

inventory_type - Filter by specific inventory_type

See Also

seller_type - Seller type information

`options`

A pipe-separated list of installed options scraped from the Vehicle Details Page (VDP) of the source website.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed
Name	`options`
Type	`string`
Format	variable
Sample	`ABS\|Air Conditioning\|Alloy Wheels\|CD Player\|Central Locking`

API Parameters

Not available as a search parameter

See Also

vdp_url - VDP URL information

`features`

A pipe-separated list of features scraped from the Vehicle Details Page (VDP) of the source website.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed
Name	`features`
Type	`string`
Format	variable
Sample	`Front head restraints\| Front storage compartment in centre console and in door trim\| Front/rear courtesy lights with soft on/off dimming`

API Parameters

Not available as a search parameter

See Also

vdp_url - VDP URL information

`seller_comments`

Textual comments or descriptions provided by the seller or dealership about the vehicle, as listed on the Vehicle Details Page (VDP) of the source website.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed
Name	`seller_comments`
Type	`string`
Format	variable
Sample	`It is the small 1.4L petrol engine which is great for new or first drivers as they are cheap to insure and very economical.`

API Parameters

Not available as a search parameter

See Also

vdp_url - VDP URL information

`photo_url`

The main photo URL found on the Vehicle Details Page (VDP) of the car on the source website.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed
Name	`photo_url`
Type	`string`
Format	variable
Sample	`https://pictures.dealer.com/p/piazzahondaread/0514/20567771cf27f57e48fbc060385d00d5x.jpg`

API Parameters

Not available as a search parameter

See Also

vdp_url - VDP URL information

`photo_links`

A pipe-separated list of photo URLs of the vehicle, as found on the Vehicle Details Page (VDP) of the car on the source website.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed
Name	`photo_links`
Type	`string`
Format	variable
Sample	`https://pictures.dealer.com/p/piazzahondaread/0514/20567771cf27f57e48fbc060385d00d5x.jpg\|https://pictures.dealer.com/p/piazzahondaread/0303/9085aba54389bc0657d11cc042f135acx.jpg`

API Parameters

Not available as a search parameter

See Also

vdp_url - VDP URL information

Listing Lifecycle

Understanding the lifecycle of inventory records from creation to expiration.

Introduction

Learn about a VIN decoder, NeoVIN, it's features and capabilities.