UK-EN
Home|API|Vehicle Check App|Bulk Vehicle Reports|Consultancy|Pricing|Knowledge Base|Swagger|Blog|Contact Us

Inventory Search

Powered by Marketcheck

Search real-time market data by budget, location, age and mileage with the ability to define required brands and the source url for the search.

Use it to power websites, apps and reporting without having to import a feed.

Key Features

Powerful Search

Search by registration date, mileage, budget, brand and location

Vehicle Details Page Links

600,000+ live dealer listings

Image Links

Link to multiple images of every vehicle

Advertised Prices

Updated daily for maximum accuracy

Seller Details

Dealer and location details

Vehicle Data

Listings decoded with structured vehicle data

Pricing

PAYG
15p
Per Use
Business
7p
Per Use
Enterprise
4p
Per Use

Pricing

PlanGBPEURUSD
PAYG (Per Use)15p18c21c
Business (Per Use)7p9c10c
Enterprise (Per Use)4p5c6c

Sample Response

Documentation

Introduction

This endpoint allows you to search real-time market data by budget, location, brand preference and mileage.

Header

When making calls to our API, include the following header:

x-api-key:your-api-key-here

Example Request

https://api.oneautoapi.com/marketcheck/inventorysearch?price_to_gbp=12345&post_code=AB1 2CD&radius_miles=12&required_manufacturers=BMW,Honda&registration_date_from=2020-01-01&registration_date_to=2020-01-01&current_mileage_from=12345&current_mileage_to=12345&price_from_gbp=12345&source_url=dealer_domain.co.uk&advert_qty=20&page=1&fuel_type_desc=petrol

Example Sandbox Request

https://sandbox.oneautoapi.com/marketcheck/inventorysearch?price_to_gbp=12345&post_code=AB1 2CD&radius_miles=12&required_manufacturers=BMW,Honda&registration_date_from=2020-01-01&registration_date_to=2020-01-01&current_mileage_from=12345&current_mileage_to=12345&price_from_gbp=12345&source_url=dealer_domain.co.uk&advert_qty=20&page=1&fuel_type_desc=petrol

Request Parameters

price_to_gbp
mandatory, string, e.g. 12345
The maximum price of items returned
post_code
optional, string, e.g. AB1 2CD
Postcode for the area of interest e.g AB1ABC
radius_miles
optional, string, e.g. 12
The maximum distance from the specified postcode
required_manufacturers
optional, string, e.g. BMW,Honda
The manufacturer(s) returned within the search (comma separated)
registration_date_from
optional, string, e.g. 2020-01-01
The earliest registration date for vehicles returned by the search
registration_date_to
optional, string, e.g. 2020-01-01
The latest registration date for vehicles returned by the search
current_mileage_from
optional, string, e.g. 12345
The lowest mileage for vehicles returned by the search
current_mileage_to
optional, string, e.g. 12345
The highest mileage for vehicles returned by the search
price_from_gbp
optional, string, e.g. 12345
The minimum price of items returned
source_url
optional, string, e.g. dealer_domain.co.uk
The source url for a specific dealer
advert_qty
optional, string, e.g. 20
The number of adverts returned per page. Defaults to 50 if not specified
page
optional, string, e.g. 1
The page number returned. Defaults to 1 if not specified
fuel_type_desc
optional, string, e.g. petrol
The vehicle's fuel type description. Allowed values - Petrol, Diesel, Electric, Petrol Electric Hybrid or Diesel Electric Hybrid

Sample Response

{
  "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"
}

Response Parameters

success
e.g. true
Whether the api call was successful
advert_qty
e.g. 1
Number of adverts matching the query parameters.
advert_id
e.g. X12345
Advert Id
vehicle_registration_mark
e.g. AB12ABC
Vehicle registration number (VRM).
distance_miles
e.g. 123
The distance from the specified postcode of the car location. Returns null when no postcode is specified
advert_heading
e.g. Advert heading
Advert heading
advertised_price_gbp
e.g. 12345.67
Advertised vehicle price
price_change_percentage
e.g. 12.3
Price change in % since vehicle was last scraped with the same dealer
mileage_observed
e.g. 12345
Vehicle odometer reading
vehicle_details_page_url
e.g. http://www.advert.com/advert=12345
Url to the vehicle on the source website
colour
e.g. blue
Exterior colour of vehicle.
days_on_market
e.g. 123
The number of days for the current listing
seller_type
e.g. dealer
e.g. dealer
ownership_condition
e.g. new
e.g. new or used
last_seen_date
e.g. 2023-02-21
Last seen date for the current listing
first_seen_date
e.g. 2023-01-15
First seen date for the current listing
first_seen_at_source_date
e.g. 2022-12-04
This could be earlier than first seen at date if the vehicle was previously listed (removed for min 5 days)
source_url
e.g. http://www.advert.com
Website address
co2_gkm
e.g. 123
CO2 in g/km
number_previous_keepers
e.g. 1
Number of previous keepers.
insurance_group
e.g. 8E
Vehicle insurance group
seller_name
e.g. ACME Motors
Seller name
street
e.g. 123 Fake Street
Street
city
e.g. London
City
county
e.g. Lancashire
County
latitude
e.g. 123.456789
Latitude
longitude
e.g. 345.6789012
Longitude
post_code
e.g. AB1 2CD
The location of the stock vehicle used as the centre of the search.
dealer_id
e.g. X12345
Dealer Id
dealer_name
e.g. ACME Motors
Dealer Name
website_url
e.g. http://www.acme-motors.com
Website URL.
street
e.g. 123 Fake Street
Street
city
e.g. London
City
country
e.g. England
Country
latitude
e.g. 123.456789
Latitude
longitude
e.g. 345.6789012
Longitude
post_code
e.g. AB1 2CD
The location of the stock vehicle used as the centre of the search.
phone_number
e.g. 01234 567890
Telephone number
email_address
e.g. hello@acme-motors.com
Email address
first_registration_year
e.g. 2020
Year of registration
manufacturer_desc
e.g. Mini
Manufacturer description
model_range_desc
e.g. Cooper
Model range description.
trim_desc
e.g. Clubman
Trim description
variant_desc
e.g. 5 door auto
Variant description
body_type_desc
e.g. Estate
The body type description
asset_type
e.g. Car
The asset type.
transmission_desc
e.g. Automatic
The vehicle's transmission type
drivetrain_desc
e.g. Front wheel drive
Drivetrain
fuel_type_desc
e.g. Petrol
The vehicle's fuel type description
engine_data
e.g. 1197cc, 69 HP, 75
Engine data
engine_badged_power
e.g. 1.6
Badged engine size
number_doors
e.g. 5
Number of doors.
number_cylinders
e.g. 4
Number of cylinders within the engine.
number_seats
e.g. 4
Number of seats.
more_results
e.g. true
The total number of adverts that can be returned.
error
e.g. If there is an error the message would go here
Details of what went wrong with the api call

Status Codes

200
success, chargeable
Request has been successfully received and a response has been sent.
202
accepted, non-chargeable
Request has been received and accepted for processing, but the action has not yet been completed.
204
no content, non-chargeable
Request has been successfully received but there is no content to return e.g. if an invalid VRM has been sent.
206
partial content, non-chargeable
Request has been successfully received but limited content is returned e.g. if an invalid VRM has been sent.
400
bad request, non-chargeable
Request was not received e.g. if any required parameters are missing.
403
forbidden, non-chargeable
Request was rejected e.g. if the API key is invalid or the service is not enabled.
429
too many requests, non-chargeable
API key rate limit/quota has been exceeded.
500
internal server error, non-chargeable
We are unable to process the request e.g. if the API is under extremely heavy load.
503
service unavailable, non-chargeable
Service is temporarily unavailable. Contact help@oneautoapi.com

Also Available From Marketcheck