Car listings API: search UK used car adverts by any filter

Prices per call

Prices in force today, per call, by package. Errors are not charged except where the API reference says so. Live keys only: sandbox calls are free.

Pay As You Go has no monthly fee (top up from £10). On Starter, Pro, Enterprise the monthly fee comes back as plan credit to spend on calls, expiring at the end of each monthly billing period. Package limits per second, minute and day are on the pricing page.

Example request and answer

Every endpoint is a JSON POST under https://www.dealerpricing.co.uk/api with your key in the X-API-Key header. This request uses a sandbox test value, so it is free with a sandbox key.

curl -X POST https://www.dealerpricing.co.uk/api/v1/market/listings \
  -H "X-API-Key: your_sandbox_key" \
  -H "Content-Type: application/json" \
  -d '{"make":"BMW","model":"3 Series","year_min":2019,"year_max":2019,"rows":10,"start":0}'

The answer (long lists shortened; fields not held for a vehicle are left out):

{
  "success": true,
  "data": {
    "total_found": 893,
    "start": 0,
    "rows_requested": 10,
    "rows_returned": 10,
    "more_available": true,
    "listings": [
      {
        "listing_id": "adv_Xc2Lr9vQm1T0pZk7HdF3aw8NsY4bJ6eUqC5gViOtR",
        "title": "2019 BMW 3 Series 320d M Sport 4dr Step Auto",
        "price": 18995,
        "mileage": 41250,
        "previous_price": 19995,
        "previous_price_date": "2026-09-12",
        "price_change_pct": -5,
        "vehicle": {
          "year": 2019,
          "make": "BMW",
          "model": "3 Series",
          "variant": "320d M Sport",
          "body_type": "Saloon",
          "fuel_type": "Diesel",
          "transmission": "Automatic",
          "drivetrain": "4x2",
          "engine_size": 2,
          "doors": 4,
          "seats": 5,
          "colour": "Black",
          "base_colour": "Black",
          "power_bhp": 188,
          "mpg_combined": 55.4,
          "co2_g_km": 118,
          "euro_status": "Euro 6"
        },
        "owners": 1,
        "first_registered": "2019-06-28",
        "days_on_market": 34,
        "days_at_dealer": 34,
        "first_seen": "2026-10-03",
        "last_seen": "2026-11-05",
        "dealer": {
          "dealer_id": "dlr_Qm4Tc8nWx2Ls0Hb7RkVa1g",
          "name": "Example Motors Ltd",
          "type": "independent",
          "city": "Leeds",
          "county": "West Yorkshire",
          "country": "England",
          "postcode": "LS11 5AB",
          "latitude": 53.78,
          "longitude": -1.55,
          "phone": "0113 000 0000",
          "website": "https://www.example.co.uk/"
        },
        "listing_url": "https://www.example.co.uk/used/bmw-3-series-320d",
        "advert_site": "example.co.uk",
        "photos": [
          "https://www.example.co.uk/photos/1.jpg"
        ]
      }
    ]
  },
  "meta": {
    "request_id": "req_3f9a1c0d2b7e4a5f6c8d9e01",
    "cost_pence": 10,
    "balance_pence": 990,
    "is_sandbox": false
  }
}

What you get

total_found

How many adverts match, with more_available for paging

listings[].listing_id

Our advert id (adv_...), title, price and mileage

listings[].previous_price

The previous price and price_change_pct when the price changed

listings[].vehicle.make

Make, model, variant, year, fuel, gearbox, body, engine, power, economy and CO2

listings[].days_on_market

Days on market and days at the dealer

listings[].dealer

The dealer: name, type, town, postcode and contact details as published

listings[].listing_url

Link to the advert and photo links

Every field, with its type and meaning, is in the API reference.

What developers use it for

• Show cars like the one a customer is looking at inside your own app or report.
• Watch the market for the cars you buy and sell.
• Check a car's advert history and spot mileage that went down between adverts.

Questions

Documentation and next steps

• Market data guide
• Market listings in the API reference
• Advert history in the API reference
• API test console (send a request with your sandbox key)
• Example searches (worked examples, once you sign in)
• Error codes and what each one costs
• Create a developer account