manheim.co.uk APImanheim.co.uk ↗
Access Manheim UK vehicle auction listings, upcoming events, and auction centre details via 8 structured endpoints. Filter by make, model, fuel type, and more.
curl -X GET 'https://api.parse.bot/scraper/7f23834d-205f-4e5e-a8bf-f49d398ff718/search_vehicles?make=BMW&page=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for vehicle auction listings with optional filters. Returns paginated results with up to 30 vehicles per page.
| Param | Type | Description |
|---|---|---|
| make | string | Filter by vehicle make (e.g. 'BMW', 'FORD', 'AUDI'). Values from get_vehicle_makes. |
| page | integer | Page number for pagination. |
| model | string | Filter by vehicle model (e.g. '1 SERIES'). Values from get_vehicle_models_by_make. |
| keyword | string | Free-text search keyword. |
| fuel_type | string | Filter by fuel type (e.g. 'Petrol', 'Diesel', 'Electric', 'Hybrid'). Values from get_filter_options. |
| vehicle_type | string | Filter by vehicle type (e.g. 'Car', 'Van', 'Motorbike', 'Plant', 'Truck'). Values from get_filter_options. |
| sales_channel | string | Filter by sales channel (e.g. 'Physical Auction', 'Dealer Auction', 'Preview Stock'). Values from get_filter_options. |
| auction_centre | string | Filter by auction centre name (e.g. 'Colchester', 'Birmingham'). Values from get_auction_centres. |
{
"type": "object",
"fields": {
"page": "integer current page number",
"vehicles": "array of vehicle listing objects with id, brand, model_name, description, grade, image_url, registration_date, odometer, transmission, engine_size, auction_centre, sales_channels",
"total_results": "integer total number of matching vehicles"
},
"sample": {
"data": {
"page": 1,
"vehicles": [
{
"id": "1000824",
"brand": "BMW",
"grade": "GRADE 2",
"odometer": "79,136 Miles(Warranted)",
"image_url": "http://images.manheim.co.uk/images/units/ims_small/1000824-9999999-125135946-004.jpg",
"model_name": "5 SERIES 530d M Sport 4dr Step Auto",
"description": "Diesel - GREY - KE15FZL - 4 Door Saloon",
"engine_size": "3.0L",
"transmission": "Automatic",
"auction_centre": "Colchester",
"sales_channels": [
"Physical Auction",
"Simulcast"
],
"registration_date": "06/2015"
}
],
"total_results": 30
},
"status": "success"
}
}About the manheim.co.uk API
The Manheim UK API gives developers structured access to vehicle auction data across 8 endpoints, covering live listings, upcoming auction events, and UK auction centre locations. Use search_vehicles to query active stock with filters for make, model, fuel type, vehicle type, and sales channel, or call get_auction_events to retrieve scheduled auctions grouped by date within any date range you specify.
Vehicle Listings and Search
search_vehicles is the core endpoint, returning paginated results of up to 30 vehicles per page. Each vehicle object includes id, brand, model_name, description, grade, image_url, registration_date, odometer, and transmission. You can narrow results using make, model, fuel_type, vehicle_type, sales_channel, auction_centre, or a free-text keyword. Valid filter values come from companion endpoints: get_vehicle_makes returns all makes with live stock counts, and get_vehicle_models_by_make returns models for a given make including their Count, Group, and Value identifiers. get_filter_options returns facet arrays for VehicleType, Make, Model, FuelType, and SalesChannel, each with Value, Text, Count, and Icon fields, along with a TotalResults figure for the full inventory.
Auction Events and Centres
get_auction_events accepts start_date and end_date in dd/mm/yyyy HH:MM:SS format and returns events grouped by date, with each row containing auction centre details, vehicle counts, and vendor information. The response includes TotalResults, TotalPages, and CurrentPage for pagination. get_auction_centres lists every Manheim UK location with name, slug, and url. Pass a slug to get_auction_centre_detail to retrieve the centre's full postal address, phone number, and an upcoming_auctions array covering the next 7 days, each entry including date, name, and a vehicle count in the info field.
Vehicle Images
get_vehicle_detail accepts a vehicle_id from search_vehicles results and returns an array of high-resolution image URLs. Vehicles that do not have professional photography return an empty images array, so callers should handle that case explicitly. This endpoint is the only way to retrieve full-resolution images beyond the thumbnail image_url present in search results.
- Build a price-monitoring tool that tracks available stock by make and model using
search_vehicleswithmakeandmodelfilters. - Generate a calendar of upcoming UK vehicle auctions by polling
get_auction_eventswith a rolling date range. - Display auction centre contact details and weekly schedules in a dealer portal using
get_auction_centre_detail. - Populate make/model dropdowns dynamically with live stock counts from
get_vehicle_makesandget_vehicle_models_by_make. - Build a fleet remarketing dashboard filtered by
sales_channelvalues such as 'Dealer Auction' or 'Physical Auction'. - Aggregate high-resolution vehicle imagery for listings by fetching full image arrays from
get_vehicle_detail. - Analyse inventory distribution across fuel types using the
FuelTypefacet counts returned byget_filter_options.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Manheim UK offer an official developer API?+
What does `get_auction_events` return and how is pagination handled?+
get_auction_events returns results grouped by date, with each group containing auction rows that include centre details, vehicle counts, and vendor information. The response exposes TotalResults, TotalPages, and CurrentPage fields. The start_date and end_date parameters accept dates in dd/mm/yyyy HH:MM:SS format; if omitted, they default to today and 30 days from today respectively.Does the API return bid history, sale prices, or past auction results?+
Are full vehicle specifications such as engine size, colour, or damage grade exposed in the search results?+
search_vehicles response includes grade, odometer, transmission, registration_date, fuel_type, and description, but detailed specs like engine size or colour are not currently returned as discrete fields. You can fork this API on Parse and revise the vehicle detail endpoint to surface additional specification fields if they are available on the listing page.What happens when a vehicle has no professional photography in `get_vehicle_detail`?+
id with an empty images array. The thumbnail image_url in search_vehicles results is separate and may still be present, but get_vehicle_detail specifically targets high-resolution photography, which not all lots have.