Heavy Equipment Listing Details

The Heavy Equipment Listing Details API retrieves detailed information about specific dealer heavy equipment listings across United States markets. This endpoint provides complete listing data including equipment 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/heavy-equipment/{listing_id}

Path Parameter:

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

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/listing/heavy-equipment/7b05e534430982c838e0c6e5f201da03-ca6f51ff-a092',
  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 Heavy Equipment 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 heavy equipment 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 Heavy Equipment Listing Details API returns comprehensive information about the specified heavy equipment 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
  price: number; // Current listing price
  msrp: number; // Manufacturer's Suggested Retail Price (as per dealer website)
  miles: number; // Operating hours or mileage
  exterior_color: string; // Exterior color description
  interior_color: string; // Interior color description
  data_source: string; // Original data source identifier. Mostly `mc` for MarketCheck
  source: string; // Data source website domain
  vdp_url: string; // Equipment 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 (when available)
  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
  media: Media; // Photos and media content links
  dealer: Dealer; // Dealer information
  build: Build; // Heavy equipment specifications
}

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

interface Dealer {
  id: number; // Unique dealer identifier
  website: string; // Dealer website URL
  name: string; // Dealer business name
  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
  zip: string; // Postal/ZIP code
  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; // Heavy equipment manufacturer
  model: string; // Heavy equipment model
  trim: string; // Equipment trim level
  category?: string; // Equipment category (when available)
  sub_category: string; // Equipment sub-category
  engine: string; // Engine specifications
  length?: string; // Equipment length specification (when available)
  gvwr?: string; // Gross Vehicle Weight Rating or description (when available)
}

Success Response

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

Error Response

Use Cases & Examples

Detailed Equipment Information Display

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

Example:

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

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/listing/heavy-equipment/7b05e534430982c838e0c6e5f201da03-ca6f51ff-a092',
  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 heavy equipment details for selected listings.

Example:

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

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/listing/heavy-equipment/e0172e427d1f49f42a4304988fb151e5-62422253-0ed4',
  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 heavy equipment.

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/heavy-equipment/3c504bbf898e08f282d28b19dfbe9a2f-97e60178-3dbb',
  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
• Heavy Equipment Auto-Complete