Data Definitions

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 composed of the vehicle’s VIN and a UUID (Universally Unique Identifier), providing both uniqueness and consistency throughout the feed.

Source: Generated - Combination of the vehicle’s VIN and a UUID.

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.

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.

API Parameters

Not available as a search parameter

See Also

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

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

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.

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.

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.

API Parameters

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

See Also

• price - Price information
• dom - Days on Market 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.

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 vehicle, as designated by the manufacturer. The model year reflects the version or release cycle of the vehicle and may differ from the actual production date. It is essential for identifying vehicle generation, design updates, features, and compliance with regulatory standards.

Source: Enriched - Derived from the VIN using the decoder.

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

Specifies the manufacturer or brand of the vehicle. The make represents the company that produces the vehicle and is often the first element in identifying a car. This field is essential for categorizing and filtering vehicle listings.

Source: Enriched - Derived from the VIN using the decoder.

API Parameters

• make - Filter by manufacturer name

See Also

• model - Vehicle model information

model

Indicates the specific product line or series of a vehicle produced by a manufacturer (make). The model differentiates vehicles within a brand and typically reflects design, size, and intended use. It is used in combination with the make to uniquely identify a vehicle offering.

Source: Enriched - Derived from the VIN using the decoder.

API Parameters

• model - Filter by vehicle model name

See Also

• make - Manufacturer information
• trim - Vehicle trim level details

trim

Specifies the variant or configuration level of a particular vehicle model, often indicating different sets of features, equipment, styling, or performance options. The trim helps differentiate versions of the same model by offering varying levels of luxury, technology, and functionality.

Source: Enriched - Derived from the VIN using the decoder.

API Parameters

• trim - Filter by specific trim level

See Also

• make - Manufacturer information
• model - Vehicle model details

vehicle_type

Defines the general classification or category of the vehicle based on its design, structure, and intended use. The vehicle_type helps group vehicles into recognizable segments for consumers and is commonly used for filtering, comparison, and analytics.

Source: Enriched - Derived from the VIN using the decoder.

API Parameters

• vehicle_type - Filter by specific vehicle_type level

See Also

• make - Manufacturer information
• model - Vehicle model details

body_type

Describes the physical structure and exterior shape of the vehicle, typically reflecting its size, number of doors, roofline, and cargo area design. The body_type is more specific than vehicle_type and helps define the vehicle's intended functionality and style.

Source: Enriched - Derived from the VIN using the decoder.

API Parameters

• body_type - Filter by specific body_type level

See Also

• make - Manufacturer information
• model - Vehicle model details

drivetrain

Specifies the drive system configuration of a vehicle, indicating how power from the engine or motor is transmitted to the wheels. The drivetrain affects performance, traction, fuel efficiency, and handling, making it an important attribute for vehicle classification and comparison.

Source: Enriched - Derived from the VIN using the decoder.

API Parameters

• drivetrain - Filter by drivetrain type

See Also

• transmission - Transmission type
• engine - Engine specifications

transmission

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

Source: Enriched - Derived from the VIN using the decoder.

API Parameters

• transmission - Filter by transmission type

See Also

• drivetrain - Drive system configuration
• engine - Engine specifications

engine

Describes the engine type and specifications of the vehicle, often including displacement, configuration, and sometimes fuel type or number of cylinders. The engine field helps identify performance characteristics such as power output, efficiency, and suitability for different driving needs.

Source: Enriched - Derived from the VIN using the decoder.

API Parameters

• engine - Filter by engine specifications

See Also

• drivetrain - Drive system configuration
• transmission - Transmission type
• fuel_type - Fuel type information

engine_block

The configuration of the engine's cylinder arrangement in the engine block. It refers to how the cylinders are positioned relative to each other in the engine.

Source: Enriched - Derived from the VIN using the decoder.

API Parameters

Not available as a search parameter

See Also

• engine - Engine information
• fuel_type - Fuel type information

engine_size

The displacement of the engine, typically measured in liters (L), representing the total volume of all engine cylinders. Engine size often correlates with engine power and fuel efficiency.

Source: Enriched - Derived from the VIN using the decoder.

API Parameters

Not available as a search parameter

See Also

• engine - Engine information
• fuel_type - Fuel type information

fuel_type

Indicates the type of fuel or energy source the vehicle uses to power its engine. The fuel_type affects vehicle performance, emissions, range, and operating cost. It is a key field for consumers evaluating environmental impact and fuel efficiency.

Source: Enriched - Derived from the VIN using the decoder.

API Parameters

• fuel_type - Filter by fuel type

See Also

• engine - Engine information

door

The number of doors on the vehicle, typically including front and rear passenger doors, and sometimes the hatch or tailgate in hatchbacks and SUVs.

Source: Enriched - Derived from the VIN using the decoder.

API Parameters

Not available as a search parameter

See Also

• body_type - Body type information

cylinders

Indicates the number of cylinders in the vehicle's engine. This value directly relates to engine performance, fuel efficiency, and vehicle classification.

Source: Enriched - Derived from the VIN using the decoder.

API Parameters

Not available as a search parameter

See Also

• engine - Engine information

city_mpg

Represents the estimated fuel efficiency of the vehicle in miles per gallon (MPG) during city driving conditions, as determined by regulatory agencies.

Source: Enriched - Derived from the VIN using the decoder.

API Parameters

• city_mpg - Sort listings by city mileage

See Also

• highway_mpg - For fuel efficiency on highways

highway_mpg

Represents the estimated fuel efficiency of the vehicle in miles per gallon (MPG) under highway driving conditions.

Source: Enriched - Derived from the VIN using the decoder.

API Parameters

• highway_mpg - Sort listings by highway mileage

See Also

• city_mpg - For fuel efficiency on city

interior_color

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

Source: Scraped - Extracted from the source website.

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.

API Parameters

Not available as a search parameter

See Also

• interior_color - Interior color information

base_exterior_color

Represents the standardized or normalized exterior color of the vehicle. Unlike exterior_color, which may include marketing or detailed color names (e.g., "Midnight Metallic Blue"), base_exterior_color simplifies these into broad categories (e.g., "Blue") for filtering and analysis.

Source: Generated – Derived by normalizing the raw exterior_color values using predefined color mapping logic.

API Parameters

• base_ext_color - Filter by specific base_exterior_color

See Also

• base_interior_color - Base interior color information

base_interior_color

Represents the standardized or normalized version of the vehicle’s interior color. While the interior_color field contains the original description as scraped from the source website (e.g., "Charcoal Leather" or "Beige with Wood Trim"), the base_interior_color simplifies it into a broad, consistent color category such as "Black", "Gray", "Beige", etc.

Source: Scraped - Extracted from the source website.

API Parameters

• base_int_color - Filter by specific base_ext_color level

See Also

• base_exterior_color - Base exterior 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)

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)

API Parameters

• scraped_at_date_range - Filter by initial discovery date range

See Also

• status_date - Last verification date
• Listing Lifecycle

dom

Indicates the total number of days a vehicle has been listed online, across all its appearances, considering overlapping periods only once.

Source: Derived – Computed internally from MarketCheck’s historical listing activity by aggregating and de-duplicating date ranges across all listings for the same VIN.

API Parameters

• dom - Sort listings by DOM lifetime

See Also

• dom_active - dom_active information
• DOM-DOS-Fields

dom_active

The Days on Market (DOM) value for a car (or VIN) based on the most recent active listing period, excluding any gaps of 30 days or more. It reflects the duration the car has been continuously listed online without being delisted for an extended time.

Source: Derived – Calculated from the listing timeline by identifying the most recent uninterrupted online presence (no 30+ day gap).

API Parameters

• dom - Sort listings by DOM Active

See Also

• dom - DOM lifetime information
• DOM-DOS-Fields

dos_active

Days On Site (DOS) represents the number of consecutive days a dealer has had a specific VIN listed on a particular website, without a break of 30 days or more in the listing activity. This reflects the current uninterrupted period the vehicle has remained visible on the site.

Source: Derived – Calculated from the listing timeline by identifying the most recent uninterrupted online presence (no 30+ day gap).

API Parameters

• dos_active - Sort listings by DOM Active

See Also

• dom_active - dom_active information
• DOM-DOS-Fields

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.

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.

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.

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.

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.

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.

API Parameters

• zip - Filter by specific zip codes

See Also

• state - State information

country

The country where the vehicle or dealership is physically located.

Source: Scraped - Extracted from the source website.

API Parameters

• country - Filter by specific country

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.

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.

API Parameters

• inventory_type - Filter by specific inventory_type

See Also

• seller_type - Seller type information

dealer_type

Represents the classification of the dealership based on its business affiliation.

Source: Derived – Determined based on dealership’s brand associations, and/or known affiliations.

API Parameters

Not available as a search parameter

See Also

• seller_type - Seller type information

mc_category

The mc_category field classifies a dealership entity based on its business type, organizational role, or hierarchical level within the dealership ecosystem. This field helps differentiate between individual dealers, dealership groups, sub-groups, retailers, and data aggregators.

Source: Derived – Mapped using dealership management process.

API Parameters

Not available as a search parameter

See Also

• source - Source website information
• Dealership-Management

mc_dealership_group_id

The mc_dealership_group_id is a unique identifier assigned to a dealership group in the MarketCheck system. Dealership groups consist of multiple dealership rooftops that operate under a single corporate ownership or brand umbrella. This ID allows you to track and associate individual dealers with their parent dealership group.

Source: Derived – Mapped using dealership management process.

API Parameters

Not available as a search parameter

See Also

• mc_dealership_group_name - Dealership group name information
• Dealership-Management

mc_dealership_group_name

The mc_dealership_group_name is the name of the dealership group to which a dealer belongs, as identified and maintained by MarketCheck. Dealership groups are organizations that own or manage multiple dealerships under one corporate or brand umbrella.

Source: Derived – Mapped using dealership management process.

API Parameters

Not available as a search parameter

See Also

• mc_dealership_group_id - Dealership group id information
• Dealership-Management

mc_sub_dealership_group_id

The mc_sub_dealership_group_id is a unique identifier assigned by MarketCheck to sub-dealership groups—entities that operate under a larger dealership group but represent a distinct operational or branding unit. These IDs help in organizing dealerships that are part of subdivisions within major dealership groups.

Source: Derived – Mapped using dealership management process.

API Parameters

Not available as a search parameter

See Also

• mc_sub_dealership_group_name - Sub dealership group information
• Dealership-Management

mc_sub_dealership_group_name

The name of the sub-dealership group to which a dealer belongs, as categorized by MarketCheck. A sub-dealership group represents a smaller or more specialized cluster within a larger dealership group, often based on regional operations, brand segmentation, or specific ownership structures.

Source: Derived – Mapped using dealership management process.

API Parameters

Not available as a search parameter

See Also

• mc_sub_dealership_group_id - Sub dealership group id information
• Dealership-Management

mc_dealer_id

A unique identifier assigned by MarketCheck to each individual dealership. This ID is consistent across all listings from the same dealership and is used to join or reference dealership-level data across MarketCheck feeds and APIs.

Source: Derived – Mapped using dealership management process.

API Parameters

• mc_dealer_id - Filter by specific mc_dealer_id

See Also

• mc_website_id - MarketCheck website id information
• Dealership-Management

mc_location_id

A unique and persistent identifier assigned by MarketCheck to represent a specific dealership location. Each dealership address is mapped to a distinct mc_location_id. This allows consistent tracking of inventory at the location level.

Source: Derived – Mapped using dealership management process.

API Parameters

Not available as a search parameter

See Also

• mc_website_id - MarketCheck website id information
• Dealership-Management

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

API Parameters

• mc_website_id - Filter by specific mc_website_id

See Also

• mc_dealer_id - MarketCheck dealer id information
• Dealership-Management

mc_rooftop_id

A unique identifier assigned to each dealership's name within the MarketCheck database. This ID differentiates between various rooftops or franchises under the same dealer group.

Source: Derived – Mapped using dealership management process.

API Parameters

Not available as a search parameter

See Also

• mc_dealer_id - MarketCheck dealer id information
• Dealership-Management

is_searchable

Flag indicating the dealership listing where the vehicle is physically located, as identified by MarketCheck's deferred attribution logic. A value of 1 indicates the vehicle is physically available at the current dealership, while a value of 0 indicates it is not physically available at that location.

Source: Derived – MarketCheck's deferred attribution logic.

API Parameters

• nodedup - nodedup=true to include all listings, even duplicates

See Also

• Key-Concepts

car_seller_name

The actual seller of the car, as listed on the Vehicle Details Page (VDP) of the source website. This field is populated only when the dealer location differs from the car location.

Source: Scraped - Extracted from the source website.

API Parameters

Not available as a search parameter

See Also

• seller_name - Dealership name information

car_street

The street address of the car's location, as listed on the Vehicle Details Page (VDP) of the source website. This will be populated only when the dealer location differs from the car location.

Source: Scraped - Extracted from the source website.

API Parameters

Not available as a search parameter

See Also

• street - Dealership Street information

car_city

The city where the car is located, as listed on the Vehicle Details Page (VDP) of the source website. This will be populated only when the dealer location differs from the car location.

Source: Scraped - Extracted from the source website.

API Parameters

Not available as a search parameter

See Also

• city - Dealership city information

car_state

The state where the car is located, as listed on the Vehicle Details Page (VDP) of the source website. This will be populated only when the dealer location differs from the car location.

Source: Scraped - Extracted from the source website.

API Parameters

Not available as a search parameter

See Also

• state - Dealership state information

car_zip

The zip where the car is located, as listed on the Vehicle Details Page (VDP) of the source website. This will be populated only when the dealer location differs from the car location.

Source: Scraped - Extracted from the source website.

API Parameters

Not available as a search parameter

See Also

• zip - Dealership zip 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.

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.

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.

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.

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.

API Parameters

Not available as a search parameter

See Also

• vdp_url - VDP URL information