Data Definitions

Detailed definitions of all fields in the MarketCheck Incentives dataset

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

Field Definitions

id

Unique identifier for each incentive offer document generated as a SHA-256 hash of the complete offer content. This field ensures document uniqueness across the entire dataset and serves as the primary key for database operations and data synchronization.

Source: Generated - SHA-256 hash of entire offer document content

Attribute	Data Feed	API
Name	`id`	`id`
Type	`string`	`string`
Format	64 characters (SHA-256 hash)	64 characters (SHA-256 hash)
Sample	`6e0fb5c9d6c174b0e44338071fe703d942d9ef968a154417dc43c3dbfe4f369f`	`d6e31c4ee7775aaf803e305cf799815a297ec97c08c41912a40bf6ff1bc78a44`

API Parameters

Not available as a search parameter

See Also

base_sha - For deduplicating offers across locations
Key Concepts

base_sha

Unique identifier for incentive offers that groups identical programs across different geographic locations. Generated by hashing the offer content excluding location-specific fields like zipcode. Essential for deduplicating offers that appear in multiple MSAs or ZIP codes.

Source: Generated - SHA-256 hash excluding zipcode, city, state fields

Attribute	Data Feed	API
Name	`base_sha`	`base_sha`
Type	`string`	`string`
Format	64 characters (SHA-256 hash)	64 characters (SHA-256 hash)
Sample	`8cce57930c2b0c5130de2b05542317698a1ca715ba25df028bd7c267e7409361`	`4559667aedb494d2b0c47e5cb2325f59ccad8925d4cdce73aee6bbe8d2aff1ff`

API Parameters

base_sha - Filter by specific base SHA value

See Also

id - Complete document identifier
Key Concepts

nlp_sha

Unique identifier generated from the textual content fields (titles, offers, disclaimers) of an incentive offer. Used for natural language processing and text-based analysis to identify offers with identical promotional content regardless of other attributes.

This field is only available in the data feed.

Source: Generated - SHA-256 hash of concatenated titles, offers, and disclaimers fields

Attribute	Data Feed
Name	`nlp_sha`
Type	`string`
Format	64 characters (SHA-256 hash)
Sample	`8cce57930c2b0c5130de2b05542317698a1ca715ba25df028bd7c267e7409361`

API Parameters

Not available in API

See Also

titles - Offer headline text
offers - Primary offer text
disclaimers - Fine print content

make

Automotive manufacturer brand name for vehicles eligible for the incentive program. Standardized across all MarketCheck datasets using consistent naming conventions. Critical for filtering offers by specific OEM manufacturers.

Source: Enriched - Vehicle decoder using VIN and model information from MarketCheck vehicle database and OEM specifications

Attribute	Data Feed	API
Name	`make`	`vehicles[].make`
Type	`string`	`string`
Format	Variable, typically 3-15 characters	Variable, typically 3-15 characters
Sample	`Toyota`	`Ford`

API Parameters

make - Filter by manufacturer name

See Also

model - Vehicle model information
vehicles - Complete vehicle array structure

model

Specific vehicle model name within a manufacturer's lineup that is eligible for the incentive program. Standardized naming ensures consistency across all MarketCheck products and enables precise filtering of incentive offers by vehicle type.

Source: Enriched - Vehicle decoder and OEM model specifications from MarketCheck vehicle database and manufacturer catalogs

Attribute	Data Feed	API
Name	`model`	`vehicles[].model`
Type	`string`	`string`
Format	Variable, typically 3-25 characters	Variable, typically 3-25 characters
Sample	`Camry`	`F-150`

API Parameters

model - Filter by vehicle model name

See Also

make - Manufacturer information
trim - Vehicle trim level details

year

Model year of vehicles eligible for the incentive program. Represents the manufacturer's designated model year, which may differ from production year. Essential for targeting specific vehicle vintages and understanding program scope across model years.

Source: Enriched - Vehicle decoder and OEM model specifications from MarketCheck vehicle database

Attribute	Data Feed	API
Name	`year`	`vehicles[].year`
Type	`integer`	`integer`
Format	Typically 2024-2026 for current programs	Typically 2024-2026 for current programs
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

trim

Specific trim level or configuration variant of a vehicle model eligible for the incentive program. Trim levels indicate equipment packages, feature sets, and pricing tiers within a model lineup.

Source: Enriched - Vehicle decoder and OEM trim specifications from MarketCheck vehicle database and manufacturer specifications

Attribute	Data Feed	API
Name	`trim`	`vehicles[].trim`
Type	`string`	`string`
Format	Variable, typically 2-20 characters	Variable, typically 2-20 characters
Sample	`LE`	`XLE`

API Parameters

trim - Filter by specific trim level

See Also

make - Manufacturer information
model - Vehicle model details

drivetrain

Drive system configuration of vehicles eligible for the incentive program. Indicates how power is transmitted from the engine to the wheels, affecting vehicle performance, fuel efficiency, and pricing. Important for matching incentives to specific vehicle configurations.

Source: Enriched - Vehicle decoder and technical specifications from MarketCheck vehicle database and OEM technical data

Attribute	Data Feed	API
Name	`drivetrain`	`vehicles[].drivetrain`
Type	`string`	`string`
Format	Variable, typically 3-10 characters	Variable, typically 3-10 characters
Sample	`FWD`	`AWD`

API Parameters

drivetrain - Filter by drivetrain type

See Also

transmission - Transmission type
engine - Engine specifications

transmission

Transmission type for vehicles eligible for the incentive program. Indicates the gear-changing mechanism (automatic, manual, or continuously variable) which affects vehicle performance, fuel economy, and consumer preferences in incentive targeting.

Source: Enriched - Vehicle decoder and technical specifications from MarketCheck vehicle database and OEM technical data

Attribute	Data Feed	API
Name	`transmission`	`vehicles[].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

engine

Engine specifications for vehicles eligible for the incentive program. Provides detailed engine information including displacement, configuration, and technology features. Critical for matching incentives to specific powertrain options within a model lineup.

Source: Enriched - Vehicle decoder and technical specifications from MarketCheck vehicle database and OEM technical data

Attribute	Data Feed	API
Name	`engine`	`vehicles[].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 - Filter by engine specifications

See Also

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

fuel_type

Primary fuel type for vehicles eligible for the incentive program. Indicates the energy source (gasoline, hybrid, electric, diesel) used by the vehicle, which is increasingly important for targeting environmental and efficiency-focused incentive programs.

Source: Enriched - Vehicle decoder and technical specifications from MarketCheck vehicle database and OEM technical data

Attribute	Data Feed	API
Name	`fuel_type`	`vehicles[].fuel_type`
Type	`string`	`string`
Format	Variable, typically 3-15 characters	Variable, typically 3-15 characters
Sample	`Gasoline`	`Hybrid`

API Parameters

fuel_type - Filter by fuel type

See Also

engine - Engine specifications
powertrain_type - Powertrain classification

offer_type

Primary category of the incentive program indicating the fundamental structure of the offer. Distinguishes between cash rebates, financing promotions, and lease deals to help consumers and dealers quickly identify relevant programs for their needs.

Source: Scraped - Extracted from OEM website offer content and structure, classified based on offer terms and payment structures

Attribute	Data Feed	API
Name	`offer_type`	`offer_type`
Type	`string`	`string`
Format	Variable, typically 4-10 characters	Variable, typically 4-10 characters
Sample	`cash`	`finance`

API Parameters

offer_type - Filter by incentive type

See Also

cashback_amount - Cash rebate details
apr - Financing rate information
monthly_payment - Lease payment details

monthly

Monthly payment amount for lease incentive programs. Represents the advertised monthly cost to lease the vehicle under the promotional terms. Critical metric for consumers comparing lease offers and understanding total cost of vehicle access.

Source: Scraped - Extracted from OEM lease offer terms and promotional content

Attribute	Data Feed	API
Name	`monthly`	`amounts[].monthly`
Type	`float`	`float`
Format	2 decimal places, USD currency	2 decimal places, USD currency
Sample	`299.00`	`399.99`

API Parameters

monthly_range - Filter by monthly payment range

See Also

lease_term - Lease duration
due_at_signing - Initial payment requirements

apr

Annual Percentage Rate for financing incentive programs. Represents the yearly cost of borrowing money to purchase the vehicle, including interest and fees. Lower APR rates indicate more attractive financing terms and reduced total cost of ownership.

Source: Scraped - Extracted from OEM financing offer terms and promotional content

Attribute	Data Feed	API
Name	`apr`	`amounts[].apr`
Type	`float`	`float`
Format	2 decimal places, percentage	2 decimal places, percentage
Sample	`2.9`	`3.9`

API Parameters

apr_range - Filter by APR range

See Also

finance_term - Loan duration
offer_type - Incentive type classification

term

Duration of the agreement in months for both lease and finance incentive programs. Indicates the commitment period for the promotional terms, whether for a lease or a loan. Longer terms typically result in lower monthly payments for leases and lower monthly installments for financing, but may increase total cost over the agreement period.

Source: Scraped - Extracted from OEM offer terms and agreement details

Attribute	Data Feed	API
Name	`term`	`amounts[].term`
Type	`integer`	`integer`
Format	Months, typically 24-84 months	Months, typically 24-84 months
Sample	`36` (lease)	`60` (finance)

API Parameters

term_range - Filter by term range
term_unit - Specify term unit (months)

See Also

monthly_payment - Monthly payment amount for leases
apr - Financing rate for loans
mileage_allowance - Annual mileage limits for leases
down_payment - Initial payment requirements

cashback_amount

Dollar amount of cash rebate offered directly to customers for cash incentive programs. Represents immediate price reduction or rebate check provided by the manufacturer to reduce the effective purchase price of the vehicle.

Source: Scraped - Extracted from OEM cash rebate offers and promotional content

Attribute	Data Feed	API
Name	`cashback_amount`	`cashback_amount`
Type	`float`	`float`
Format	2 decimal places, USD currency	2 decimal places, USD currency
Sample	`2500.00`	`1000.00`

API Parameters

cashback_amount_range - Filter by cashback amount range

See Also

offer_type - Incentive type classification
cashback_target_group - Eligibility requirements

cashback_target_group

Specific customer segment or eligibility criteria for cash rebate programs. Identifies target demographics, professions, or customer types eligible for special rebate amounts. Common targeting includes military personnel, recent graduates, or loyalty program members.

Source: Scraped - Extracted from OEM rebate eligibility requirements and program terms

Attribute	Data Feed	API
Name	`cashback_target_group`	`cashback_target_group`
Type	`string`	`string`
Format	Variable, typically 10-30 characters	Variable, typically 10-30 characters
Sample	`Military`	`Recent Graduate`

API Parameters

cashback_target_group - Filter by target group

See Also

cashback_amount - Rebate amount details
disclaimers - Detailed eligibility terms

down_payment

Initial payment required at lease or purchase signing for incentive programs. Represents the upfront cash requirement to secure the promotional terms. Lower down payments make offers more accessible but may result in higher monthly payments.

Source: Scraped - Extracted from OEM offer terms and payment requirements

Attribute	Data Feed	API
Name	`down_payment`	`down_payment`
Type	`float`	`float`
Format	2 decimal places, USD currency	2 decimal places, USD currency
Sample	`2999.00`	`0.00`

API Parameters

down_payment_range - Filter by down payment range

See Also

due_at_signing - Total initial payment
monthly_payment - Ongoing payment amount

due_at_signing

Total amount due at lease signing including down payment, first month payment, fees, and taxes. Represents the complete upfront cost to secure the lease agreement. Critical for understanding true initial financial commitment beyond advertised down payment.

Source: Scraped - Extracted from OEM lease terms and signing requirements

Attribute	Data Feed	API
Name	`due_at_signing`	`due_at_signing`
Type	`float`	`float`
Format	2 decimal places, USD currency	2 decimal places, USD currency
Sample	`3499.00`	`299.00`

API Parameters

due_at_signing_range - Filter by signing amount range

See Also

down_payment - Down payment component
monthly_payment - Monthly payment amount

msrp

Manufacturer's Suggested Retail Price for the vehicle featured in the incentive program. Provides baseline pricing reference to understand the value of promotional offers and calculate effective discount percentages from standard pricing.

Source: Scraped - Extracted from OEM pricing information and offer disclaimers

Attribute	Data Feed	API
Name	`msrp`	`msrp`
Type	`float`	`float`
Format	2 decimal places, USD currency	2 decimal places, USD currency
Sample	`32995.00`	`28450.00`

API Parameters

msrp_range - Filter by MSRP range

See Also

net_cap_cost - Lease capitalized cost
cashback_amount - Direct rebate amount

security_deposit

Refundable deposit required for lease agreements to secure the vehicle and cover potential excess wear or damage. Amount is typically equivalent to one monthly payment and is returned at lease end if vehicle condition meets standards.

Source: Scraped - Extracted from OEM lease terms and deposit requirements

Attribute	Data Feed	API
Name	`security_deposit`	`security_deposit`
Type	`float`	`float`
Format	2 decimal places, USD currency	2 decimal places, USD currency
Sample	`0.00`	`299.00`

API Parameters

security_deposit_range - Filter by security deposit range

See Also

due_at_signing - Total signing amount
monthly_payment - Monthly payment amount

acquisition_fee

Administrative fee charged by leasing companies to initiate the lease agreement. Covers processing, documentation, and setup costs for the lease contract. This fee is typically built into the lease terms or paid upfront at signing.

Source: Scraped - Extracted from OEM lease terms and fee disclosures

Attribute	Data Feed	API
Name	`acquisition_fee`	`acquisition_fee`
Type	`float`	`float`
Format	2 decimal places, USD currency	2 decimal places, USD currency
Sample	`395.00`	`595.00`

API Parameters

acquisition_fee_range - Filter by acquisition fee range

See Also

disposition_fee - Lease-end fee
due_at_signing - Total initial payment

disposition_fee

Fee charged at the end of a lease agreement to cover vehicle inspection, reconditioning, and remarketing costs. Paid when returning the vehicle unless purchasing or leasing another vehicle from the same manufacturer, depending on program terms.

Source: Scraped - Extracted from OEM lease terms and end-of-lease fee disclosures

Attribute	Data Feed	API
Name	`disposition_fee`	`disposition_fee`
Type	`float`	`float`
Format	2 decimal places, USD currency	2 decimal places, USD currency
Sample	`395.00`	`595.00`

API Parameters

disposition_fee_range - Filter by disposition fee range

See Also

acquisition_fee - Lease initiation fee
lease_end_purchase_price - Purchase option price

dealer_contribution

Additional discount or incentive provided by the dealership to supplement manufacturer incentives. Represents dealer participation in promotional programs to enhance customer value and competitive positioning beyond OEM-funded programs.

Source: Scraped - Extracted from OEM program details indicating dealer participation requirements

Attribute	Data Feed	API
Name	`dealer_contribution`	`dealer_contribution`
Type	`float`	`float`
Format	2 decimal places, USD currency	2 decimal places, USD currency
Sample	`500.00`	`1000.00`

API Parameters

dealer_contribution_range - Filter by dealer contribution range

See Also

cashback_amount - Manufacturer rebate
monthly_payment - Net payment after contributions

total_monthly_payments

Cumulative amount of all monthly payments over the lease term. Calculated by multiplying monthly payment by lease term duration. Provides total cost perspective for lease agreements to enable comparison with purchase financing options.

Source: Scraped - Extracted directly from OEM offer text when total monthly payments are explicitly mentioned. This field is only populated if the OEM offer text includes the total monthly payment amount.

Attribute	Data Feed	API
Name	`total_monthly_payments`	`total_monthly_payments`
Type	`float`	`float`
Format	2 decimal places, USD currency	2 decimal places, USD currency
Sample	`10764.00`	`14399.64`

API Parameters

total_monthly_payments_range - Filter by total payment range

See Also

monthly_payment - Individual payment amount
lease_term - Lease duration

mileage_limit

Annual mileage limit included in lease agreements without additional charges. Exceeding this limit results in excess mileage fees at lease end. Higher limits provide more driving flexibility but may increase monthly payments or lease costs.

Source: Scraped - Extracted from OEM lease terms and mileage provisions

Attribute	Data Feed	API
Name	`mileage_limit`	`mileage_limit`
Type	`integer`	`integer`
Format	Miles per year, typically 10,000-15,000 annually	Miles per year, typically 10,000-15,000 annually
Sample	`12000`	`10000`

API Parameters

mileage_limit_range - Filter by mileage limit range

See Also

over_mileage_fee - Excess mileage charges
lease_term - Lease duration

over_mileage_fee

Cost per mile charged for exceeding the lease mileage limit. Applied to total excess miles at lease end to compensate for additional vehicle wear and reduced residual value. Critical factor in lease cost calculation for high-mileage drivers.

Source: Scraped - Extracted from OEM lease terms and excess mileage provisions

Attribute	Data Feed	API
Name	`over_mileage_fee`	`over_mileage_fee`
Type	`float`	`float`
Format	3 decimal places, USD per mile	3 decimal places, USD per mile
Sample	`0.250`	`0.200`

API Parameters

over_mileage_fee_range - Filter by excess mileage fee range

See Also

mileage_allowance - Annual mileage limit
lease_term - Lease duration

lease_end_purchase_price

Predetermined price to purchase the leased vehicle at lease expiration. Also known as residual value, this amount is established at lease inception based on projected vehicle depreciation and enables lessees to buy their vehicle.

Source: Scraped - Extracted from OEM lease terms and purchase option details

Attribute	Data Feed	API
Name	`lease_end_purchase_price`	`amounts[].lease_end_purchase_price`
Type	`float`	`float`
Format	2 decimal places, USD currency	2 decimal places, USD currency
Sample	`18650.00`	`22995.00`

API Parameters

lease_end_purchase_price_range - Filter by purchase price range

See Also

msrp - Original vehicle price
net_cap_cost - Lease capitalization cost

net_cap_cost

Adjusted capitalized cost used to calculate lease payments after applying all rebates, trade-in credits, and down payments. Represents the financed amount that determines monthly payment calculations and total lease cost structure.

Source: Scraped - Extracted from OEM lease calculation details and cost breakdowns

Attribute	Data Feed	API
Name	`net_cap_cost`	`net_cap_cost`
Type	`float`	`float`
Format	2 decimal places, USD currency	2 decimal places, USD currency
Sample	`25995.00`	`31450.00`

API Parameters

net_cap_cost_range - Filter by net capitalized cost range

See Also

gross_cap_cost - Initial capitalized cost
monthly_payment - Resulting payment amount

gross_cap_cost

Initial capitalized cost before applying rebates, trade-ins, or down payments in lease calculations. Represents the starting value used for lease structuring before incentives reduce the financed amount to determine final lease terms.

Source: Scraped - Extracted from OEM lease calculation details and cost breakdowns

Attribute	Data Feed	API
Name	`gross_cap_cost`	`gross_cap_cost`
Type	`float`	`float`
Format	2 decimal places, USD currency	2 decimal places, USD currency
Sample	`28995.00`	`34450.00`

API Parameters

gross_cap_cost_range - Filter by gross capitalized cost range

See Also

net_cap_cost - Adjusted capitalized cost
msrp - Manufacturer suggested price

valid_from

Start date of the incentive program as specified by the manufacturer. Indicates when customers can begin utilizing the promotional terms. Programs may have future effective dates to coordinate with model year launches or seasonal campaigns.

Source: Scraped - Extracted from OEM offer validity periods and program terms

Attribute	Data Feed	API
Name	`valid_from`	`valid_from`
Type	`string`	`string`
Format	US MDY format (MM/DD/YYYY)	US MDY format (MM/DD/YYYY)
Sample	`01/01/2024`	`03/15/2024`

API Parameters

valid_from_range - Filter by program start date range

See Also

valid_through - Program end date
scraped_at_date - Initial discovery date
status_date - Last verified date

valid_through

End date of the incentive program as specified by the manufacturer. Indicates the final date customers can secure the promotional terms. Programs typically align with monthly or quarterly sales cycles and model year transitions.

Source: Scraped - Extracted from OEM offer validity periods and program expiration terms

Attribute	Data Feed	API
Name	`valid_through`	`valid_through`
Type	`string`	`string`
Format	US MDY format (MM/DD/YYYY)	US MDY format (MM/DD/YYYY)
Sample	`03/31/2024`	`06/30/2024`

API Parameters

valid_through_range - Filter by program end date range

See Also

valid_from - Program start date
scraped_at_date - Initial discovery date
status_date - Last verified date

status_date

Timestamp when MarketCheck last verified the incentive offer on the OEM website. Updated daily during crawling operations to confirm program availability. Offers not updated within 24 hours are automatically removed from active datasets.

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

Attribute	Data Feed	API
Name	`status_date`	`status_date`
Type	`integer` (Unix timestamp)	`string` (ISO 8601 format)
Format	Unix seconds timestamp	ISO-8601 datetime string (YYYY-MM-DDThh:mm:ssZ)
Sample	`1705328600`	`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

Timestamp when MarketCheck first discovered the incentive offer on the OEM website. Remains constant throughout the offer's lifecycle to track program introduction timing. Essential for understanding offer longevity and historical program analysis.

Source: Generated - Set during initial offer discovery (timestamp of first successful crawl capturing the offer)

Attribute	Data Feed	API
Name	`scraped_at_date`	`scraped_at_date`
Type	`integer` (Unix timestamp)	`string` (ISO 8601 format)
Format	Unix seconds timestamp	ISO-8601 datetime string (YYYY-MM-DDThh:mm:ssZ)
Sample	`1704099300`	`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

zipcode

ZIP code used to crawl the incentive offer from the OEM website. Represents the specific geographic location where the offer was discovered, typically one representative ZIP code per MSA for comprehensive national coverage.

Source: Generated - Selected using MSA sampling strategy (one ZIP code per MSA based on dealer presence and population density)

Attribute	Data Feed	API
Name	`zipcode`	`zipcode`
Type	`string`	`string`
Format	5 digits, US ZIP code format	5 digits, US ZIP code format
Sample	`90210`	`10001`

API Parameters

zip - Filter by specific ZIP code

See Also

msa_code - Metropolitan Statistical Area
state - State location
Overview

msa_code

Metropolitan Statistical Area code where the incentive offer is valid. Represents the broader geographic region served by the offer, as incentives available in one ZIP code within an MSA typically apply to all ZIP codes in that MSA.

Source: Enriched - Derived from ZIP code geographic mapping using US Census Bureau MSA definitions

Attribute	Data Feed	API
Name	`msa_code`	`msa_code`
Type	`string`	`string`
Format	5 digits, US Census MSA code format	5 digits, US Census MSA code format
Sample	`31080`	`35620`

API Parameters

msa_code - Filter by MSA code

See Also

zipcode - Specific crawl location
state - State location
city - City location

state

US state abbreviation where the incentive offer is valid. Provides state-level geographic filtering for regional program analysis and compliance with state-specific automotive regulations and incentive programs.

Source: Enriched - Derived from ZIP code geographic mapping using US Postal Service state codes

Attribute	Data Feed	API
Name	`state`	`state`
Type	`string`	`string`
Format	2 characters, US state abbreviation (uppercase)	2 characters, US state abbreviation (uppercase)
Sample	`CA`	`NY`

API Parameters

state - Filter by state abbreviation

See Also

zipcode - ZIP code location
msa_code - MSA region
city - City location

city

City name where the incentive offer is valid, derived from ZIP code geographic data. Provides local market context for incentive programs and enables city-level analysis of manufacturer promotional strategies.

Source: Enriched - Derived from ZIP code geographic mapping

Attribute	Data Feed	API
Name	`city`	`city`
Type	`string`	`string`
Format	Variable, typically 3-30 characters	Variable, typically 3-30 characters
Sample	`Beverly Hills`	`New York`

API Parameters

city - Filter by city name

See Also

state - State location
zipcode - ZIP code location
msa_code - MSA region

country

Country where the incentive offer is valid. Currently limited to United States market coverage. Provides standardized country identification for international data consistency and future market expansion capabilities.

Source: Generated - Set to "US" for all current incentive offers (fixed value based on market coverage scope)

Attribute	Data Feed	API
Name	`country`	`country`
Type	`string`	`string`
Format	2 characters, ISO 3166-1 alpha-2 country code	2 characters, ISO 3166-1 alpha-2 country code
Sample	`US`	`US`

API Parameters

country - Filter by country code

See Also

state - State location
Overview

dealer_id

MarketCheck identifier for the OEM.

Source: Enriched - Matched using dealership location and franchise data from MarketCheck dealer database

Attribute	Data Feed	API
Name	`dealer_id`	`dealer_id`
Type	`integer`	`integer`
Format	Positive integer values	Positive integer values
Sample	`12345`	`67890`

API Parameters

dealer_id - Filter by specific dealer ID

See Also

zipcode - Dealer location ZIP
msa_code - Dealer market area

source

Data source identifier indicating the OEM website from which the incentive offer was collected. Provides transparency about data origin and enables source-specific quality analysis and troubleshooting.

Source: Enriched - Derived from the OEM website URL used during scraping operations

Attribute	Data Feed	API
Name	`source`	`source`
Type	`string`	`string`
Format	Variable, typically 10-30 characters	Variable, typically 10-30 characters
Sample	`toyota_com`	`ford_com`

API Parameters

source - Filter by data source

See Also

make - Vehicle manufacturer
Overview

titles

Headline text or promotional titles from the OEM incentive offer as displayed on manufacturer websites. Contains the primary marketing message and key offer highlights. Multiple titles are pipe-separated when present.

Source: Scraped - Extracted directly from OEM website offer headlines and promotional titles

Attribute	Data Feed	API
Name	`titles`	`titles`
Type	`string`	`array<string>`
Format	Variable, multiple values separated by pipe (\|) character	Array of strings, each representing a title
Sample	`$2,500 Customer Cash on Select 2024 Camry Models`	`["1.9% APR Financing Available", "Up to 60 Months"]`

API Parameters

search_titles_text - Full-text search within titles

See Also

offers - Primary offer content
disclaimers - Terms and conditions

offers

Primary offer text containing the main promotional terms and payment details as presented on OEM websites. Includes key financial information, payment structures, and program highlights. Multiple offers are pipe-separated when present.

Source: Scraped - Extracted directly from OEM website offer content and promotional text sections

Attribute	Data Feed	API
Name	`offers`	`offers`
Type	`string`	`array<string>`
Format	Variable, multiple values separated by pipe (\|) character	Array of strings, each representing an offer
Sample	`Get $2,500 cash back when you finance or lease a new 2024 Camry`	`["Special 1.9% APR financing for qualified buyers", "Up to 60 months"]`

API Parameters

search_offers_text - Full-text search within offers

See Also

titles - Offer headlines
disclaimers - Terms and conditions

disclaimers

Fine print text containing detailed terms, conditions, and eligibility requirements for incentive offers. Includes legal disclaimers, qualification criteria, and program restrictions. Multiple disclaimers are pipe-separated when present.

Source: Scraped - Extracted directly from OEM website disclaimer text and terms sections

Attribute	Data Feed	API
Name	`disclaimers`	`disclaimers`
Type	`string`	`array<string>`
Format	Variable,multiple values separated by pipe (\|) character	Array of strings, each representing a disclaimer
Sample	`For qualified buyers with approved credit. Offer expires 12/31/2024. See dealer for details.`	`["Closed-end lease with 10,000 miles per year.", "$0.25 per excess mile.", "Plus tax, title, license."]`

API Parameters

search_disclaimers_text - Full-text search within disclaimers

See Also

titles - Offer headlines
offers - Primary offer content

oem_program_name

Official program name assigned by the manufacturer to the incentive offer. Provides standardized program identification for tracking, analysis, and coordination with dealer networks. May be null when OEMs do not assign specific program names.

Source: Scraped - Extracted from OEM program documentation and offer metadata

Attribute	Data Feed	API
Name	`oem_program_name`	`oem_program_name`
Type	`string`	`string`
Format	Variable, typically 10-50 characters; may be null for unnamed programs	Variable, typically 10-50 characters; may be null for unnamed programs
Sample	`Spring Sales Event`	`Year-End Clearance`

API Parameters

Not available as a search parameter

See Also

cashback_target_group - Target customer segments
make - Vehicle manufacturer

offer_link

Direct URL to the manufacturer's website page containing the original incentive offer. Provides access to the complete offer details and terms.

Source: Scraped - Extracted from OEM website offer pages

Attribute	Data Feed	API
Name	`offer_link`	`offer_link`
Type	`string`	`string`
Format	Valid URL format (http/https)	Valid URL format (http/https)
Sample	`https://www.toyota.com/upstateny/deals-incentives/tundrahybrid_cash_aefbdede-954b-4541-9ac3-99773199316d/?vehicles=tundrahybrid`	`https://www.toyota.com/upstateny/deals-incentives/tundrahybrid_cash_aefbdede-954b-4541-9ac3-99773199316d/?vehicles=tundrahybrid`

API Parameters

Not available as a search parameter

See Also

source - Data source identifier
offers - Primary offer content

photo_links

Array of image URLs associated with the incentive offer from manufacturer promotional materials. Provides visual content related to the featured vehicles or promotional campaigns.

Source: Scraped - Extracted from OEM website offer pages

Attribute	Data Feed	API
Name	`photo_links`	`photo_links`
Type	`string`	`array<string>`
Format	Multiple URLs separated by pipe (\|) character	Array of strings, each representing a valid URL
Sample	`https://www.kia.com/us/content/dam/kia/us/en/vehicles/niro-ev/2025/trims/wave/exterior/d7d7d7/360/35.png\|https://www.kia.com/us/content/dam/kia/us/en/vehicles/niro-ev/2025/trims/wind/exterior/d7d7d7/360/35.png`	`["https://www.kia.com/us/content/dam/kia/us/en/vehicles/niro-ev/2025/trims/wave/exterior/d7d7d7/360/35.png", "https://www.kia.com/us/content/dam/kia/us/en/vehicles/niro-ev/2025/trims/wind/exterior/d7d7d7/360/35.png"]`

API Parameters

Not available as a search parameter

Listing Lifecycle

Learn how MarketCheck discovers, tracks, and expires OEM incentive offers, and understand the key date fields that govern an offer's status.

Overview

This document provides a comprehensive overview of MarketCheck’s Recreational Vehicle (RV) 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.