RV Listing Details

Retrieve detailed information about specific UK 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 Listing Details API retrieves detailed information about specific dealer recreational vehicle listings across the United Kingdom market. 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/uk/{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/uk/4851c44c3371be28fa3d73e5789290d87231edbc8f011ab485bc17f28984947d58c2a54aabb2156e15e48485027d9631',
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

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/uk/4851c44c3371be28fa3d73e5789290d87231edbc8f011ab485bc17f28984947d58c2a54aabb2156e15e48485027d9631',
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 a RV listing discovered through inventory search:

request.js
import axios from 'axios';

const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/listing/rv/uk/5e26509baf03b28274d8041da8f6f0d8466698ce92fb50c3e54ec06848a6a4c55155ae97da94540a593b97f3c43ef332',
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.

Response

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

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

Response Schema

The response provides comprehensive listing details organised into logical sections:

interface RVSearchResponse {
  listings: RVListing[]; // Array of vehicle listings
}

interface RVListing {
  id: string; // Unique listing identifier
  heading: string; // Formatted listing title
  price: number; // Current listing price
  miles: number; // Vehicle mileage
  vdp_url: string; // Vehicle detail page URL
  seller_type: string; // Type of seller (dealer, fsbo, auction)
  inventory_type: string; // Inventory classification (new, used)
  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)
  source: string; // Data source website domain
  miles_indicator: string; // Mileage unit indicator
  currency_indicator: string; // Currency unit indicator
  motorhome_build: string; // Motorhome build specifications
  origin: string; // Vehicle origin information
  media: RVMedia; // Photos and media content links
  extras: RVExtras; // Additional features and options
  dealer: RVDealer; // Dealer information
  build: RVBuild; // Vehicle specifications
}

interface RVMedia {
  photo_links: string[]; // Array of photo URLs from dealer website
  floorplan_image_link?: string; // Floorplan image URL
}

interface RVExtras {
  options: string[]; // Array of additional features and options
}

interface RVDealer {
  id: number; // Unique dealer identifier
  website: string; // Dealer website URL
  name: string; // Dealer business name
  street: string; // Street address
  city: string; // City name
  county: string; // County name
  country: string; // Country code
  latitude: string; // Geographic latitude
  longitude: string; // Geographic longitude
  zip: string; // Postal/ZIP code
  phone: string; // Contact phone number
}

interface RVBuild {
  year: number; // Model year
  make: string; // Vehicle manufacturer
  model: string; // Vehicle model
  transmission: string; // Transmission type
  fuel_type: string; // Fuel type (gasoline, electric, hybrid, etc.)
  engine: string; // Engine description
  drive_type: string; // Drive type configuration
  chassis: string; // Chassis specifications
  berths: string; // Sleeping capacity
  exterior_length?: string; // Vehicle length
  mtplm?: string; // Maximum Technically Permissible Laden Mass
  steering: string; // Steering configuration
  category: string; // Vehicle category
}

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

See Also