Marketcheck API

Retail Pricing, Similar Listings & Inventory Data

One Auto API provides access to Marketcheck's market inventory, sales history and market pricing insights through a single API, alongside data from other vehicle-data providers.

About Marketcheck

Marketcheck turns vehicle listings into stock accessibility, retail pricing insights and vehicle history - available via API. By collecting and normalising listings from more than 10,000 UK dealers, it provides a broad view of vehicles currently advertised for sale and those marketed in the past.

One Auto API is partnered with Marketcheck in the UK, making its inventory and pricing data available on a pay-per-use basis. Businesses can use Marketcheck data within their own websites, applications and operational workflows, alongside other vehicle data sources through a single API.

Find the right vehicles for finance customers

For a finance broker, an approval is only part of the customer journey. The next challenge is finding a suitable vehicle that fits the customer’s spending power, location and preferences. Marketcheck inventory data helps brokers cut through the noise by searching all available dealer stock and presenting relevant options while the customer is engaged.

Brokers can use search criteria such as price, location, make and mileage to narrow the available inventory. The results can support a customer-facing vehicle search, an adviser-led sourcing process or a more personalised follow-up after an eligibility check. Bringing available cars into the finance journey helps customers move from an indicative approval towards choosing a vehicle they can buy and completing a loan agreement.

The same approach works for other digital services. Automotive marketplaces, buying platforms and software providers can incorporate dealer inventory into search tools, dashboards and customer communications. Instead of collecting and maintaining individual feeds from many retailers, or scraping marketplaces - teams can use Marketcheck data to support an inventory-led product or feature.

Price stock against the local market

Retail pricing decisions depend on what a customer can buy nearby, not simply on a national average.

Marketcheck data helps dealers and platforms understand the prices and availability of comparable vehicles in a chosen area. This provides practical context when acquiring stock, setting an initial asking price or reviewing prices of vehicles that have been advertised for some time.

Through One Auto API, Marketcheck’s Price Predictor provides independent or franchised dealer pricing, based on a VRM, mileage and postcode. Similar listings data can show the competing vehicles a buyer may encounter - and used together, these insights help a dealer judge whether its price is well positioned for the market.

A more competitive price will help increase sales velocity; and a clearer view of local alternatives can help protect margin when a vehicle is in demand. Pricing teams retain control of the final decision, supported by current evidence of the market around each vehicle. For platforms serving multiple dealers, the same information can be built into stock management and pricing workflows at scale.

Learn from current and historic listings

A vehicle’s advertised history can add context that a current listing does not show. Marketcheck’s historic listing data can help reveal how a car has previously been described, where it was marketed, the mileage shown and how its asking price changed over time, where those details are available.

That history supports several different decisions. A vehicle buying team can review earlier adverts before making an offer and investigate information that appears inconsistent with the current presentation. A used car buyer report can include listing history to give customers a fuller account of the vehicle they are considering. In an insurance claims workflow, historic adverts can provide additional evidence about a vehicle’s earlier condition, specification or advertised value.

Listing history is an extra source of insight, rather than a replacement for inspection or a provenance check. Its value lies in helping users ask better questions and identify potential risks before they make a purchase, valuation or claims decision.

Combine Marketcheck with other vehicle data

Many workflows need more than inventory or pricing alone. A broker may need to identify a vehicle before checking its provenance prior to payout. A dealer assessing a purchase may want multiple views on valuation, local and national. A report provider may wish to place historic listings alongside finance, stolen or salvage information to help them add value and differentiate.

One Auto API makes it easier to build these journeys by providing access to Marketcheck data alongside other data providers through a single integration. Businesses can select the data needed for each stage of a workflow without creating a separate technical connection for every supplier.

Whether you are sourcing vehicles for finance customers, adding inventory to a digital product, improving local retail pricing or building a richer vehicle history report, Marketcheck data helps turn market activity into decisions your users can act on.

What the API Includes

Field Name	Field Type	Example	Definition
advert_heading	String	Advert heading	Advert heading
advert_id	String	X1234	Advert Id
advert_qty	Int	1	Number of adverts matching the query parameters.
advertised_price_gbp	Float	12345.67	Advertised vehicle price
aspiration	String	Naturally aspirated	Engines aspiration description.
asset_type	String	car	The asset type.
average_days_to_sold	Int	66	Average days to sold of the observations used to provide the fair market value.
body_type_desc	String	hatchback	The body type description
city	String	London	City
co2_gkm	Int	123	CO2 in g/km
colour	String	RED	Exterior colour of vehicle.
country	String	England	Country
county	String	Lancashire	County
current_mileage	Int	12345	Current mileage of the vehicle
current_mileage_from	String		The lowest mileage for vehicles returned by the search
current_mileage_to	String		The highest mileage for vehicles returned by the search
days_on_market	Int	123	The number of days for the current listing
dealer_id	Int	12345678	Dealer Id
dealer_name	String	ACME Motors	Dealer Name
dealer_type	String	franchise	The dealer type.
distance_miles	Int	123	The distance from the specified postcode of the car location. Returns null when no postcode is specified
drivetrain_desc	String	Front Wheel Drive	Drivetrain
email_address	String	hello@acme-motors.com	Email address
engine_badged_power	Float	1.6	Badged engine size
engine_data	String	1197cc, 69 HP, 75	Engine data
error	String	Example error details	Details of what went wrong with the api call
first_registration_year	Int		Year of registration
first_seen_at_source_date	Date	2022-12-04	This could be earlier than first seen at date if the vehicle was previously listed (removed for min 5 days)
first_seen_date	Date	2023-01-15	First seen date for the current listing
fuel_type_desc	String		The vehicle's fuel type description
image_link	String	https://images.dealer.com/vehicles/7201/7201573/2820x2115/123456789.jpg	The image link.
image_links	String	http://www.image.com/image=1	Image Url
insurance_group	String	8E	Vehicle insurance group
last_seen_date	Date	2023-02-21	Last seen date for the current listing
latitude	Float	123.456789	Latitude
local_average_days_to_sold	Int	49	The average days to sold based on the post code and radius specified
local_fair_market_value	Int	26754	The fair market value of the vehicle based on the post code and radius specified.
longitude	Float	345.6789012	Longitude
manufacturer_desc	String	Mini	Manufacturer description
match	String		When used* with one or more of the following will return advertised vehicles matching the specified parameters (first_registration_year, manufacturer_desc, model_desc, variant_desc) e.g match=first_registration_year,manufacturer_desc,model_desc,variant_desc* all 4 parameters will be applied when match= is not used
mileage_observed	Int	12345	Vehicle odometer reading
mileage_observed_from	Int		The minimum (observed) miles for the items returned
mileage_observed_to	Int		The maximum (observed) miles for the items returned
model_range_desc	String	Hatch	Model range description.
more_results	Boolean	true	The total number of adverts that can be returned.
national_average_days_to_sold	Int	66	The national average days to sold.
national_fair_market_value	Int	26722	The national fair market value of the vehicle.
number_cylinders	Int	3	Number of cylinders within the engine.
number_doors	Int	2	Number of doors.
number_items	Int		The number of items you want returned (limited to a maximum of 25)
number_previous_keepers	Int	1	Number of previous keepers.
number_seats	Int	5	Number of seats.
ownership_condition	String	new	e.g. new or used
page	Int		The number of pages returned. Defaults to 1 if not specified
phone_number	String	01234 567890	Telephone number
post_code	String	AB1 2CD	The location of the stock vehicle used as the centre of the search.
price_change_percentage	Float	12.3	Price change in % since vehicle was last scraped with the same dealer
price_from_gbp	Int		The minimum price of items returned
price_to_gbp	Int		The maximum price of items returned
radius_miles	Int	30	The radius used to calculate the fair market value (between 25-100 miles). Defaults to 75 when not submitted.
registration_date_from	String		The earliest registration date for vehicles returned by the search
registration_date_to	String		The latest registration date for vehicles returned by the search
required_manufacturers	String		The manufacturer(s) returned within the search
result	String	fail	Has the vehicle passed all lead validation tests.
retail_valuation	Int	12345	The suggested market average retail valuation for the specified vehicle (cars only).
seller_name	String	ACME Motors	Seller name
seller_type	String	dealer	e.g. dealer
source_url	String	www.advert.com	Website address
street	String	123 Fake Street	Street
success	Boolean	true	Whether the api call was successful
transmission_desc	String		The vehicle's transmission type
trim_desc	String	Clubman	Trim description
variant_desc	String	5 door auto	Variant description
vehicle_details_page_url	String	http://www.advert.com/advert=12345	Url to the vehicle on the source website
vehicle_registration_mark	String		Vehicle registration number (VRM).
website_url	String	http://www.acme-motors.com	Website URL.

Sample Marketcheck API Responses

Fair Market Value from VRM

Historic Listings from VRM

Inventory From URL

Inventory from VRM

Inventory Search

Price Predictor from VRM

Price Predictor Premium from VRM

Similar Listings from VRM

Version

Fair Market Value from VRMHistoric Listings from VRMInventory From URLInventory from VRMInventory SearchPrice Predictor from VRMPrice Predictor Premium from VRMSimilar Listings from VRM

{
  "success": true,
  "result": {
    "local_fair_market_value": 26754,
    "national_fair_market_value": 26722,
    "local_average_days_to_sold": 49,
    "national_average_days_to_sold": 66
  },
  "error": "If there is an error the message would go here"
}

{
  "success": true,
  "result": {
    "historic_listings": [
      {
        "advert_id": "X1234",
        "advertised_price_gbp": 12345.67,
        "mileage_observed": 12345,
        "vehicle_details_page_url": "http://www.advert.com/advert=12345",
        "seller_type": "dealer",
        "ownership_condition": "new",
        "last_seen_date": "2023-02-21",
        "first_seen_date": "2023-01-15",
        "source_url": "www.advert.com",
        "seller_name": "ACME Motors",
        "city": "London",
        "post_code": "AB1 2CD"
      }
    ],
    "error": "If there is an error the message would go here"
  }
}

{
  "success": true,
  "result": {
    "advert_qty": 1,
    "advert_list": [
      {
        "advert_id": "X12345",
        "vehicle_registration_mark": "AB12ABC",
        "advert_heading": "Advert heading",
        "advertised_price_gbp": 12345.67,
        "price_change_percentage": 12.3,
        "mileage_observed": 12345,
        "vehicle_details_page_url": "http://www.advert.com/advert=12345",
        "colour": "blue",
        "days_on_market": 123,
        "seller_type": "dealer",
        "ownership_condition": "new",
        "last_seen_date": "2023-02-21",
        "first_seen_date": "2023-01-15",
        "first_seen_at_source_date": "2022-12-04",
        "source_url": "http://www.advert.com",
        "co2_gkm": 123,
        "number_previous_keepers": 1,
        "insurance_group": "8E",
        "vehicle_location_details": {
          "seller_name": "ACME Motors",
          "street": "123 Fake Street",
          "city": "London",
          "county": "Lancashire",
          "latitude": 123.456789,
          "longitude": 345.6789012,
          "post_code": "AB1 2CD"
        },
        "image_links": [
          "http://www.image.com/image=1"
        ],
        "dealer_details": {
          "dealer_id": "X12345",
          "dealer_name": "ACME Motors",
          "website_url": "http://www.acme-motors.com",
          "street": "123 Fake Street",
          "city": "London",
          "country": "England",
          "latitude": 123.456789,
          "longitude": 345.6789012,
          "post_code": "AB1 2CD",
          "phone_number": "01234 567890",
          "email_address": "hello@acme-motors.com"
        },
        "vehicle_data": {
          "first_registration_year": 2020,
          "manufacturer_desc": "Mini",
          "model_range_desc": "Cooper",
          "trim_desc": "Clubman",
          "variant_desc": "5 door auto",
          "body_type_desc": "Estate",
          "asset_type": "Car",
          "transmission_desc": "Automatic",
          "drivetrain_desc": "Front wheel drive",
          "fuel_type_desc": "Petrol",
          "engine_data": "1197cc, 69 HP, 75",
          "engine_badged_power": 1.6,
          "number_doors": 5,
          "number_cylinders": 4,
          "number_seats": 4,
          "aspiration": "Naturally aspirated"
        }
      }
    ],
    "more_results": true
  },
  "error": "If there is an error the message would go here"
}

{
  "success": true,
  "result": {
    "advert_qty": 1,
    "advert_list": [
      {
        "advert_id": "X12345",
        "vehicle_registration_mark": "AB12ABC",
        "distance_miles": 123,
        "advert_heading": "Advert heading",
        "advertised_price_gbp": 12345.67,
        "price_change_percentage": 12.3,
        "mileage_observed": 12345,
        "vehicle_details_page_url": "http://www.advert.com/advert=12345",
        "colour": "blue",
        "days_on_market": 123,
        "seller_type": "dealer",
        "ownership_condition": "new",
        "last_seen_date": "2023-02-21",
        "first_seen_date": "2023-01-15",
        "first_seen_at_source_date": "2022-12-04",
        "source_url": "http://www.advert.com",
        "co2_gkm": 123,
        "number_previous_keepers": 1,
        "insurance_group": "8E",
        "vehicle_location_details": {
          "seller_name": "ACME Motors",
          "street": "123 Fake Street",
          "city": "London",
          "county": "Lancashire",
          "latitude": 123.456789,
          "longitude": 345.6789012,
          "post_code": "AB1 2CD"
        },
        "image_links": [
          "http://www.image.com/image=1"
        ],
        "dealer_details": {
          "dealer_id": "X12345",
          "dealer_name": "ACME Motors",
          "website_url": "http://www.acme-motors.com",
          "street": "123 Fake Street",
          "city": "London",
          "country": "England",
          "latitude": 123.456789,
          "longitude": 345.6789012,
          "post_code": "AB1 2CD",
          "phone_number": "01234 567890",
          "email_address": "hello@acme-motors.com"
        },
        "vehicle_data": {
          "first_registration_year": 2020,
          "manufacturer_desc": "Mini",
          "model_range_desc": "Cooper",
          "trim_desc": "Clubman",
          "variant_desc": "5 door auto",
          "body_type_desc": "Estate",
          "asset_type": "Car",
          "transmission_desc": "Automatic",
          "drivetrain_desc": "Front wheel drive",
          "fuel_type_desc": "Petrol",
          "engine_data": "1197cc, 69 HP, 75",
          "engine_badged_power": 1.6,
          "number_doors": 5,
          "number_cylinders": 4,
          "number_seats": 4
        }
      }
    ],
    "more_results": true
  },
  "error": "If there is an error the message would go here"
}

{
  "success": true,
  "result": {
    "advert_qty": 1,
    "advert_list": [
      {
        "advert_id": "X12345",
        "vehicle_registration_mark": "AB12ABC",
        "distance_miles": 123,
        "advert_heading": "Advert heading",
        "advertised_price_gbp": 12345.67,
        "price_change_percentage": 12.3,
        "mileage_observed": 12345,
        "vehicle_details_page_url": "http://www.advert.com/advert=12345",
        "colour": "blue",
        "days_on_market": 123,
        "seller_type": "dealer",
        "ownership_condition": "new",
        "last_seen_date": "2023-02-21",
        "first_seen_date": "2023-01-15",
        "first_seen_at_source_date": "2022-12-04",
        "source_url": "http://www.advert.com",
        "co2_gkm": 123,
        "number_previous_keepers": 1,
        "insurance_group": "8E",
        "vehicle_location_details": {
          "seller_name": "ACME Motors",
          "street": "123 Fake Street",
          "city": "London",
          "county": "Lancashire",
          "latitude": 123.456789,
          "longitude": 345.6789012,
          "post_code": "AB1 2CD"
        },
        "image_links": [
          "http://www.image.com/image=1"
        ],
        "dealer_details": {
          "dealer_id": "X12345",
          "dealer_name": "ACME Motors",
          "website_url": "http://www.acme-motors.com",
          "street": "123 Fake Street",
          "city": "London",
          "country": "England",
          "latitude": 123.456789,
          "longitude": 345.6789012,
          "post_code": "AB1 2CD",
          "phone_number": "01234 567890",
          "email_address": "hello@acme-motors.com"
        },
        "vehicle_data": {
          "first_registration_year": 2020,
          "manufacturer_desc": "Mini",
          "model_range_desc": "Cooper",
          "trim_desc": "Clubman",
          "variant_desc": "5 door auto",
          "body_type_desc": "Estate",
          "asset_type": "Car",
          "transmission_desc": "Automatic",
          "drivetrain_desc": "Front wheel drive",
          "fuel_type_desc": "Petrol",
          "engine_data": "1197cc, 69 HP, 75",
          "engine_badged_power": 1.6,
          "number_doors": 5,
          "number_cylinders": 4,
          "number_seats": 4
        }
      }
    ],
    "more_results": true
  },
  "error": "If there is an error the message would go here"
}

{
  "success": true,
  "result": {
    "retail_valuation": 10273
  },
  "error": "If there is an error the message would go here"
}

{
  "success": true,
  "result": {
    "retail_valuation": 55461,
    "average_days_to_sold": 28.56,
    "current_comparables": {
      "advert_qty": 10,
      "advert_list": [
        {
          "advert_id": "a11bc854d2e60fghi68818410j4k1eedl8m1nop316qr739s6t4761uv494w21x5",
          "vehicle_registration_mark": "AB21ABC",
          "advertised_price_gbp": 58450,
          "mileage_observed": 27300,
          "days_on_market": 47,
          "vehicle_details_page_url": "http://www.advert.com/advert-12345",
          "image_link": "https://images.dealer.com/vehicles/7201/7201573/2820x2115/123456789.jpg",
          "manufacturer_desc": "Mercedes",
          "model_range_desc": "G Class",
          "trim_desc": "Automatic",
          "dealer_id": 12345678,
          "dealer_name": "ACME Motors"
        }
      ]
    },
    "recent_comparables": {
      "advert_qty": 1,
      "advert_list": [
        {
          "advert_id": "b11bc854d2e60fghi68818410j4k1eedl8m1nop316qr739s6t4761uv494w21x5",
          "vehicle_registration_mark": "AB22ABC",
          "advertised_price_gbp": 55450,
          "mileage_observed": 22300,
          "days_on_market": 35,
          "vehicle_details_page_url": "http://www.advert.com/advert-123457",
          "manufacturer_desc": "Mercedes",
          "model_range_desc": "G Class",
          "dealer_id": 22345678,
          "dealer_name": "ACME 2 Motors"
        }
      ]
    }
  },
  "error": "If there is an error the message would go here"
}

{
  "success": true,
  "result": {
    "advert_qty": 1,
    "advert_list": [
      {
        "advert_id": "X12345",
        "vehicle_registration_mark": "AB12ABC",
        "distance_miles": 123,
        "advert_heading": "Advert heading",
        "advertised_price_gbp": 12345.67,
        "price_change_percentage": 12.3,
        "mileage_observed": 12345,
        "vehicle_details_page_url": "http://www.advert.com/advert=12345",
        "colour": "blue",
        "days_on_market": 123,
        "seller_type": "dealer",
        "ownership_condition": "new",
        "last_seen_date": "2023-02-21",
        "first_seen_date": "2023-01-15",
        "first_seen_at_source_date": "2022-12-04",
        "source_url": "http://www.advert.com",
        "co2_gkm": 123,
        "number_previous_keepers": 1,
        "insurance_group": "8E",
        "vehicle_location_details": {
          "seller_name": "ACME Motors",
          "street": "123 Fake Street",
          "city": "York",
          "county": "North Yorkshire",
          "latitude": 123.456789,
          "longitude": 345.6789012,
          "post_code": "AB1 2BC"
        },
        "image_links": [
          "http://www.image.com/image=1"
        ],
        "dealer_details": {
          "dealer_id": "X12345",
          "dealer_name": "ACME Motors",
          "website_url": "http://www.acme-motors.com",
          "street": "123 Fake Street",
          "city": "London",
          "country": "England",
          "latitude": 123.456789,
          "longitude": 345.6789012,
          "post_code": "AB1 2BC",
          "phone_number": "01234 567890",
          "email_address": "hello@acme-motors.com"
        },
        "vehicle_data": {
          "first_registration_year": 2020,
          "manufacturer_desc": "Mini",
          "model_range_desc": "Cooper",
          "trim_desc": "Clubman",
          "variant_desc": "5 door auto",
          "body_type_desc": "Estate",
          "asset_type": "Car",
          "transmission_desc": "Automatic",
          "drivetrain_desc": "Front wheel drive",
          "fuel_type_desc": "Petrol",
          "engine_data": "1197cc, 69 HP, 75",
          "engine_badged_power": 1.6,
          "number_doors": 5,
          "number_cylinders": 4,
          "number_seats": 4,
          "aspiration": "Naturally aspirated"
        }
      }
    ]
  },
  "error": "If there is an error the message would go here"
}

.js-sample-response { display: none !important; } .nojs-sample-response { display: block !important; } .nojs-sample-response-input { position: absolute; opacity: 0; width: 1px; height: 1px; } .nojs-sample-response-label { display: inline-block; padding: 6px 16px; border-radius: 16px; cursor: pointer; background: rgba(255, 255, 255, 0.2); color: #fff; font-size: 0.8125rem; font-family: inherit; } .nojs-sample-response-panel { display: none; background: rgba(0, 0, 0, 0.87); color: #fff; border-radius: 8px; padding: 16px; overflow-x: auto; font-size: 0.85rem; white-space: pre-wrap; word-break: break-all; } #sample-response-3-input-0:checked ~ #sample-response-3-panel-0 { display: block !important; } #sample-response-3-input-0:checked ~ * #sample-response-3-label-0 { background: #1976d2; color: #fff; } #sample-response-3-input-1:checked ~ #sample-response-3-panel-1 { display: block !important; } #sample-response-3-input-1:checked ~ * #sample-response-3-label-1 { background: #1976d2; color: #fff; } #sample-response-3-input-2:checked ~ #sample-response-3-panel-2 { display: block !important; } #sample-response-3-input-2:checked ~ * #sample-response-3-label-2 { background: #1976d2; color: #fff; } #sample-response-3-input-3:checked ~ #sample-response-3-panel-3 { display: block !important; } #sample-response-3-input-3:checked ~ * #sample-response-3-label-3 { background: #1976d2; color: #fff; } #sample-response-3-input-4:checked ~ #sample-response-3-panel-4 { display: block !important; } #sample-response-3-input-4:checked ~ * #sample-response-3-label-4 { background: #1976d2; color: #fff; } #sample-response-3-input-5:checked ~ #sample-response-3-panel-5 { display: block !important; } #sample-response-3-input-5:checked ~ * #sample-response-3-label-5 { background: #1976d2; color: #fff; } #sample-response-3-input-6:checked ~ #sample-response-3-panel-6 { display: block !important; } #sample-response-3-input-6:checked ~ * #sample-response-3-label-6 { background: #1976d2; color: #fff; } #sample-response-3-input-7:checked ~ #sample-response-3-panel-7 { display: block !important; } #sample-response-3-input-7:checked ~ * #sample-response-3-label-7 { background: #1976d2; color: #fff; }

FAQ

What Marketcheck data can I access through One Auto API?

Fair Market Value, Price Predictor, Similar and Historic Listings, and a real-time inventory search by budget, location, make and mileage. Backed by 600,000+ daily listings from 10,000+ dealers, accessible by registration mark or search parameters.

Why use Marketcheck instead of scraping dealer or classified listings?

Marketcheck delivers market inventory data refreshed daily from over 10,000 dealer websites, enriched with normalised vehicle data and history. This provides a significantly more cost effective solution than sourcing data independently, avoiding the need to navigate technical barriers, rate limits and deduplication of records compared to scraping classified sites. Delivered as structured, normalised JSON for ease of integration.

Is Marketcheck's scraped data legal to use?

Marketcheck takes responsibility for ensuring its collection of vehicle listing data complies with applicable law in the UK, and makes the data available through commercial API arrangements. One Auto API provides access to Marketcheck data under licence. When implementing it, customers must follow the applicable Marketcheck terms and conditions, particularly any restrictions on, storing or sharing the data. We recommend taking your own legal advice to confirm that your intended onward use is permitted.