The Marketplace Inventory Syndication API is an extension of the Dealership Inventory Syndication API that provides dealer inventory data formatted specifically for various automotive marketplace platforms. This specialized endpoint transforms the standard dealership inventory response into marketplace-optimized formats, ensuring data structure and content compatibility with each supported platform's unique requirements and specifications.
GET https://api.marketcheck.com/v2/dealerships/inventory/marketplaces/{marketplace_name}
Supported Marketplaces:
| Marketplace | Parameter Value | Description |
|---|---|---|
| Facebook Automotive Ads | facebook | Format optimized for Facebook's automotive advertising platform |
| Google Vehicle Ads Feed | google-va-feed | Format compatible with Google's Vehicle Ads feed requirements |
The following examples demonstrate basic requests for each supported marketplace:
Facebook Automotive Ads:
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/dealerships/inventory/marketplaces/facebook',
params: {api_key: 'YOUR_API_KEY', dealer_id: '1015993', car_type: 'certified', rows: 5},
headers: {Accept: 'application/json'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
Google Vehicle Ads Feed:
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/dealerships/inventory/marketplaces/google-va-feed',
params: {api_key: 'YOUR_API_KEY', mc_website_id: '1022299', owned: true, rows: 10},
headers: {Accept: 'application/json'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
The Marketplace Inventory Syndication API requires both marketplace identification and dealer identification parameters, with optional filtering and configuration parameters. This endpoint shares the same core functionality as the Dealership Inventory Syndication API, with additional marketplace-specific formatting.
Path Parameter:
marketplace_name - The marketplace platform identifier for formatting the response. This parameter is case-sensitive and must be provided in the URL path.
facebook or google-va-feedAvailable parameters for filtering, sorting, and configuring search results:
Your MarketCheck API authentication key. Required for every request, unless OAuth is used.
If true, the response URLs (such as cached images & relevant links) include the api_key query parameter along with value; if false, they do not. Default — true.
The base exterior color to filter results by (e.g. White, Black, Blue, Silver, Red). Accepts multiple colors as a comma-separated list.
Alias for base_ext_color. Filters by base exterior color (comma-separated list).
The base interior color to filter results by (e.g. Black, Brown, Beige, Red). Accepts multiple colors as a comma-separated list.
Alias for base_int_color. Filters by base interior color (comma-separated list).
Filters listings by body subtype (e.g., Crew, Extended, Regular, Extended Crew). Accepts multiple values separated by commas.
Filters listings by body type (e.g., SUV, Pickup, Sedan, Hatchback, Convertible). Accepts multiple values separated by commas.
Filters listings by inventory type. Allowed values - new, used, certified.
Filters listings by city name (e.g. Los Angeles, San Francisco, Houston).
Filters listings by city fuel-economy mileage. Specify as min-max MPG (e.g., 20-35).
Filters listings by country code. Allowed values - us, ca, all. Default — us.
Filters listings by engine cylinder count (e.g., 4, 6, 8). Accepts multiple values as a comma-separated list.
Filters listings by MarketCheck dealer ID.
Filters listings by dealer name (case-insensitive complete match, substring not supported).
Filters dealers by type. Allowed values — franchise, independent.
Filters listings by the name of the dealership group. Accepts multiple values as a comma-separated list.
Filters listings by Days on Market observed over the last 180 days. Specify as min-max days (e.g., 10-50).
Filters listings by active Days on Market (DOM). Specify as min-max days.
Filters listings by total Days on Market (DOM). Specify as min-max days.
Filters listings by number of doors (e.g., 2, 4). Accepts multiple values as comma-separated list.
Filters listings by active Days on Site (DOS). Specify as min-max days.
Filters listings by drivetrain (FWD, RWD, 4WD). Accepts multiple values separated by commas.
Filters listings by engine designation (e.g., 2.0L I4, 3.5L V6, 2.5L H4). Accepts multiple values as comma-separated list.
Filters listings by engine aspiration (Turbocharged, Naturally Aspirated, etc.). Accepts multiple values separated by commas.
Filters listings by engine block layout (V, I, H). Accepts multiple values separated by commas.
Filters listings by engine displacement size (e.g., 2.0, 2.5, 3.5). Accepts multiple values separated by commas.
Filters listings by engine displacement size. Specify as min-max liters (e.g., 1.5-3.0).
Filters listings by exterior color (e.g. White, Summit White, Gun Metallic). 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 the number of days since they were first seen by MarketCheck. Specify as min-max days. Alternative of first_seen_at_mc_range.
Filters listings by the date they were first seen by MarketCheck. Specify as YYYYMMDD-YYYYMMDD (e.g., 20220523-20220631). Alternative of first_seen_at_mc_days.
Filters listings by the number of days since first seen on the source site. Specify as min-max days. Alternative of first_seen_at_source_range.
Filters listings by date first seen on the source site. Specify as YYYYMMDD-YYYYMMDD. Alternative of first_seen_at_source_days.
Filters listings by the number of days since they were first seen in MarketCheck inventory. Specify as min-max days. Alternative of first_seen_range.
Filters listings by the first seen date. Specify as YYYYMMDD-YYYYMMDD (e.g., 20220523-20220631). Alternative of first_seen_days.
Filters listings by fuel type (e.g., Unleaded, Diesel, Electric, Premium Unleaded, Electric / Unleaded). Accepts multiple values separated by commas.
Filters listings by highway fuel-economy mileage. Specify as min-max MPG (e.g., 25-40).
If true, returns listings marked as in transit; if false or omitted, no in-transit filter is applied.
If true, includes listings without a VIN; if false, such listings are excluded. Default — false.
If true, includes relevant links to other MarketCheck API endpoints in the response. Default — false.
Filters listings by interior color. Accepts multiple values as comma-separated list.
Filters listings by the number of days since last seen. Specify as min-max days. Alternative of last_seen_at_range.
Filters listings by last seen date. Specify as YYYYMMDD-YYYYMMDD (e.g., 20220523-20220631). Alternative of last_seen_at_days.
Filters listings by vehicle make (e.g., Toyota, Ford, Mercedes-Benz). Accepts multiple values as comma-separated list.
Filters listings by MarketCheck category code.
Filters listings by MarketCheck dealer ID.
Filters listings by MarketCheck dealership group ID.
Filters listings by dealership group name.
Filters listings by MarketCheck location ID.
Filters listings by MarketCheck rooftop ID.
Filters listings by MarketCheck sub-dealership group ID.
Filters listings by sub-dealership group name.
Filters listings by MarketCheck website ID.
Filters listings by odometer reading. Specify as min-max miles (e.g., 1000-50000).
Filters listings with at least the specified number of photo links (e.g. 3, 8).
Filters listings with at least the specified number of cached photo links (e.g. 3, 8).
Filters listings by specific vehicle model (e.g., Camry). Accepts multiple values separated by commas.
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).
When used with dealer_id, mc_website_id, or source, true returns listings actually owned by that dealer. Default — false.
If true, returns only listings that contain at least one photo link. Default — false.
If true, returns only listings that contain cached photo links. Default — false.
Filters listings by powertrain type (e.g., Combustion, BEV, HEV, MHEV, PHEV). Accepts multiple values separated by commas.
Filters listings by advertised price in USD. Specify as min-max (e.g., 1000-50000).
Comma-separated list of numeric field names for which to return range facets in the response.
Number of results to return per request. Default — 1500. Maximum — 1500.
Filters listings by seating capacity (e.g., 2, 5, 7). Accepts multiple values separated by commas.
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 listings by dealer stock number.
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 listings by vehicle type (Truck, Car). Accepts multiple values separated by commas.
Filters listings by vehicle version name.
Filters listings by full 17-character Vehicle Identification Number (VIN).
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.
1500 (maximum allowed)false - includes all syndicated listings including non-attributed
true to retrieve only Attributed (Searchable) listings representing physically present dealer inventoryMarketplace Inventory Syndication API supports the same pagination capabilities as the Dealership Inventory Syndication API. API response includes num_found property indicating the total number of listings matching the search criteria.
Parameters:
start - Offset from which listings are returned (starts at 0)rows - Number of listings per page (maximum 1,500, default 1,500)Refer to the Dealership Inventory Syndication API pagination documentation for complete details and examples.
The Marketplace Inventory Syndication API supports sorting results by a single numeric or date field at a time, with the same functionality as the Dealership Inventory Syndication API.
Sort Parameters:
sort_by - Field name to sort bysort_order - Sort direction (asc or desc)Refer to the Dealership Inventory Syndication API sorting documentation for complete field reference and examples.
Marketplace Inventory Syndication supports all major features from the Dealership Inventory Syndication API with identical functionality:
The base response schema for Dealership Inventory Syndication for Marketplaces follows the same structure as the Dealership Inventory Syndication API, with marketplace-specific formatting applied to individual listing fields. The response structure varies by marketplace to optimize compatibility with each platform's requirements.
interface MarketplaceInventoryResponse {
num_found: number; // Total number of listings matching search criteria
listings: FacebookListing[] | GoogleVAListing[]; // Array of marketplace-specific listings
facets?: Facets; // Categorical facets (when facets parameter is used)
stats?: Stats; // Statistical data (when stats parameter is used)
range_facets?: RangeFacets; // Range-based facets (when range_facets parameter is used)
}
interface FacebookListing {
vehicle_id: string; // Facebook-optimized listing identifier
vin: string; // Vehicle identification number
url: string; // Direct link to vehicle listing page
title: string; // Vehicle listing title
year: number; // Model year
make: string; // Vehicle manufacturer
model: string; // Vehicle model name
trim?: string; // Vehicle trim level
price: string; // Price (-1 indicates no price available)
exterior_color?: string; // Vehicle exterior color
interior_color?: string; // Vehicle interior color
state_of_vehicle?: string; // Vehicle state (e.g., "CPO" for Certified Pre-Owned)
body_style?: string; // Vehicle body style
description: string; // Detailed vehicle description
mileage: {
value: number; // Mileage numeric value (-1 indicates no mileage available)
unit: string; // Mileage unit (e.g., "MI")
};
image: Array<{
url: string; // Image URL
tag: string[]; // Image tags/categories
}>;
vehicle_type?: string; // Vehicle type classification
drivetrain?: string; // Drivetrain type
fuel_type?: string; // Fuel type
transmission?: string; // Transmission type
availability: string; // Stock availability status
date_first_on_lot?: string; // Date first seen on lot (ISO date)
days_on_lot?: number; // Number of days on lot
address?: {
addr1: string; // Street address
city: string; // City name
region: string; // State/region
country: string; // Country code
postal_code: string; // ZIP/postal code
};
latitude?: string; // Geographic latitude
longitude?: string; // Geographic longitude
dealer_name: string; // Dealership name
dealer_id: string; // Dealer identifier
}
interface GoogleVAListing {
id: string; // Google VA Feed listing identifier
VIN: string; // Vehicle identification number (uppercase)
link: string; // Direct link to vehicle listing page
link_template: string; // URL template for the vehicle listing - typically identical to link field
title: string; // Vehicle listing title
year: number; // Model year
brand: string; // Vehicle manufacturer/brand
model: string; // Vehicle model name
trim?: string; // Vehicle trim level
price: string; // Price with currency (e.g., "34771 USD") (-1 indicates no price available)
vehicle_msrp?: string; // MSRP with currency (e.g., "34771 USD")
mileage: string; // Mileage with units (e.g., "45 Miles") (-1 indicates no mileage available)
color?: string; // Vehicle color
condition: string; // Vehicle condition (e.g., "Used", "New")
image_link: string; // Primary image URL
google_product_category: string; // Google product category code
vehicle_fulfillment: string; // Fulfillment method (e.g., "in_store")
vehicle_price_type: string; // Price type (e.g., "all_in_price")
description: string; // Detailed vehicle description
certified_pre-owned?: string; // Certified pre-owned status ("yes"/"no")
body_style?: string; // Vehicle body style
engine?: string; // Engine type (e.g., "gasoline")
additional_image_link?: string[]; // Array of additional image URLs
store_code?: string; // Dealer store code - MarketCheck assigns unique dealer ID value to this field
included_destination?: string; // Destination platform identifier
}
car_type=certified parameter to filter for certified pre-owned listings only. These are subset of used vehicles-1 indicates that the information is not available for that listing. Ensure to handle these cases appropriately in your application.Example:
Here we're finding dealer certified pre-owned inventory for Facebook Automotive Ads using dealer ID:
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/dealerships/inventory/marketplaces/facebook',
params: {api_key: 'YOUR_API_KEY', dealer_id: '1015993', car_type: 'certified', rows: 5},
headers: {Accept: 'application/json'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
owned=true parameter to filter for dealer-attributed listings onlynew and used inventory typesstore_code field for marketplace compatibilityExample:
Here we're finding dealer-owned inventory for Google Vehicle Ads Feed using mc_website_id:
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/dealerships/inventory/marketplaces/google-va-feed',
params: {api_key: 'YOUR_API_KEY', mc_website_id: '1022299', owned: true, rows: 10},
headers: {Accept: 'application/json'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
in_transit parameternew inventory typeExample:
Here we're finding dealer in-transit inventory for Facebook Automotive Ads using dealership website domain:
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/dealerships/inventory/marketplaces/facebook',
params: {
api_key: 'YOUR_API_KEY',
source: 'muller-honda.com',
car_type: 'new',
in_transit: 'true',
rows: 10
},
headers: {Accept: 'application/json'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
Dealership Inventory Syndication
Retrieve active dealer inventory listings for syndication purposes with enhanced pagination and filtering capabilities.
Dealers Search
Search through MarketCheck's dealer directory from the US and Canada using various criteria like location, dealer type, and inventory characteristics