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.
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:
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.
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:
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/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);
}
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:
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);
}
last_seen_at, scraped_at, and first_seen_at may not match the values in search API responses due to real-time data processing.The UK RV Listing Details API returns comprehensive information about the specified recreational vehicle listing in a structured JSON format.
Success Response:
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 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 |