RV Listing Details

Retrieve detailed information about specific dealer RV listings with complete vehicle specifications, media content, dealer information, and marketplace data.
Limited Support Warning: RV APIs is maintained less frequently than our primary cars dataset, with reduced priority and support. Data quality, coverage, and feature updates may be less comprehensive and occur less often than in our core automotive offerings.

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.

Base Path

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:

request.js
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.

Request

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.

Parameters

Available parameters for retrieving detailed listing information:

1 Params
api_key
string required

Your MarketCheck API authentication key. Required for every request, unless OAuth is used.

Required Parameters

The following parameters are required for listing detail requests:

  • listing_id - The unique identifier for the RV listing (provided in URL path)
    • Case-sensitive string identifier returned from search APIs or data feeds
    • Must be provided as a path parameter in the URL structure

Response

The RV Listing Details API returns comprehensive information about the specified recreational vehicle listing in a structured JSON format.

Schema

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
}

Success Response

  • 200 OK - Returns detailed JSON object with complete listing information
  • Includes RV specifications, pricing data, dealer information, media content, and marketplace metadata
  • Provides rich data suitable for RV detail page display and detailed analysis

Error Response

Status CodeDescriptionCommon Causes
400Bad RequestInvalid parameter values
401UnauthorizedMissing/invalid API key
403ForbiddenAccess denied to resource
422Unprocessable EntityInvalid listing_id
429Too Many RequestsRate limit exceeded
500Internal Server ErrorTemporary server issues
502Bad GatewayIssues with upstream services
503Service UnavailableAPI maintenance or downtime

Use Cases & Examples

Detailed Vehicle Information Display

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:

request.js
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);
}

Post-Search Detail Retrieval

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:

request.js
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);
}

Data Feed Integration

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:

request.js
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);
}
This data is fetched directly from MarketCheck's main database, which is updated continuously as crawl progresses. Some fields like last_seen_at, scraped_at, and first_seen_at may not match the values in search API responses due to real-time data processing.

See Also