Cars / Incentives

OEM Incentive Search: Pagination

get/search/car/incentive/oem

Request

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

Query parameters

makestring

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

modelstring

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

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

trimstring

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

statestring

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

citystring

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

zipstring

Filters listings within the specified 5-digit ZIP code.

msa_codestring

Filters listings by Metropolitan Statistical Area (MSA) code.

latitudestring

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

longitudestring

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

radiusinteger

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

offer_typestring

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

monthly_rangenumber

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

apr_rangestring

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

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.

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.

down_payment_rangestring

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

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

msrp_rangestring

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

security_deposit_rangenumber

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

acquisition_fee_rangestring

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

disposition_fee_rangestring

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

dealer_contribution_rangestring

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

total_monthly_payments_rangenumber

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

mileage_limit_rangestring

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

over_mileage_fee_rangenumber

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

lease_end_purchase_price_rangestring

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

net_cap_cost_rangenumber

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

gross_cap_cost_rangestring

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

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.

status_date_rangestring

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

scraped_at_date_rangestring

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

drivetrainstring

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

transmissionstring

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

enginestring

Filters listings by engine designation (e.g., 2.0L I4, 3.5L V6, 2.5L H4). Accepts multiple values as 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.

dealer_idstring

Filters listings by MarketCheck dealer ID.

sourcestring

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

search_titles_textstring

Full-text search within listing titles.

search_offers_textstring

Full-text search within offer descriptions.

search_disclaimers_textstring

Full-text search within offer disclaimers.

base_shastring

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

countrystring

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

facetsstring

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

facet_sortstring

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

range_facetsstring

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

statsstring

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

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.

startinteger

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

rowsinteger

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

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.