The OEM Incentive by Make and ZIP API provides streamlined access to manufacturer incentive programs targeting specific geographic regions. This endpoint retrieves all active incentive offers for a given make within the Metropolitan Statistical Area (MSA) of the provided ZIP code.
Incentive data is collected at the MSA level, ensuring comprehensive coverage of regional offers. When an incentive is available for one ZIP code within an MSA, it is typically available across all ZIP codes in that same MSA, making this endpoint ideal for location-specific incentive searches.
Coverage and Geographic Scope:
Key Differences from Incentive Search API:
This endpoint complements the comprehensive OEM Incentive Search API by providing a simplified interface for common use cases requiring make and location-specific incentive discovery.
GET https://api.marketcheck.com/v2/search/car/incentive/{make}/{zip}
The following example demonstrates how to retrieve incentive programs for Ford vehicles in the Beverly Hills area:
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/search/car/incentive/ford/90210',
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);
}
This API builds upon the OEM Incentive Search API foundation, supporting the same filtering, faceting, and statistical analysis capabilities with simplified path-based targeting.
Required Parameters:
make - OEM manufacturer name (case-insensitive, e.g., "ford", "toyota", "chevrolet")zip - ZIP code for MSA-based geographic targeting (e.g., "90210", "10001")Filters listings by acquisition fee amount. Specify as min-max in USD (e.g., 500-1500).
Your MarketCheck API authentication key. Required for every request, unless OAuth is used.
Filters listings by Annual Percentage Rate (APR). Specify as min-max (e.g., 0-9.99).
The SHA-256 hash of an incentive offer used as the comparison baseline.
Filters listings by cashback amount specified in the offer. Specify as min-max in USD.
Filters cashback offers by target group (e.g. Military personnel, College graduates). Accepts multiple groups as comma-separated values.
Filters listings by city name (e.g. Los Angeles, San Francisco, Houston).
Filters listings by country code. Allowed values - us, ca, all. Default — us.
Filters listings by dealer contribution amount in USD. Specify as min-max (e.g., 1000-5000).
Filters listings by MarketCheck dealer ID.
Filters listings by lease disposition fee in USD. Specify as min-max. (e.g., 0-500).
Filters finance or lease offers by down-payment amount in USD. Specify as min-max.
Filters listings by drivetrain (FWD, RWD, 4WD). Accepts multiple values separated by commas.
Filters lease offers by “due at signing” amount in USD (sum of first month, down payment, acquisition fee). Specify as min-max. (e.g., 0-500).
Filters listings by engine designation (e.g., 2.0L I4, 3.5L V6, 2.5L H4). Accepts multiple values as comma-separated list.
Sorts facet buckets. Allowed values — count (descending count, default) or index (alphabetical).
Field name to return bucket facets for. Accepts multiple fields as a comma-separated list.
Filters listings by fuel type (e.g., Unleaded, Diesel, Electric, Premium Unleaded, Electric / Unleaded). Accepts multiple values separated by commas.
Filters listings by gross capitalized cost in USD. Specify as min-max.
Latitude component of the search location (decimal degrees). Used for geospatial queries along with longitude and radius parameters.
Filters lease offers by residual value (purchase price at lease end) in USD. Specify as min-max.
Longitude component of the search location (decimal degrees). Used for geospatial queries along with latitude and radius parameters.
Filters listings by vehicle make (e.g., Toyota, Ford, Mercedes-Benz). Accepts multiple values as comma-separated list.
Filters offers by mileage limit specified in lease terms. Specify as min-max miles.
Filters listings by specific vehicle model (e.g., Camry). Accepts multiple values separated by commas.
Filters listings by monthly payment amount in USD (commonly in lease offers). Specify as min-max (e.g., 200-500).
Filters listings by Metropolitan Statistical Area (MSA) code.
Filters listings by Manufacturer's Suggested Retail Price (MSRP). Specify as min-max USD (e.g., 20000-45000).
Filters listings by net capitalized cost in USD (post-discount lease amount). Specify as min-max.
Filters incentive offers by type. Allowed values — lease, finance, cash.
Filters lease offers by per-mile surcharge for exceeding included mileage. Specify as min-max USD.
Search radius around the specified location in miles. Used with zip or latitude and longitude for geospatial queries.
Comma-separated list of numeric field names for which to return range facets in the response.
Number of results to return per request. Default — 10. Maximum — 50.
Filters listings by the first seen date. Specify as YYYYMMDD-YYYYMMDD. Alias for first_seen_range.
Full-text search within offer disclaimers.
Full-text search within offer descriptions.
Full-text search within listing titles.
Filters lease offers by security deposit amount in USD. Specify as min-max.
Field to sort results by. If omitted, defaults to distance when a location filter is used.
Specifies result sort order. Allowed values — asc or desc. Default — asc.
Filters listings by source marketplace domain (e.g., autotrader.com, cars.com).
Pagination offset (0-based). Default — 0. Maximum page is limited to 10,000/rows.
Filters listings by US or Canadian state/province code (e.g., CA, NY, ON). Accepts multiple codes separated by commas.
Comma-separated list of numeric fields for which to return aggregate statistics (mean, max, min, count).
Filters offers by last seen date. Specify as YYYYMMDD-YYYYMMDD.
Filters finance/lease offers by term length. Specify as min-max numeric value; units defined by term_unit.
Units for term_range. Allowed values — month, year.
Filters lease offers by total monthly payments over the term in USD. Specify as min-max.
Filters listings by transmission type (Automatic, Manual, etc.). Accepts multiple values separated by commas.
Filters listings by vehicle trim (e.g., EX, Limited). Accepts multiple values separated by commas.
Filters offers by “valid from” date. Specify as YYYYMMDD-YYYYMMDD.
Filters offers by “valid through” date. Specify as YYYYMMDD-YYYYMMDD.
Filters listings by model year (e.g., 2020). Accepts multiple years separated by commas.
Filters listings by model year range. Specify as min-max (e.g., 2015-2025).
Filters listings within the specified 5-digit ZIP code.
The OEM Incentive by Make and ZIP API supports all major features from the Incentive Search API with the same functionality:
interface IncentiveResponse {
num_found: number; // Total number of matching incentive programs
listings: IncentiveListing[]; // Array of incentive program details
facets?: Facets; // Field aggregations (if requested)
stats?: Stats; // Statistical analysis (if requested)
range_facets?: RangeFacets; // Range-based aggregations (if requested)
}
interface IncentiveListing {
id: string; // Unique identifier for the incentive program
base_sha: string; // Hash identifier for the incentive offer
offer: IncentiveOffer; // Detailed incentive program information
msa_code: string; // Metropolitan Statistical Area code
zip: string; // ZIP code where incentive is available
dealer_id: string; // Associated dealer identifier
source: string; // Data source of the incentive
status_date: string; // Date when incentive status was last verified
scraped_at_date: string; // Date when incentive was first discovered
city: string; // City where incentive is offered
state: string; // State where incentive is offered
country: string; // Country where incentive is offered
}
interface IncentiveOffer {
vehicles: Vehicle[]; // Eligible vehicles for the incentive
offer_type: string; // Type of incentive (cash, financing, lease)
amounts: PaymentAmount[]; // Payment amount options
due_at_signing?: number; // Amount due at contract signing
msrp?: number; // Manufacturer's Suggested Retail Price
down_payment?: number; // Required down payment amount
security_deposit?: number; // Security deposit for lease offers
acquisition_fee?: number; // Fee for initiating the finance/lease
net_cap_cost?: number; // Net capitalized cost for lease
total_monthly_payments?: number; // Sum of all monthly payments
lease_end_purchase_price?: number; // Residual value at lease end
over_mileage_fee?: number; // Fee for exceeding mileage limits
mileage_limit?: number; // Maximum allowed mileage per year
valid_from: string; // Incentive program start date
valid_through: string; // Incentive program end date
titles: string[]; // Incentive program titles
offers: string[]; // Detailed offer descriptions
disclaimers: string[]; // Legal disclaimers and terms
oem_program_name?: string; // Official OEM program name
}
interface Vehicle {
make: string; // Vehicle manufacturer
year: number; // Model year
model: string; // Vehicle model name
trim?: string; // Trim level
transmission?: string; // Transmission type
drivetrain?: string; // Drivetrain configuration
}
interface PaymentAmount {
monthly: number; // Monthly payment amount
term: number; // Payment term duration
term_unit: string; // Term unit (months, years)
}
200 OK - Returns a JSON object containing incentive programs and optional analyticsnum_found field indicating the total number of matching incentive programsnum_found will be 0 with an empty listings array| Status Code | Description | Common Causes |
|---|---|---|
| 400 | Bad Request | Invalid path parameters or query values |
| 401 | Unauthorized | Missing/invalid API key |
| 403 | Forbidden | Access denied to resource |
| 404 | Not Found | Unsupported OEM or invalid ZIP code |
| 422 | Unprocessable Entity | Invalid parameter combination |
| 429 | Too Many Requests | Rate limit exceeded |
| 500 | Internal Server Error | Temporary server issues |
| 502 | Bad Gateway | Issues with upstream services |
| 503 | Service Unavailable | API maintenance or downtime |
Error Response Format
{
"code": "<HTTP status code>",
"message": "<Error message describing the issue>"
}
Analyze all available incentive programs for a specific manufacturer within a geographic region. This is valuable for dealers, customers, and market analysts who need comprehensive incentive coverage for a particular make and location.
Example:
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/search/car/incentive/ford/90210',
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);
}
Filter incentive programs for specific vehicle models within the manufacturer's lineup using the model parameter. This enables targeted analysis of incentives for particular vehicle types.
Example:
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/search/car/incentive/toyota/10001',
params: {api_key: 'YOUR_API_KEY', model: 'camry', rows: 2},
headers: {Accept: 'application/json'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
Compare financing offers against lease deals for the same manufacturer and location using the offer_type parameter and stats functionality to analyze payment differences.
Example:
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/search/car/incentive/honda/33101',
params: {
api_key: 'YOUR_API_KEY',
rows: 2,
stats: 'monthly,apr,down_payment',
facets: 'offer_type'
},
headers: {Accept: 'application/json'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
Use the stats parameter to analyze incentive program characteristics across the manufacturer's offerings. This provides insights into payment structures, term distributions, and offer competitiveness.
Example:
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/search/car/incentive/chevrolet/60601',
params: {
api_key: 'YOUR_API_KEY',
rows: 2,
stats: 'monthly,apr,term,cashback_amount,down_payment,due_at_signing',
facets: 'offer_type,model,year',
range_facets: 'monthly|0|800|50'
},
headers: {Accept: 'application/json'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}