OEM Incentive Search

The OEM Incentive Search API provides comprehensive access to active automotive manufacturer incentive programs across the United States market. This powerful tool enables you to search, filter, and analyze current OEM incentives including cash rebates, financing offers, lease deals, and special programs from major automotive manufacturers.

The API aggregates incentive data from 30+ leading OEMs, providing near real-time insights into promotional offers, payment terms, and program availability. This enables dealers, financial institutions, and automotive professionals to stay informed about current incentive programs and make data-driven decisions about inventory, financing, and sales strategies.

Check out the Understanding Incentives guide for an overview of how incentives work, the types of programs available, and how to interpret incentive data.

Overview

Coverage and Data Volume:

• 30+ OEMs: Comprehensive coverage of major automotive manufacturers
• Active Programs: Near real-time access to current incentive offerings
• Program Types: Cash rebates, financing offers, lease deals, and special programs
• Geographic Coverage: United States market with national and regional specificity at MSA level

Supported OEMs:

Currency and Data Standards:

• Monetary Values: All amounts in USD
• Date Formats: US MDY format (MM/DD/YYYY)
• Geographic Data: US MSA and ZIP codes
• Update Frequency: Near real-time data with daily updates in API

This API enables comprehensive analysis of incentive markets, competitive intelligence, and program optimization for automotive industry professionals.

Base Path

GET https://api.marketcheck.com/v2/search/car/incentive/oem

The following example demonstrates how to use the OEM Incentive Search API to find active incentive programs with comprehensive filtering capabilities:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/search/car/incentive/oem',
  params: {api_key: 'YOUR_API_KEY', rows: 2},
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Request

The OEM Incentive Search API provides extensive filtering and search capabilities for automotive incentive programs. You can search by vehicle specifications, geographic location, offer types, and financial terms to find relevant incentive programs.

Parameters

Pagination

By default, the API returns a maximum of 10 results per page. You can use pagination parameters to navigate through larger result sets.

Parameters

• start - Offset from which results are returned (starts at 0)
• rows - Number of results per page (maximum 10, default 10)

Increment start proportionally to rows value for consistent pagination:

# First page (1-10)
GET https://api.marketcheck.com/v2/search/car/incentive/oem?start=0&rows=10&api_key=YOUR_API_KEY

# Second page (11-20)
GET https://api.marketcheck.com/v2/search/car/incentive/oem?start=10&rows=10&api_key=YOUR_API_KEY

# Third page (21-30)
GET https://api.marketcheck.com/v2/search/car/incentive/oem?start=20&rows=10&api_key=YOUR_API_KEY

Limits

• The maximum rows value is 10 which is also the default. If you specify higher values, the API will return only the first 10 results.
• Total pagination limit depends on your subscription package
• API returns HTTP 422 error when start + rows exceeds limits

Sorting

The OEM Incentive Search API supports sorting results by various numeric and date fields to organize data according to your analysis needs.

Sort Parameters

• sort_by - Field name to sort by (required for sorting)
• sort_order - Sort direction - asc (ascending, default) or desc (descending)

Supported Sort Fields

Facets

The OEM Incentive Search API supports faceted search capabilities, allowing you to build dynamic filtering interfaces and understand data distribution across different categories.

Field Facets

Field facets return counts of unique values for specified fields, enabling you to filter and group search results based on specific attributes. This allows for more granular analysis and exploration of the data.

Parameters and Syntax

To use field facets, include the facets parameter in your API request, specifying the fields you want to facet on. The syntax is similar to Inventory Search, refer to that section for detailed usage.

Available Field Facets

Facet Pagination

Facets results are paginated using positional parameters offset and limit, that are part of the facets parameter.

• offset - Starting position for terms (default: 0)
• limit - Maximum number of terms to return (default: 20, max: 1000)

Example: facets=make|20|20 returns makes 21-40

Facet Sorting

Facet terms can be sorted by count or alphabetically using the facet_sort parameter:

• count (default) - Sort by frequency (highest first)
• index - Sort alphabetically

Example: facets=make|0|20&facet_sort=index returns makes sorted alphabetically

Range Facets

Range facets enable you to analyze numeric data distribution and create dynamic range-based filters for financial and numeric fields.

Parameters and Syntax

To use range facets, include the range_facets parameter in your API request, specifying the fields you want to analyze. The syntax is similar to Inventory Search, refer to that section for detailed usage.

Available Range Facet Fields:

Statistics

The OEM Incentive Search API provides statistical analysis capabilities for numeric fields, enabling comprehensive market analysis and data insights.

To request statistics, include the stats parameter in your API request, specifying the fields you want to analyze. The syntax is similar to Inventory Search, refer to that section for detailed usage.

Available Statistical Fields

Response

Schema

interface OEMIncentiveResponse {
  num_found: number; // Total number of incentive programs matching criteria
  listings: IncentiveListing[]; // Array of incentive program listings
  facets?: Facets; // Facet counts by category (if requested)
  stats?: Stats; // Statistical analysis (if requested)
  range_facets?: RangeFacets; // Range-based facet analysis (if requested)
}

interface IncentiveListing {
  id: string; // Unique incentive program identifier
  base_sha: string; // Base SHA identifier for the program
  offer: IncentiveOffer; // Detailed offer information
  // Location Information
  msa_code: string; // Metropolitan Statistical Area code
  zip: string; // ZIP code where offer is valid and was crawled from
  city: string; // City where offer is valid and was crawled from
  state: string; // State where offer is valid and was crawled from
  country: string; // Country where offer is valid and was crawled from
  // Data Source Information
  dealer_id: string; // Associated MarketCheck dealer identifier for the OEM
  source: string; // Data source website for the incentive program
  status_date: string; // Date when offer was last updated
  scraped_at_date: string; // Date when offer was first collected
}

interface IncentiveOffer {
  vehicles: Vehicle[]; // Applicable vehicles for this incentive
  offer_type: string; // Type of incentive (lease, finance, cash, etc.)
  amounts: PaymentAmount[]; // Payment amount details
  oem_program_name: string; // Official OEM program name
  // Financial Terms
  cashback_amount: number; // Cash rebate amount
  cashback_target_group: string; // Target group for cashback
  due_at_signing: number; // Amount due at signing
  msrp: number; // Manufacturer's Suggested Retail Price
  down_payment: number; // Required down payment
  security_deposit: number; // Security deposit amount
  acquisition_fee: number; // Acquisition fee
  disposition_fee: number; // Disposition fee
  net_cap_cost: number; // Net capitalized cost
  gross_cap_cost: number; // Gross capitalized cost
  total_monthly_payments: number; // Total of all monthly payments
  lease_end_purchase_price: number; // Residual value
  over_mileage_fee: number; // Excess mileage penalty
  mileage_limit: number; // Annual mileage allowance
  dealer_contribution: number; // Dealer contribution amount
  // Program Details
  valid_from: string; // Program start date
  valid_through: string; // Program end date
  titles: string[]; // Program titles and headlines
  offers: string[]; // Detailed offer descriptions
  disclaimers: string[]; // Terms and conditions
}

interface Vehicle {
  make: string; // Vehicle manufacturer
  model: string; // Vehicle model
  year: number; // Model year
  trim: string; // Trim level
  drivetrain: string; // Drivetrain type
  transmission: string; // Transmission type
  engine: string; // Engine specification
  fuel_type: string; // Fuel type
}

interface PaymentAmount {
  monthly: number; // Lease monthly payment amount
  apr: number; // Annual Percentage Rate
  term: number; // Term length
  term_unit: string; // Term unit (months, years)
}

interface Facets {
  [field: string]: FacetTerm[]; // Facet results by field name
}

interface FacetTerm {
  term: string; // Facet term value
  count: number; // Number of listings with this term
}

interface Stats {
  [field: string]: FieldStats; // Statistics by field name
}

interface FieldStats {
  min: number; // Minimum value
  max: number; // Maximum value
  count: number; // Count of listings with values
  missing: number; // Count of listings without values
  sum: number; // Sum of all values
  mean: number; // Average value
  stddev: number; // Standard deviation
  sum_of_squares: number; // Sum of squared values
  median: number; // Median value
  percentiles: { [percentile: string]: number }; // Percentiles (e.g., 25th, 50th, 75th)
}

interface RangeFacets {
  [field: string]: RangeBucket[]; // Range facets by field name
}

interface RangeBucket {
  counts: {
    // Count of listings in each range bucket
    lower_bound: number; // Lower bound of the range
    upper_bound: number; // Upper bound of the range
    count: number; // Count of listings in this range
  }[];
  interval: number; // Interval size for the range
  start: number; // Start value of the range
  end: number; // End value of the range
  before: number; // Count of listings before this range
  between: number; // Count of listings within this range
  after: number; // Count of listings after this range
}

Success Response

• 200 OK - Returns JSON object with incentive program listings and optional analytics
• num_found indicates total matching programs for pagination context
• Missing or null field values are excluded from the response
• All monetary values are in USD

Error Response

Error Response Format

Most error responses follow this structure, except for 502 and 503 errors:

{
  "code": <HTTP status code>,
  "message": "<Error message describing the issue>"
}

Use Cases & Examples

Competitive Intelligence Analysis

Analyze competitor incentive programs to understand market positioning and identify opportunities for competitive advantage. Monitor OEM programs across different manufacturers and markets.

Use manufacturer and location filtering to compare incentive offerings across competing brands using make, state, and city parameters.

Example:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/search/car/incentive/oem',
  params: {api_key: 'YOUR_API_KEY', rows: 2, make: 'Hyundai,Kia,Toyota', state: 'CA'},
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Regional Market Analysis

Understand how incentive programs vary across different geographic markets to optimize regional sales strategies and inventory distribution.

Use geographic parameters to analyze market-specific incentive availability and terms.

Example:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/search/car/incentive/oem',
  params: {api_key: 'YOUR_API_KEY', rows: 2, zip: '78201', radius: 100},
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Financial Product Development

Analyze current market rates and terms to develop competitive financing and leasing products. Understand APR ranges, term structures, and down payment requirements.

Use financial range parameters and statistics to understand market positioning.

Example:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/search/car/incentive/oem',
  params: {
    api_key: 'YOUR_API_KEY',
    rows: 2,
    monthly_range: '200-300',
    term_range: '24-48',
    sort_by: 'cashback_amount',
    sort_order: 'desc'
  },
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Dealer Program Optimization

Help dealers understand available incentive programs for their inventory and customer base. Identify the most attractive offers for specific vehicle segments.

Filter by dealer location and vehicle specifications to find relevant programs.

Example:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/search/car/incentive/oem',
  params: {
    api_key: 'YOUR_API_KEY',
    rows: 2,
    offer_type: 'lease',
    latitude: 34.035718,
    longitude: -118.3006,
    radius: 50,
    make: 'Honda',
    model: 'Accord',
    sort_by: 'monthly',
    sort_order: 'asc'
  },
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Customer Incentive Matching

Match customers with the best available incentive programs based on their preferences and qualifications. Search by target groups and program types.

Use text search and target group filtering to find relevant customer incentives.

Example:

First, get the list of identified customer groups, by using the facets parameter to get the cashback_target_group facet.

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/search/car/incentive/oem',
  params: {api_key: 'YOUR_API_KEY', rows: 0, facets: 'cashback_target_group'},
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Next, use the cashback_target_group facet values to filter incentives for specific customer groups:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/search/car/incentive/oem',
  params: {api_key: 'YOUR_API_KEY', rows: 2, cashback_target_group: 'Military personnel'},
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Sometimes, the target group is not specified or extracted properly for lease and finance offers. In such cases, you can use the search_offers_text, search_titles_text, and search_disclaimers_text parameters to search for specific terms in the offer descriptions, titles, and disclaimers.

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/search/car/incentive/oem',
  params: {api_key: 'YOUR_API_KEY', rows: 2, search_offers_text: 'loyalty'},
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Lease vs Finance Analysis

Compare leasing and financing options across different manufacturers to understand market trends and customer preferences.

Filter by offer type and analyze financial terms across different program types.

Example:

Use the offer_type parameter to filter for lease or finance offers, and analyze monthly payment statistics or apr stats.

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/search/car/incentive/oem',
  params: {
    api_key: 'YOUR_API_KEY',
    rows: 2,
    offer_type: 'lease',
    stats: 'monthly_payment'
  },
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Next use the stats parameter to get APR statistics for finance offers:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/search/car/incentive/oem',
  params: {api_key: 'YOUR_API_KEY', rows: 2, offer_type: 'finance', stats: 'apr'},
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Seasonal Campaign Analysis

Track how incentive programs change over time and identify seasonal patterns in OEM promotional strategies.

Use date range parameters to analyze program validity periods and timing.

Example:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/search/car/incentive/oem',
  params: {
    api_key: 'YOUR_API_KEY',
    rows: 2,
    offer_type: 'lease',
    valid_through_range: '20250915-20250930'
  },
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Electric Vehicle Incentive Research

Identify incentive programs specifically targeting electric and hybrid vehicles to understand market support for alternative fuel vehicles.

Filter by fuel type and search program descriptions for EV-specific terms.

Example:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/search/car/incentive/oem',
  params: {api_key: 'YOUR_API_KEY', rows: 2, fuel_type: 'electric'},
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

See Also

• OEM Incentive by Make and ZIP
• Inventory Search
• Market Days Supply
• Inferred Sales Stats