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 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
}

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