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	`291c8378b92a72b18b54c738ec447564-8a0698b8-0df8`	`291c8378b92a72b18b54c738ec447564-8a0698b8-0df8`

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	`2021 Airstream Classic 33FBQ`	`2022 Winnebago View 24J`

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.bayareaairstream.com/Pre-owned-Inventory-2017-Airstream-Trailer-International-Signature-25-International-Seattle-WA-16334978?ref=list`	`https://www.countrymotorhomes.com/Pre-owned-Inventory-2006-Country-Coach-Motorhome-Siskiyou-Summit-470-Allure-countrymotorhomes-15706210?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	`159500`	`49900`

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	`119900`	`549000`

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	`12150`	`9000`

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	`CM01A`	`BC5103`

API Parameters

stock_no - Filters listings by dealer stock number

See Also

vin - VIN information
vdp_url - VDP URL information

`year`

The manufacturer’s model year of the RV, as specified by the seller or source website. This represents the official model year designation, which may differ from the actual production year.

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

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`

The brand or manufacturer of the RV, as specified by the seller or source website. This identifies the company that produced the RV and is typically provided as part of the vehicle’s standard specifications.

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	`Winnebago`	`Jayco`

API Parameters

make - Filter by manufacturer name

See Also

model - Vehicle model information

`model`

The specific product name or designation of the RV as assigned by the manufacturer. The model helps distinguish different products within the same make and is typically listed by the seller or source website.

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	`Rockwood Ultra Lite`	`Jay Flight`

API Parameters

model - Filter by vehicle model name

See Also

make - Manufacturer information
trim - Vehicle trim level details

`trim`

The specific variant or sub-model of the RV that denotes a particular configuration, equipment package, or styling option offered by the manufacturer. It typically indicates differences in features, finishes, and amenities within the same model line.

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	`Limited`	`Elite`

API Parameters

trim - Filter by specific trim level

See Also

make - Manufacturer information
model - Vehicle model details

`class`

Specifies the category or type of the RV based on its build and intended use, such as Class A, Class B, Class C, Travel Trailer, Fifth Wheel, or Toy Hauler. This classification helps identify the RV’s general size, shape, and functional characteristics.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`class`	`build[].class`
Type	`string`	`string`
Format	Variable, typically 3-16 characters	Variable, typically 3-16 characters
Sample	`Class B`	`Toy Hauler`

API Parameters

class - Filters listings by RV class type

See Also

make - Manufacturer information
model - Vehicle model details

`slideouts`

Indicates the number of slide-out sections in the RV. Slide-outs are extendable portions of the vehicle's living space that can be expanded when parked to provide additional interior room.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`slideouts`	`build[].slideouts`
Type	`integer`	`integer`
Format	Positive integer values	Positive integer values
Sample	`1`	`4`

API Parameters

slideouts - Filters listings by the number of slideouts

See Also

class - Class information

`sleeps`

Indicates the maximum number of people that the vehicle is designed to accommodate for sleeping. This value is typically specified by the manufacturer and may vary based on floorplan or optional configurations.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`sleeps`	`build[].sleeps`
Type	`integer`	`integer`
Format	Positive integer values	Positive integer values
Sample	`2`	`4`

API Parameters

sleeps - Filters listings by the number of sleeping areas

See Also

class - Class information

`gvwr`

Stands for Gross Vehicle Weight Rating. It represents the maximum total safe weight of the RV, including the vehicle itself, passengers, cargo, fluids, and any additional equipment. Exceeding this rating may compromise safety and vehicle performance.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`gvwr`	`build[].gvwr`
Type	`integer`	`integer`
Format	Positive integer values	Positive integer values
Sample	`7500`	`18000`

API Parameters

gvwr - Filters listings by Gross Vehicle Weight Rating

See Also

length - Length information

`length`

Indicates the overall exterior length of the RV, typically measured from the front to the rear bumper. This dimension helps determine maneuverability, parking requirements, and space utilization.

Source: Scraped - Extracted from the source website.

Attribute	Data Feed	API
Name	`length`	`build[].length`
Type	`integer`	`integer`
Format	Decimal or whole number values	Decimal or whole number values
Sample	`32.5`	`27.8`

API Parameters

length - Filters listings by vehicle length in inches.

See Also

gvwr - GVWR specifications

`engine`

Provides details about the RV’s engine. This may include engine displacement, fuel type, number of cylinders, horsepower, and other specifications depending on availability. Primarily applies to motorhomes rather than towable RVs.

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	`2.5L 4-Cylinder`	`3.5L V6 Turbo`

API Parameters

engine - Filters listings by engine designation

See Also

transmission - Transmission type
fuel_type - Fuel type information

`fuel_type`

Indicates the type of fuel the RV uses to power its engine. Common fuel types include gasoline, diesel, and electric. This attribute is primarily applicable to motorhomes and tow vehicles.

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	`Gasoline`	`Diesel`

API Parameters

fuel_type - Filters listings by fuel type

See Also

engine - Engine information

`transmission`

Describes the type of gearbox system used in the vehicle, which controls how power is transferred from the engine to the wheels. Transmission type directly impacts performance, driving experience, and fuel efficiency.

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

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`	`Ivory Leather`

API Parameters

interior_color - Filters listings by interior color

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

API Parameters

exterior_color - Filters listings by exterior color

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	`11037533`	`11037064`

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	`funtownrvmi.com`	`archerrv.com`

API Parameters

source - Filter by specific source

See Also

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	`Archer RV`	`Fun Town Rv`

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

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

`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	`we have for sale a lovely 2009 mini one hatch in red. 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

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