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 identifier representing a specific listing from the Marketcheck database
vin?: string; // VIN for the RV
heading?: string; // Listing title as displayed on the source website
price?: number; // Asking price for the RV
miles?: number; // Odometer reading / reported miles usage for the RV
msrp?: number; // MSRP for the RV
vdp_url?: string; // Vehicle detail page URL of the specific RV
exterior_color?: string; // Exterior color of the RV
base_int_color?: string; // Standardized interior color
base_ext_color?: string; // Standardized exterior color
interior_color?: string; // Interior color of the RV
seller_type?: string; // Seller type for the RV
inventory_type?: string; // Inventory type of RV
stock_no?: string; // Stock number of RV in dealers inventory
last_seen_at?: number; // Listing last seen at (most recent) timestamp
last_seen_at_date?: string; // Listing last seen at (most recent) date
scraped_at?: number; // Listing last seen at date timestamp
scraped_at_date?: string; // Listing last seen at date
first_seen_at?: number; // Listing first seen at first scraped timestamp
first_seen_at_date?: string; // Listing first seen at first scraped date
source?: string; // Source domain of the listing
media?: Media; // Photos and media content links
extra?: Extra; // Additional features and options
dealer?: Dealer; // Dealer information
build?: Build; // RV specifications
}
interface Media {
photo_links?: string[]; // A list of photo urls for the RV
floorplan_image_link?: string; // Floorplan image URL if available
}
interface Extra {
options?: string[]; // Installed Options of the RV
features?: string[]; // List of Features available with the RV
seller_comments?: string; // Seller comments for the RV
}
interface Dealer {
id: number; // The unique id associated with the dealer in the Marketcheck database
name?: string; // Name of the dealer
website?: string; // Website of the dealer
dealer_type?: string; // Type of dealer (franchise/independent)
dealership_group_name?: string; // Dealership group name of dealer
street?: string; // Street of the dealer
city?: string; // City of the dealer
state?: string; // State of the dealer
country?: string; // Country of the dealer
zip?: string; // Zip of the dealer
msa_code?: string; // MSA code of the dealer
latitude?: string; // Latitude for the dealer location
longitude?: string; // Longitude for the dealer location
phone?: string; // Contact no of the dealer
seller_email?: string; // Contact email of the dealer
}
interface Build {
year?: number; // Year of the RV
make?: string; // RV Make
model?: string; // RV model
model_o?: string; // Manufacturer model code
trim?: string; // Trim level
class?: string; // RV class (Class A, Class B, Class C, Travel Trailer, etc.)
slideouts?: string; // Number of slideouts
sleeps?: string; // Sleeping capacity
body_type?: string; // Body type of the RV
body_subtype?: string; // Body subtype of the RV
vehicle_type?: string; // Vehicle type of the RV
condition?: string; // Condition of the RV (new/used)
category?: string; // Category of the RV
sub_category?: string; // Sub category of the RV
drivetrain?: string; // Drivetrain of the RV
engine_size?: string; // Engine size of the RV
engine_block?: string; // Engine block type of the RV
doors?: string; // Number of doors
cylinders?: string; // Number of cylinders
transmission?: string; // Transmission type
height?: string; // Height of the RV
fuel_type?: string; // Fuel type (gasoline, electric, hybrid, etc.)
engine?: string; // Engine description
area?: string; // Area of the RV
length?: string; // Overall length (e.g., "37'8\"")
made_in?: string; // Made in of the RV
gvwr?: string; // Gross Vehicle Weight Rating
overall_height?: string; // Overall height of the RV
overall_width?: string; // Overall width of the RV
std_seating?: string; // Standard seating capacity of the RV
curb_weight?: string; // Curb weight of the RV
highway_mpg?: number; // Highway miles per gallon
city_mpg?: number; // City miles per gallon
payload_capacity?: string; // Payload capacity of the RV
hitch_weight?: string; // Hitch weight of the RV
dry_weight?: string; // Dry weight of the RV
interior_height?: string; // Interior height of the RV
exterior_height?: string; // Exterior height of the RV
fresh_water_capacity?: string; // Fresh water tank capacity
black_water_capacity?: string; // Black water tank capacity
grey_water_capacity?: string; // Grey water tank capacity
seating_capacity?: string; // Seating capacity of the RV
number_of_air_conditioners?: string; // Number of air conditioners
air_conditioners_size?: string; // Size of air conditioners
number_of_awnings?: string; // Number of awnings
awnings_size?: string; // Size of awnings
sleeping_capacity?: string; // Sleeping capacity of the RV
slideout_type?: string; // Type of slideouts
leveling_jacks_type?: string; // Type of leveling jacks
wheelbase?: string; // Wheelbase of the RV
number_of_bunk_beds?: string; // Number of bunk beds
bunkhouse_type?: string; // Type of bunkhouse
number_of_full_baths?: string; // Number of full bathrooms
bed_type?: string; // Type of bed
refrigerator_type?: string; // Type of refrigerator
refrigerator_dimensions?: string; // Dimensions of refrigerator
living_area?: string; // Living area of the RV
outdoor_kitchen?: string; // Outdoor kitchen features
dining_type?: string; // Type of dining area
kitchen?: string; // Kitchen features
outdoor_entertainment?: string; // Outdoor entertainment features
engine_configuration?: string; // Engine configuration
furnace_volume?: string; // Volume of furnace
convertor_size?: string; // Size of convertor
furnace_type?: string; // Type of furnace
engine_make?: string; // Engine manufacturer
engine_model?: string; // Engine model
generator?: string; // Generator specifications
cooling?: string; // Cooling system
fuel_capacity?: string; // Fuel tank capacity
number_of_speeds?: string; // Number of speeds
storage_capacity?: string; // Storage capacity
fuel_requirements?: string; // Fuel requirements
engine_stroke?: string; // Engine stroke
drive_type?: string; // Drive type
horsepower?: string; // Horsepower
starter?: string; // Starter type
torque?: string; // Torque
speeds?: string; // Transmission speeds
towing_capacity?: string; // Towing capacity
chassis?: string; // Chassis type (Ford F53, Freightliner, etc.)
axle?: string; // Axle specifications
number_of_oven_burners?: string; // Number of oven burners
engine_displacement?: string; // Engine displacement
lp_tank_capacity?: string; // LP tank capacity
exterior_width?: string; // Exterior width
cargo_capacity?: string; // Cargo capacity
engine_torque?: string; // Engine torque
water_heater?: string; // Water heater specifications
width?: string; // Width of the RV
floorplan_layout?: string; // Floorplan layout
engine_type?: string; // Engine type
floorplan?: string; // Floorplan
weight?: string; // Weight of the RV
}
| 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.