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	`2022 KTM 390 Adventure`	`2022 Honda Fury`

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://www.stormlakehonda.com/Pre-owned-Inventory-2024-Honda-Motorcycle-Scooter-ADV160-SP-Storm-Lake-Honda-16142449?ref=list`	`https://www.socalmotorcycles.com/Pre-owned-Inventory-2023-Ducati-Motorcycle-Scooter-Monster-Ducati-Red-Southern-California-Motorcycles-16340579?ref=list`

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	`3000`	`5000`

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	`13000`	`16000`

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	`1250`	`4000`

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`

Indicates the model year of the motorcycle, which typically refers to the manufacturer’s designation of the production year. The model year helps identify design updates, compliance with regulations, and resale value.

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`

Represents the manufacturer of the motorcycle. This indicates the brand responsible for producing the motorcycle and is useful for filtering, classification, and standardizing records across feeds.

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	`Ktm`	`Yamaha`

API Parameters

make - Filter by manufacturer name

See Also

model - Vehicle model information

`model`

Represents the specific designation of the motorcycle as defined by the manufacturer. The model provides more granular detail under the broader make/brand and is essential for identifying the exact variant.

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	`Sportster`	`Ninja 400`

API Parameters

model - Filter by vehicle model name

See Also

make - Manufacturer information
trim - Vehicle trim level details

`trim`

Represents the variant or sub-model designation of the motorcycle within the same model family. Trim may include additional identifiers such as engine displacement, special editions, or performance packages.

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	`Iron 883`	`CBR600RR`

API Parameters

trim - Filter by specific trim level

See Also

make - Manufacturer information
model - Vehicle model details

`category`

Represents the broad vehicle category of the motorcycle. It classifies motorcycles into predefined segments based on their style, purpose, or design. Examples include Cruiser, Sportbike, Touring, Adventure, Standard, Dirt Bike, Scooter, Dual-Sport, etc.

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	`cruiser`	`sportbike`

API Parameters

Not available as a search parameter

See Also

make - Manufacturer information
model - Vehicle model details

`vehicle_type`

Indicates the general type of vehicle. For motorcycles, this field is used to distinguish them from other vehicle types. The value will be “Motorcycle” for all motorcycle records.

Source: Scraped - Extracted from the source website.

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

API Parameters

Not available as a search parameter

See Also

make - Manufacturer information
model - Vehicle model details

`engine`

Represents the engine specification of the motorcycle. This field captures details such as engine displacement (in cc), cylinder configuration, and sometimes the engine family/series name. It helps distinguish between motorcycle trims and performance variants.

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	`649cc Parallel Twin`	`1254cc Boxer`

API Parameters

Not available as a search parameter

See Also

transmission - Transmission type
fuel_type - Fuel type information

`fuel_type`

Represents the primary fuel or energy source used by the motorcycle. This field helps differentiate between traditional petrol-powered motorcycles, electric bikes, and alternative fuel variants.

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`	`Electric`

API Parameters

Not available as a search parameter

See Also

engine - Engine information

`transmission`

Represents the gearbox type or transmission system of the motorcycle. Unlike cars, motorcycles typically use manual gear shifting with a clutch, but newer models also include semi-automatic or fully automatic transmissions.

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	`Semi-Automatic`	`Manual`

API Parameters

transmission - Filter by transmission type

See Also

drivetrain - Drive system configuration
engine - Engine specifications

`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`	`Midnight Black`

API Parameters

Not available as a search parameter

`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	`11042665`	`11042700`

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	`toledoharleydavidson.com`	`richmondhd.com`

API Parameters

source - Filter by specific source

See Also

mc_website_id (dealer_id) - Dealer 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	`Toledo-Harley-Davidson	`Richmond Harley-Davidson`

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	`NY`	`CA`

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`	`43551`

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

`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.

Overview

This document provides a comprehensive overview of MarketCheck’s heavy equipment inventory data collection across U.S. markets. It outlines our web crawling methodology, quality assurance processes to ensure data accuracy and consistency, and the various options available for accessing the data, including APIs and bulk feeds.