Piloterr

Autotrader Search

Search AutoTrader UK listings from a car-search URL and retrieve prices, specs, photos, seller info, and pagination via browser rendering.

Credit cost: 2 credits per call

GET
/v2/autotrader/search

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Full AutoTrader UK car search URL.

Example 1 (used cars near London):

https://www.autotrader.co.uk/car-search?channel=cars&postcode=W1F%208EB&price_search_type=total&sort=relevance&page=1

Example 2 (page 2):

https://www.autotrader.co.uk/car-search?channel=cars&postcode=W1F%208EB&price_search_type=total&sort=relevance&page=2

Notes:

  • Only autotrader.co.uk /car-search URLs are accepted.
  • Copy the full URL from autotrader.co.uk, including filters (postcode, make, price, etc.).
  • Pagination via ?page=2 in the URL.
  • AutoTrader search pages are JavaScript SPAs; this endpoint uses website rendering to scrape the rendered listing cards.
  • Use each result's url with the AutoTrader Ad endpoint for full vehicle data.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/autotrader/search?query=string"
{
  "results": [
    {
      "id": "202605302836426",
      "url": "https://www.autotrader.co.uk/car-details/202605302836426?journey=FEATURED_LISTING_JOURNEY&sort=relevance&twcs=true&searchId=3e386cc3-ab04-4465-bc96-dc0210e1801f&page=1&postcode=W1F%208EB&advertising-location=at_cars&fromsra&backLinkQueryParams=channel%3Dcars%26postcode%3DW1F%25208EB%26price_search_type%3Dtotal%26sort%3Drelevance%26page%3D1%26flrfc%3D1",
      "year": "2007 (07 reg)",
      "image": "https://m.atcdn.co.uk/a/media/w480/a75ac2d47f854a5ebaf070a25c3fe883.jpg",
      "price": "£2,500",
      "title": "Ford Focus1.8 Sport S 5dr",
      "images": [
        "https://m.atcdn.co.uk/a/media/w480/a75ac2d47f854a5ebaf070a25c3fe883.jpg",
        "https://m.atcdn.co.uk/a/media/w480/5f16246bee0e45d68ea4af8ee80b0d41.jpg"
      ],
      "mileage": "93,018 miles",
      "location": "Leicester",
      "subtitle": "1.8 Sport S 5dr",
      "seller_type": "dealer",
      "price_amount": 2500,
      "attention_grabber": "FULL SERVICE HISTORY+2 KEYS!!!"
    },
    {
      "id": "202606053041984",
      "url": "https://www.autotrader.co.uk/car-details/202606053041984?sort=relevance&twcs=true&searchId=3e386cc3-ab04-4465-bc96-dc0210e1801f&page=1&postcode=W1F%208EB&advertising-location=at_cars&fromsra&backLinkQueryParams=channel%3Dcars%26postcode%3DW1F%25208EB%26price_search_type%3Dtotal%26sort%3Drelevance%26page%3D1%26flrfc%3D1",
      "year": "2014 (14 reg)",
      "image": "https://m.atcdn.co.uk/a/media/w480/27178641a4bc471ebd9a6ea3d1d388fe.jpg",
      "price": "£3,795",
      "title": "Toyota Prius1.5 CVT 4dr",
      "images": [
        "https://m.atcdn.co.uk/a/media/w480/27178641a4bc471ebd9a6ea3d1d388fe.jpg",
        "https://m.atcdn.co.uk/a/media/w480/8834d446806d446c826019ae2ad60870.jpg"
      ],
      "mileage": "82,000 miles",
      "location": "Sidcup",
      "subtitle": "1.5 CVT 4dr",
      "seller_type": "dealer",
      "price_amount": 3795,
      "attention_grabber": "LOW MILEAGE|CHEAP INSURANCE"
    },
    {
      "id": "202605182478887",
      "url": "https://www.autotrader.co.uk/car-details/202605182478887?sort=relevance&twcs=true&searchId=3e386cc3-ab04-4465-bc96-dc0210e1801f&page=1&postcode=W1F%208EB&advertising-location=at_cars&fromsra&backLinkQueryParams=channel%3Dcars%26postcode%3DW1F%25208EB%26price_search_type%3Dtotal%26sort%3Drelevance%26page%3D1%26flrfc%3D1",
      "year": "2013 (13 reg)",
      "image": "https://m.atcdn.co.uk/a/media/w480/e8979c3380f24cf6a9a36a09206eafd4.jpg",
      "price": "£500",
      "title": "Ford Fiesta1.0T EcoBoost Zetec Euro 5 (s/s) 3dr",
      "images": [
        "https://m.atcdn.co.uk/a/media/w480/e8979c3380f24cf6a9a36a09206eafd4.jpg",
        "https://m.atcdn.co.uk/a/media/w480/216166463ac64cd8957e5ee02b4479d1.jpg"
      ],
      "mileage": "89,000 miles",
      "location": "Hughenden",
      "subtitle": "1.0T EcoBoost Zetec Euro 5 (s/s) 3dr",
      "seller_type": "dealer",
      "price_amount": 500,
      "attention_grabber": "Spares or repairs"
    }
  ],
  "pagination": {
    "next": 2,
    "current": 1,
    "next_url": "https://www.autotrader.co.uk/car-search?page=2",
    "per_page": 25,
    "total_count": 464626,
    "total_pages": 18586,
    "has_next_page": true
  }
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}