Autotrader Ad
GET
Extract full vehicle details from an AutoTrader UK car-details URL, including price, specs, gallery, seller, and description via browser rendering.
Credit cost: 2 credits per call
ApiKeyAuthheader
x-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringFull AutoTrader UK car details URL.
Example:
https://www.autotrader.co.uk/car-details/202606053030491Notes:
- Only
/car-details/{id}listing URLs on autotrader.co.uk are accepted. - Query parameters in the URL are ignored; the listing ID in the path is used.
- AutoTrader advert pages are JavaScript SPAs; this endpoint uses website rendering to scrape price, specs, gallery, seller, and description from the rendered page.
- Copy the listing URL from search results or from autotrader.co.uk.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
Default
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
Default
falseSuccessful response
application/json- response
id?stringurl?stringimage?stringprice?stringtitle?stringimages?array<string>seller?subtitle?unknowndescription?stringprice_amount?integerspecifications?reserve_available?booleancurl -X GET 'https://api.piloterr.com/v2/autotrader/ad?query=string'Example Response
{ "id": "202606053030491", "url": "https://www.autotrader.co.uk/car-details/202606053030491", "image": "https://m.atcdn.co.uk/a/media/w800/ed2eccf887a74d7b99442845d25c21ce.jpg", "price": "£2,499", "title": "2011 Vauxhall Astra", "images": [ "https://m.atcdn.co.uk/a/media/w800/ed2eccf887a74d7b99442845d25c21ce.jpg", "https://m.atcdn.co.uk/a/media/w600/d0da32981b3e414e9cc118f4002bc0a2.jpg", "https://m.atcdn.co.uk/a/media/w600/cba1aac371534b4581d54ebab50826e8.jpg", "https://m.atcdn.co.uk/a/media/w600/b15422acf30941a39b601108d047f179.jpg", "https://m.atcdn.co.uk/a/media/w600/32e08ec56ffe447a9f1a340b4113f3d4.jpg", "https://m.atcdn.co.uk/a/media/w600/066c40651e4b4f949613f505839db631.jpg", "https://m.atcdn.co.uk/a/media/w600/4343522b4f70426a9dcbc818364351d0.jpg" ], "seller": { "name": "Example Motors", "type": "dealer", "phone": "555-0100", "rating": 4.8, "location": "Slough" }, "subtitle": null, "description": "Example Motors present this Beautiful Vauxhall Astra 1.4L petrol !!! A GREAT SPEC CAR with Low miles and ONLY 2 OWNERS FROM NEW !! Drives very smoothly and super comfortable to be in. Both engine and gearbox are smooth. Cheap to insure and tax. Overall a very economical car!\n\n● ELECTRIC HANDBRAKE \n● RUNS ANS DRIVED SMOOTHLY \n● Very low miles\n● ULEZ COMPLIANT ✅️ \n● We charge an admin fee of £199\n● SERVICE HISTORY \n● Long MOT\n●AUTOMATIC \n● 2 KEYS 🔑 \n● Electric Hand Brake\n● Cruise Control \n● Tem...", "price_amount": 2499, "specifications": { "doors": "5", "seats": "5", "engine": "1.4L", "gearbox": "Manual", "mileage": "59,000 miles", "body_type": "Hatchback", "fuel_type": "Petrol", "body_colour": "Silver", "registration": "2011 (11 reg)", "emission_class": "Euro 5" }, "reserve_available": false}