MarketCheck Price™

The MarketCheck Price™ API provides sophisticated vehicle price predictions using proprietary machine learning models trained on extensive automotive market data. This powerful tool leverages advanced algorithms to deliver accurate price estimates based on real-time market conditions and comprehensive vehicle characteristics.

The API utilizes machine learning models trained on massive datasets containing over 4 million recently sold vehicle listings from 70,000+ dealerships nationwide. Models are retrained weekly to ensure predictions reflect current market dynamics and pricing trends.

The API offers three distinct service tiers, each designed for different use cases and requirements:

• Base Tier: Essential price predictions with MSRP data for basic valuation needs
• Premium Tier: Enhanced predictions including 1,000 comparable vehicle listings for comprehensive market analysis
• Premium Plus Tier: Complete analysis with full NeoVIN decode data for the most detailed insights

Each tier provides increasingly sophisticated analysis capabilities, from simple price predictions to comprehensive market comparisons with complete vehicle specifications. This enables dealers, lenders, insurers, and automotive professionals to choose the level of detail that best fits their specific needs and workflows.

Model Training Data & Accuracy

The API leverages comprehensive training datasets with the following characteristics:

• Dataset Size: 4+ million recently sold vehicle listings
• Time Period: Last 3 months of sales data
• Data Sources: 70,000+ dealerships nationwide
• Update Frequency: Weekly model retraining

Data Features

• Vehicle Specifications: Year, make, model, trim, body type, transmission, drivetrain, fuel type, powertrain, colors, features
• Location Data: City and state information
• Condition Factors: Mileage, certification status, seller category
• Market Trends: Recent pricing patterns for comparable vehicles

Model Accuracy

• Overall Performance: 96%+ R² score on holdout datasets
• Recent Vehicles: 90%+ predictions within 10% margin (vehicles <10 years old)
• Older Vehicles: 80%+ predictions within 25% margin (vehicles >10 years old)
• Real-Time Predictions: Current market conditions, not future forecasting

API Tiers & Endpoints

The MarketCheck Price API offers three distinct tiers, each with its own endpoint and feature set:

Base Path

The base path varies depending on the tier you want to use:

Base Tier:

GET https://api.marketcheck.com/v2/predict/car/us/marketcheck_price

Premium Tier:

GET https://api.marketcheck.com/v2/predict/car/us/marketcheck_price/comparables

Premium Plus Tier:

GET https://api.marketcheck.com/v2/predict/car/us/marketcheck_price/comparables/decode

The following example demonstrates the Base Tier API for essential price predictions:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/predict/car/us/marketcheck_price',
  params: {
    api_key: 'YOUR_API_KEY',
    vin: '2T3DWRFV3LW077677',
    miles: 76189,
    dealer_type: 'independent',
    zip: '80215',
    is_certified: true
  },
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Request

All three tiers of the MarketCheck Price API share the same parameter requirements. The core prediction algorithm requires specific vehicle identification and market context to generate accurate price estimates.

Parameters

Required Parameters

vin

• 17-character Vehicle Identification Number that uniquely identifies the vehicle
• Used to decode vehicle specifications and find comparable vehicles
• Must be a valid VIN format
• Example: vin=1HGBH41JXMN109186

miles

• Total mileage the vehicle has been driven
• Critical factor in determining vehicle condition and market value
• Required for used vehicles (typically not applicable for new vehicles)
• Example: miles=45000

dealer_type

• Dealer classification that affects pricing models
• Supported values: franchise, independent
• Franchise dealers typically have different pricing patterns than independent dealers
• Example: dealer_type=franchise

Location Parameters

At least one location parameter is required:

zip

• ZIP code for the vehicle's location or target market
• Provides precise geographic context for pricing
• Example: zip=90210

city & state

• City and state combination as an alternative to ZIP code
• Both parameters must be provided together when using this option
• Example: city=Los Angeles&state=CA

Optional Parameters

is_certified

• Certification status indicating if the vehicle is certified pre-owned
• Certified vehicles typically command higher prices
• Example: is_certified=true

Response

The response schema varies depending on the tier used. Each tier builds upon the previous tier's features.

Base Tier Response Schema

interface BaseMarketCheckPriceResponse {
  marketcheck_price: number; // Predicted market price
  msrp: number; // Manufacturer's Suggested Retail Price
}

Premium Tier Response Schema

interface PremiumMarketCheckPriceResponse {
  marketcheck_price: number; // Predicted market price
  msrp: number; // Manufacturer's Suggested Retail Price
  comparables: Comparables; // 1,000 recent comparable vehicles
}

interface Comparables {
  num_found: number; // Number of comparable vehicles found
  listings: Listing[]; // Array of comparable vehicle listings
}

interface Listing {
  id: string; // Unique listing identifier
  vin: string; // Vehicle identification number
  price: number; // Listed price
  miles: number; // Vehicle mileage
  dom: number; // Days on market
  dom_180: number; // Days on market (180-day period)
  dom_active: number; // Days on market (active period)
  year: number; // Model year
  make: string; // Vehicle manufacturer
  model: string; // Vehicle model
  trim: string; // Vehicle trim level
  photo_url: string; // Primary photo URL
  dealer_id: number; // Dealer identifier
  latitude: string; // Geographic latitude
  longitude: string; // Geographic longitude
  mc_website_id: number; // MarketCheck website identifier
  dos_active: number; // Days on site (active period)
}

Premium Plus Tier Response Schema

interface PremiumPlusMarketCheckPriceResponse {
  marketcheck_price: number; // Predicted market price
  msrp: number; // Manufacturer's Suggested Retail Price
  comparables: Comparables; // 1,000 recent comparable vehicles
  decode: NeoVINDecode; // Complete vehicle decode information
}

interface NeoVINDecode {
  // Complete vehicle specification data from NeoVIN
  // Includes detailed technical specifications, features, and options
  [key: string]: any; // Dynamic structure based on vehicle data
}

Success Response

• 200 OK - Returns the appropriate response object based on the tier used
• All monetary values are in USD
• Mileage values are in miles
• Geographic coordinates are in decimal degrees

Error Response

Error Response Format

Most error responses follow this structure, except for 502 and 503 errors:

{
  "code": <HTTP status code>,
  "message": "<Error message describing the issue>"
}

Use Cases & Examples

Base Tier: Essential Price Predictions

The Base Tier provides core price prediction functionality with MSRP data, ideal for basic valuation needs and quick price estimates.

Use this tier when you need:

• Quick price estimates for vehicle valuation
• MSRP information for pricing reference
• Cost-effective predictions for high-volume applications
• Basic price validation for inventory management

Example:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/predict/car/us/marketcheck_price',
  params: {
    api_key: 'YOUR_API_KEY',
    vin: '2T3DWRFV3LW077677',
    miles: 76189,
    dealer_type: 'independent',
    zip: '80215',
    is_certified: true
  },
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Premium Tier: Market Analysis with Comparables

The Premium Tier includes all Base Tier features plus access to 1,000 recent comparable vehicle listings, providing comprehensive market context for pricing decisions.

Use this tier when you need:

• Detailed market analysis with comparable vehicles
• Understanding of local market pricing patterns
• Comprehensive pricing context for negotiations
• Market positioning for inventory pricing strategies

Example:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/predict/car/us/marketcheck_price/comparables',
  params: {
    api_key: 'YOUR_API_KEY',
    vin: '2T3DWRFV3LW077677',
    miles: 76189,
    dealer_type: 'independent',
    zip: '80215',
    is_certified: true
  },
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Premium Plus Tier: Complete Analysis with VIN Decode

The Premium Plus Tier provides the most comprehensive analysis, including all Premium features plus complete NeoVIN decode data with detailed vehicle specifications.

Use this tier when you need:

• Complete vehicle specification data
• Most detailed pricing insights available
• Full market analysis for critical business decisions
• Comprehensive vehicle information for lending or insurance

Example:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/predict/car/us/marketcheck_price/comparables/decode',
  params: {
    api_key: 'YOUR_API_KEY',
    vin: '2T3DWRFV3LW077677',
    miles: 76189,
    dealer_type: 'independent',
    zip: '80215',
    is_certified: true
  },
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Loan and Financing Applications

Use MarketCheck Price predictions to support lending decisions, determine loan-to-value ratios, and assess collateral value for automotive financing.

Example for Financing:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/predict/car/us/marketcheck_price',
  params: {
    api_key: 'YOUR_API_KEY',
    vin: '1HGBH41JXMN109186',
    miles: 45000,
    dealer_type: 'franchise',
    zip: '90210'
  },
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Insurance Valuation

Integrate price predictions into insurance workflows for claim settlements, coverage determinations, and risk assessment.

Example for Insurance:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/predict/car/us/marketcheck_price/comparables',
  params: {
    api_key: 'YOUR_API_KEY',
    vin: '1HGBH41JXMN109186',
    miles: 45000,
    dealer_type: 'independent',
    city: 'Miami',
    state: 'FL',
    is_certified: true
  },
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Dealer Inventory Management

Use predictions to optimize inventory pricing, identify market opportunities, and make informed purchasing decisions.

Example for Inventory Pricing:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/predict/car/us/marketcheck_price/comparables/decode',
  params: {
    api_key: 'YOUR_API_KEY',
    vin: '1HGBH41JXMN109186',
    miles: 45000,
    dealer_type: 'franchise',
    zip: '10001'
  },
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

See Also

• Market Days Supply
• Inferred Sales Stats
• Popular Cars