ClickDealer

Get available filter options (makes, models, body types, fuel types, etc.) for a vehicle search. Call this first to discover what values are available. Optionally pass existing filters to refine (e.g. pass make=Ford to see Ford models).

Get full details for a specific vehicle by its ID. Returns specification, listings with prices, dealership info, images, and features.

Search used vehicles for sale from ClickDealer that match the given criteria, returning matching listings with pagination. Set vehicleType to what the shopper is after — 'car' (the default), 'bike' for motorbikes, 'lightCommercial' for vans, or 'heavyCommercial'. Call this ONCE per request and present that single result set. Pick the one sortBy that best fits the shopper's intent — do NOT issue several searches with different sort orders (each call renders its own results card, so repeated calls clutter the reply). To search by location, set nearPostcode (and optionally withinMiles). nearPostcode must be a COMPLETE UK postcode: if the shopper gives one, use it; if they name a town or area instead ('near Waterlooville'), use a well-known full postcode for the centre of that place. A place name, a partial code or an invalid radius returns zero results rather than unfiltered ones, so if a location search comes back empty, check what you sent before concluding there is no stock. IMPORTANT: location filtering only reaches dealers who publish their address, which is a minority of stock — so a location search returning nothing does NOT mean there is no stock near the shopper. Say that rather than reporting a confident absence, and offer an unfiltered search as well. Use get_filter_options first to discover available filter values.