The RV Listing Details API retrieves detailed information about specific dealer recreational vehicle listings across United States markets. This endpoint provides complete listing data including vehicle specifications, pricing history, dealer information, media content, and marketplace details for individual listings identified by their unique listing ID.
This API is typically used as a follow-up to search operations from the Inventory Search API, which returns listing IDs for detailed retrieval.
GET https://api.marketcheck.com/v2/listing/rv/{listing_id}
Path Parameter:
listing_id
- The unique identifier for the RV listing you want to retrieve. This parameter is case-sensitive and must be provided in the URL path.The following example demonstrates how to use the RV Listing Details API to retrieve information about a specific RV listing:
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/listing/rv/6616c05355bb62eed6446c59df548892-c26d9b49-f636',
params: {api_key: 'YOUR_API_KEY'},
headers: {Accept: 'application/json'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
Explore the complete parameter options and response structure in the Request section below.
The RV Listing Details API provides access to detailed listing information using the unique listing identifier. This is typically used as a follow-up to search operations from the Inventory Search API, which returns listing IDs for detailed retrieval.
Available parameters for retrieving detailed listing information:
Your MarketCheck API authentication key. Required for every request, unless OAuth is used.
The following parameters are required for listing detail requests:
The RV Listing Details API returns comprehensive information about the specified recreational vehicle listing in a structured JSON format.
The response provides comprehensive listing details organized into logical sections:
interface Response {
id: string; // Unique listing identifier
vin: string; // Vehicle Identification Number
heading: string; // Formatted listing title
price: number; // Current listing price
price_change_percent: number; // Price change percentage from reference price
msrp: number; // Manufacturer's Suggested Retail Price (as per dealer website)
ref_price: number; // Previously listed price at same source for reference
ref_price_dt: number; // Reference price date timestamp (Unix Seconds)
miles: number; // Vehicle mileage
exterior_color: string; // Exterior color description
interior_color: string; // Interior color description
base_int_color: string; // Standardized interior color
base_ext_color: string; // Standardized exterior color
dom: number; // Days on market (lifetime)
dom_180: number; // Days on market in last 180 days
dom_active: number; // Days on market while active
dos_active: number; // Days on site while active
data_source: string; // Original data source identifier. Mostly `mc` for MarketCheck
source: string; // Data source website domain
vdp_url: string; // Vehicle detail page URL
seller_type: string; // Type of seller (dealer, fsbo, auction)
inventory_type: string; // Inventory classification (new, used)
stock_no: string; // Dealer stock number
in_transit: boolean; // Vehicle in transit status
last_seen_at: number; // Last seen timestamp (Unix Seconds), when the listing was last updated
last_seen_at_date: string; // Last seen date (ISO format)
scraped_at: number; // First seen timestamp (Unix Seconds), when the listing was first scraped
scraped_at_date: string; // First seen date (ISO format)
first_seen_at: number; // First seen timestamp (Unix Seconds), when the listing was first seen. Copy of `scraped_at` field
first_seen_at_date: string; // First seen date (ISO format)
first_seen_at_mc: number; // First seen at MarketCheck timestamp (Unix Seconds)
first_seen_at_mc_date: string; // First seen at MarketCheck date (ISO format)
first_seen_at_source: number; // First seen at source website timestamp (Unix Seconds)
first_seen_at_source_date: string; // First seen at source website date (ISO format)
car_location: CarLocation; // Vehicle/dealer location details
media: Media; // Photos and media content links
extra: Extra; // Additional features and options
dealer: Dealer; // Dealer information
mc_dealership: McDealership; // Enhanced dealer information from MarketCheck's new dealership system
build: Build; // RV specifications
}
interface CarLocation {
seller_name: string; // Dealer or seller name
street: string; // Street address
city: string; // City name
zip: string; // Postal/ZIP code
state: string; // State or province
latitude: string; // Geographic latitude
longitude: string; // Geographic longitude
}
interface Media {
photo_links: string[]; // Array of photo URLs from dealer website
floorplan_image_link: string[]; // Floorplan image URL if available
}
interface Extra {
options: string[]; // RV options list
features: string[]; // RV features list
seller_comments: string; // Dealer/seller description text
high_value_features: string[]; // Premium/luxury RV features
options_packages: string[]; // Factory option packages
}
interface Dealer {
id: number; // Unique dealer identifier
website: string; // Dealer website URL
name: string; // Dealer business name
dealer_type: string; // Dealer classification (franchise, independent)
dealership_group_name: string; // Parent dealership group
street: string; // Street address
city: string; // City name
state: string; // State or province
country: string; // Country code
zip: string; // Postal/ZIP code
latitude: string; // Geographic latitude
longitude: string; // Geographic longitude
msa_code: string; // Metropolitan Statistical Area code
phone: string; // Contact phone number
seller_email: string; // Contact email address
}
interface Build {
year: number; // Model year
make: string; // RV manufacturer
model: string; // RV model
trim: string; // Trim level
version: string; // Specific version/variant
body_type: string; // Body style (Class A, Class B, Travel Trailer, etc.)
vehicle_type: string; // Vehicle category (RV)
rv_type: string; // RV type classification
transmission: string; // Transmission type
drivetrain: string; // Drivetrain configuration
fuel_type: string; // Fuel type (gasoline, diesel, N/A for towables)
doors: number; // Number of doors
made_in: string; // Manufacturing country
overall_height: string; // RV height
overall_length: string; // RV length
overall_width: string; // RV width
std_seating: string; // Standard seating capacity
highway_mpg: number; // Highway fuel economy (motorhomes only)
city_mpg: number; // City fuel economy (motorhomes only)
powertrain_type: string; // Powertrain classification
engine: string; // Engine specification
chassis: string; // Chassis information
class: string; // RV class (Class A, Class B, Class C, Travel Trailer, etc.)
slideouts: string; // Number of slideouts
sleeps: string; // Sleeping capacity
length: string; // RV length
gvwr: string; // Gross Vehicle Weight Rating
fresh_water_capacity: string; // Fresh water tank capacity
grey_water_capacity: string; // Grey water tank capacity
black_water_capacity: string; // Black water tank capacity
}
Status Code | Description | Common Causes |
---|---|---|
400 | Bad Request | Invalid parameter values |
401 | Unauthorized | Missing/invalid API key |
403 | Forbidden | Access denied to resource |
422 | Unprocessable Entity | Invalid listing_id |
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 |
Retrieve detailed vehicle information for display on RV detail pages, customer applications, or internal dealer management systems. This API provides all the data typically shown on a dealer's RV detail page (VDP).
Example:
Here we're retrieving complete details for a specific RV listing including specifications, pricing, dealer information, and media content:
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/listing/rv/6616c05355bb62eed6446c59df548892-c26d9b49-f636',
params: {api_key: 'YOUR_API_KEY'},
headers: {Accept: 'application/json'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
After performing searches using the Inventory Search API, use the returned listing IDs to fetch complete RV details for selected listings.
Example:
Here we're retrieving detailed information for an RV listing discovered through inventory search:
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/listing/rv/27d31fcd086aa92faa4a626a22bf80db-5d110d3c-08a3',
params: {api_key: 'YOUR_API_KEY'},
headers: {Accept: 'application/json'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
For applications with access to MarketCheck data feeds, use listing IDs from feed data to retrieve real-time detailed information about specific RVs.
Example:
Here we're retrieving listing details using a listing ID from a data feed integration:
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/listing/rv/6011a81375af5bba127c871574ea5b6e-f6ec90f3-7ad0',
params: {api_key: 'YOUR_API_KEY'},
headers: {Accept: 'application/json'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
last_seen_at
, scraped_at
, and first_seen_at
may not match the values in search API responses due to real-time data processing.