API
Sign Up

Car dealer API: find UK dealers and read their stock

Last updated: 9 November 2026

Search UK car dealers near a postcode or by type, town, county or group, get one dealer's address, contact details and stock count, and read a dealer's cars for sale now with stock age (days at dealer), price statistics over the whole stock and a make or model mix. Calls cost 10p a call on Pay As You Go, down to 3p on Enterprise. Sandbox keys are free. They answer from a stored sample of fictional adverts for the test models at GET /v1/sandbox/market-presets, and every filter, sort, count and statistic works on the sample, so totals describe the sample, not the market.

Dealer names, phone numbers and emails are sent as dealers publish them. For sole traders they are personal data: use them only where you have a lawful basis, and do not store them or build a contact list from them.

Every listing in the market data endpoints carries the dealer's id (dlr_...), so you can go from an advert to the dealer and their whole stock.

Get a free sandbox keyTry it in the test consoleAll prices

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.

EndpointPay As You GoStarterProEnterprise
Dealer search
POST /api/v1/dealers/search
Dealers near a postcode, by type, county, city or group.
Daily cap per account: 200 / 750 / 2,000 / 5,000
10p8p5p3p
Dealer detail
POST /api/v1/dealers/detail
One dealer: address, contact details, type and stock count.
Daily cap per account: 200 / 750 / 2,000 / 5,000
10p8p5p3p
Dealer stock
POST /api/v1/dealers/stock
One dealer's live stock with stock age, price statistics and make mix.
Daily cap per account: 200 / 750 / 2,000 / 5,000
10p8p5p3p

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/dealers/search \
  -H "X-API-Key: your_sandbox_key" \
  -H "Content-Type: application/json" \
  -d '{"postcode":"N1 7GU","radius":5,"rows":10}'

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

{
  "success": true,
  "data": {
    "total_found": 85,
    "start": 0,
    "rows_requested": 10,
    "rows_returned": 10,
    "more_available": true,
    "dealers": [
      {
        "dealer_id": "dlr_Vb6Hn1Rx8Kq3Mz0Wt5Ls2Pc",
        "name": "Example Cars Islington Ltd",
        "type": "independent",
        "city": "London",
        "county": "Greater London",
        "country": "England",
        "postcode": "N1 7AB",
        "latitude": 51.536,
        "longitude": -0.103,
        "phone": "020 0000 0000",
        "website": "https://www.example.co.uk/",
        "status": "active",
        "listed_since": "2021-04-09",
        "distance_miles": 0.4,
        "stock_count": 63
      }
    ]
  },
  "meta": {
    "request_id": "req_3f9a1c0d2b7e4a5f6c8d9e01",
    "cost_pence": 10,
    "balance_pence": 990,
    "is_sandbox": false
  }
}

What you get

dealers[].dealer_id
Our dealer id (dlr_...), name, type and group
dealers[].street
Address: street, city, county, postcode, latitude and longitude
dealers[].phone
Phone, email and website as the dealer publishes them
dealers[].stock_count
How many cars the dealer has for sale
dealers[].distance_miles
Distance from the postcode you searched
dealers[].listed_since
When the dealer was first listed, and its status
facets
Counts by dealer type and other fields, for filter menus

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

What developers use it for

  • A dealer finder on your own site or app.
  • Watch competitors' stock, stock age and prices in your area.
  • Go from an advert to the dealer selling it and the rest of their stock.

Questions

Is there an API for UK car dealers and their stock?

Yes. /api/v1/dealers/search finds dealers near a postcode or by type, town, county or group, /api/v1/dealers/detail returns one dealer, and /api/v1/dealers/stock returns a dealer's cars for sale now. Each call costs 10p a call on Pay As You Go, down to 3p on Enterprise.

How do I sort dealers?

By distance (needs a postcode or latitude and longitude, radius up to 200 miles) or newest dealers first, with sort_by.

What does dealer stock return?

The dealer's cars for sale now with the usual filters, sort and paging, the stock age in days at the dealer, price statistics over the whole stock and an optional make or model mix.

Can I store dealer contact details?

No. Dealer names, phone numbers and emails are sent as dealers publish them. For sole traders they are personal data: use them only where you have a lawful basis, and do not store them or build a contact list from them.

What if a dealer id no longer exists?

The answer is 404 DEALER_NOT_FOUND. It is charged, because the lookup was made.

Can I test it for free?

Yes. Sandbox keys are free. Dealer search covers the sandbox test areas, and dealer detail and stock cover the fictional dealers listed at GET /v1/sandbox/market-presets.

Documentation and next steps