Motorcycle Listing Details

The Motorcycle Listing Details API retrieves detailed information about specific dealer motorcycle 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/motorcycle/{listing_id}

Path Parameter:

• listing_id - The unique identifier for the motorcycle 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 Motorcycle Listing Details API to retrieve information about a specific motorcycle listing:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/listing/motorcycle/3ae003289b296bea3bfe266386835525-fa26db97-428f',
  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 Motorcycle 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:

Required Parameters

The following parameters are required for listing detail requests:

• listing_id - The unique identifier for the motorcycle 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 Motorcycle Listing Details API returns comprehensive information about the specified motorcycle listing in a structured JSON format.

Schema

The response provides comprehensive listing details organized into logical sections:

interface Response {
  id: string; // Unique listing identifier
  heading: string; // Formatted listing title
  vin: string; // Vehicle Identification Number (VIN)
  price?: number; // Current listing price (optional)
  miles?: number; // Vehicle mileage (optional)
  msrp?: number; // Manufacturer's Suggested Retail Price (optional)
  vdp_url: string; // Vehicle detail page URL
  color?: string; // Vehicle color description
  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)
  last_seen_at_date: string; // Last seen date (ISO format)
  scraped_at: number; // First scraped timestamp (Unix Seconds)
  scraped_at_date: string; // First scraped date (ISO format)
  first_seen_at: number; // First seen timestamp (Unix Seconds)
  first_seen_at_date: string; // First seen date (ISO format)
  source: string; // Data source website domain
  media: Media; // Photos and media content links
  extra?: Extra; // Additional features and options
  dealer: Dealer; // Dealer information
  build: Build; // Motorcycle specifications
}

interface Media {
  photo_links: string[]; // Array of photo URLs from dealer website
}

interface Extra {
  options: string[]; // Motorcycle options and detailed descriptions
  features: string[]; // Motorcycle features and highlights
}

interface Dealer {
  id: number; // Unique dealer identifier
  website: string; // Dealer website domain
  name: string; // Dealer business name
  dealer_type: string; // Dealer classification (franchise, independent)
  street: string; // Street address
  city: string; // City name
  state: string; // State or province
  latitude: string; // Geographic latitude
  longitude: string; // Geographic longitude
  zip: string; // Postal/ZIP code
  msa_code: string; // Metropolitan Statistical Area code
}

interface Build {
  year: number; // Model year
  make: string; // Motorcycle manufacturer
  model: string; // Motorcycle model
  trim: string; // Trim level
  vehicle_type: string; // Vehicle category (MOTORCYCLE / SCOOTER)
  drivetrain: string; // Drive type (Chain, Belt, Shaft)
  fuel_type: string; // Fuel type (Gas, Electric)
  engine: string; // Engine specification
  overall_height?: string; // Overall height measurement (optional)
  overall_width?: string; // Overall width measurement (optional)
}

Success Response

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

Error Response

Use Cases & Examples

Detailed Vehicle Information Display

Retrieve detailed vehicle information for display on motorcycle detail pages, customer applications, or internal dealer management systems. This API provides all the data typically shown on a dealer's motorcycle detail page (VDP).

Example:

Here we're retrieving complete details for a specific motorcycle listing including specifications, pricing, dealer information, and media content:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/listing/motorcycle/3ae003289b296bea3bfe266386835525-fa26db97-428f',
  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 motorcycle details for selected listings.

Example:

Here we're retrieving detailed information for a motorcycle listing discovered through inventory search:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/listing/motorcycle/40db9adb96aa20acf2bacf2af212cdf7-11fb1358-3e24',
  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 motorcycles.

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/motorcycle/3205a2928e1fc489b550c5194a8919e1-7f6d9de3-9603',
  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);
}

See Also

• Inventory Search
• Motorcycle Auto-Complete