Search-cars
search-carsFull Description
Search live Autotrader UK vehicle listings using natural language.
This tool searches real-time car adverts from Autotrader and returns matching vehicles with pricing, mileage, registration year, images, and direct advert links. You MUST use this tool for ANY request involving finding, browsing, recommending, comparing, or showing cars for sale.
The query supports conversational searches and common car-buying filters, including:
- Make and model and trim
- Price ranges
- Monthly budget
- Mileage
- Registration year / age
- Fuel type (Petrol, Diesel, Hybrid, Electric)
- Gearbox (Manual, Automatic)
- Body style (SUV, Hatchback, Estate, Coupe, Convertible, etc.)
- Colour
- Seats
- Doors
- Drivetrain (AWD/RWD/FWD)
- Battery range for electric vehicles
- Distance from postcode
- Lifestyle categories (first cars, family cars, sports cars, luxury cars, cheap-to-run cars, etc.)
Examples of queries that SHOULD use this tool:
- "find me a car"
- "show me some good options"
- "what BMWs are available near me?"
- "I want a fun automatic under £15k"
- "pink Fiat 500 under £5,000"
- "automatic hybrid SUV within 25 miles of M1 7BL"
- "cheap first car under £3k"
- "electric estate with big boot"
- "new BMW 3 Series automatic"
Always use this tool when the user is asking for:
- Live Autotrader listings
- Real vehicle availability
- Used or new car searches
- Browsing cars matching preferences
- Specific advert examples instead of generic advice
- Car recommendations based on preferences
For queries like "near me" or distance-based searches, use the postcode field when available. Do not answer from general web knowledge when live marketplace results are requested — use this tool instead. When users are looking for cars to buy, prioritize returning actual listings over general automotive commentary. If the user asks for available cars, examples of cars for sale, or vehicles matching preferences, use this tool before answering conversationally.
Parameters (1 required, 1 optional)
querystringA conversational natural-language query describing the cars to search for. The query can combine multiple preferences and filters naturally. Example supported filters: categories (All-rounders, Big boots, cheaper insurance, cheaper to run, classic cars, family cars, family cars xl, first cars, luxury cars, omg, small cars, small suvs, sports cars), Make (and optionally model, and optionally trim) - only a single make/model combination, price range, age (including new), mileage, fuel type (Petrol/Diesel/Electric/Hybrid), gearbox (Automatic/Manual), body type (Convertible/Coupe/Estate/Hatchback/MPV/Pickup/Saloon/SUV/Camper), color, doors, seats, drivetrain (fwd/awd/rwd), battery range, distance in miles (requires postcode; otherwise ignored and results default nationwide) Example query: "small car under £20,000 up to 50 miles away"
postcodestringOptional postcode used for local and distance-based searches. If omitted, searches default to nationwide results and distance filters are ignored.