Cars / Incentives

OEM Incentive by Make and ZIP

get/search/car/incentive/{make}/{zip}

Request

  • Base URL: https://api.marketcheck.com/v2
  • URL: https://api.marketcheck.com/v2/search/car/incentive/{make}/{zip}
  • Auth: API key in query parameter api_key

Path parameters

makestring required
zipstring required

Query parameters

acquisition_fee_rangestring

Filters listings by acquisition fee amount. Specify as min-max in USD (e.g., 500-1500).

apr_rangestring

Filters listings by Annual Percentage Rate (APR). Specify as min-max (e.g., 0-9.99).

base_shastring

The SHA-256 hash of an incentive offer used as the comparison baseline.

cashback_amount_rangestring

Filters listings by cashback amount specified in the offer. Specify as min-max in USD.

cashback_target_groupstring

Filters cashback offers by target group (e.g. Military personnel, College graduates). Accepts multiple groups as comma-separated values.

citystring

Filters listings by city name (e.g. Los Angeles, San Francisco, Houston).

countrystring

Filters listings by country code. Allowed values - us, ca, all. Default — us.

dealer_contribution_rangestring

Filters listings by dealer contribution amount in USD. Specify as min-max (e.g., 1000-5000).

dealer_idstring

Filters listings by MarketCheck dealer ID.

disposition_fee_rangestring

Filters listings by lease disposition fee in USD. Specify as min-max. (e.g., 0-500).

down_payment_rangestring

Filters finance or lease offers by down-payment amount in USD. Specify as min-max.

drivetrainstring

Filters listings by drivetrain (FWD, RWD, 4WD). Accepts multiple values separated by commas.

due_at_signing_rangestring

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

enginestring

Filters listings by engine designation (e.g., 2.0L I4, 3.5L V6, 2.5L H4). Accepts multiple values as comma-separated list.

facet_sortstring

Sorts facet buckets. Allowed values — count (descending count, default) or index (alphabetical).

facetsstring

Field name to return bucket facets for. Accepts multiple fields as a comma-separated list.

fuel_typestring

Filters listings by fuel type (e.g., Unleaded, Diesel, Electric, Premium Unleaded, Electric / Unleaded). Accepts multiple values separated by commas.

body_typestring

Filters listings by body type (e.g., SUV, Pickup, Sedan, Hatchback, Convertible). Accepts multiple values separated by commas.

gross_cap_cost_rangestring

Filters listings by gross capitalized cost in USD. Specify as min-max.

latitudestring

Latitude component of the search location (decimal degrees). Used for geospatial queries along with longitude and radius parameters.

lease_end_purchase_price_rangestring

Filters lease offers by residual value (purchase price at lease end) in USD. Specify as min-max.

longitudestring

Longitude component of the search location (decimal degrees). Used for geospatial queries along with latitude and radius parameters.

makestring

Filters listings by vehicle make (e.g., Toyota, Ford, Mercedes-Benz). Accepts multiple values as comma-separated list.

mileage_limit_rangestring

Filters offers by mileage limit specified in lease terms. Specify as min-max miles.

modelstring

Filters listings by specific vehicle model (e.g., Camry). Accepts multiple values separated by commas.

monthly_rangenumber

Filters listings by monthly payment amount in USD (commonly in lease offers). Specify as min-max (e.g., 200-500).

msa_codestring

Filters listings by Metropolitan Statistical Area (MSA) code.

msrp_rangestring

Filters listings by Manufacturer's Suggested Retail Price (MSRP). Specify as min-max USD (e.g., 20000-45000).

net_cap_cost_rangenumber

Filters listings by net capitalized cost in USD (post-discount lease amount). Specify as min-max.

offer_typestring

Filters incentive offers by type. Allowed values — lease, finance, cash.

over_mileage_fee_rangenumber

Filters lease offers by per-mile surcharge for exceeding included mileage. Specify as min-max USD.

radiusinteger

Search radius around the specified location in miles. Used with zip or latitude and longitude for geospatial queries.

range_facetsstring

Comma-separated list of numeric field names for which to return range facets in the response.

rowsinteger

Number of results to return per request. Default — 10. Maximum — 50.

scraped_at_date_rangestring

Filters listings by the first seen date. Specify as YYYYMMDD-YYYYMMDD. Alias for first_seen_range.

search_disclaimers_textstring

Full-text search within offer disclaimers.

search_offers_textstring

Full-text search within offer descriptions.

search_titles_textstring

Full-text search within listing titles.

security_deposit_rangenumber

Filters lease offers by security deposit amount in USD. Specify as min-max.

sort_bystring

Field to sort results by. If omitted, defaults to distance when a location filter is used.

sort_orderstring

Specifies result sort order. Allowed values — asc or desc. Default — asc.

sourcestring

Filters listings by website domain (e.g., autotrader.com, cars.com).

startinteger

Pagination offset (0-based). Default — 0. Maximum page is limited to 10,000/rows.

statestring

Filters listings by US or Canadian state/province code (e.g., CA, NY, ON). Accepts multiple codes separated by commas.

statsstring

Comma-separated list of numeric fields for which to return aggregate statistics (mean, max, min, count).

status_date_rangestring

Filters offers by last seen date. Specify as YYYYMMDD-YYYYMMDD.

term_rangenumber

Filters finance/lease offers by term length. Specify as min-max numeric value; units defined by term_unit.

term_unitstring

Units for term_range. Allowed values — month, year.

total_monthly_payments_rangenumber

Filters lease offers by total monthly payments over the term in USD. Specify as min-max.

transmissionstring

Filters listings by transmission type (Automatic, Manual, etc.). Accepts multiple values separated by commas.

trimstring

Filters listings by vehicle trim (e.g., EX, Limited). Accepts multiple values separated by commas.

valid_from_rangestring

Filters offers by “valid from” date. Specify as YYYYMMDD-YYYYMMDD.

valid_through_rangestring

Filters offers by “valid through” date. Specify as YYYYMMDD-YYYYMMDD.

yearstring

Filters listings by model year (e.g., 2020). Accepts multiple years separated by commas.

year_rangestring

Filters listings by model year range. Specify as min-max (e.g., 2015-2025).

zipstring

Filters listings within the specified 5-digit ZIP code.

photo_linksboolean

If true, returns only listings that contain at least one photo link. Default — false.

Response

Successful response. See the linked documentation page for the full field reference.

Changes

No recorded changes to this operation across all 1 revision of this API.