# Autotrader Ad

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/autotrader/ad` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 2 credits per call |
| **Documentation** | https://www.piloterr.com/library/autotrader-ad |

## Description

Extract full vehicle details from an AutoTrader UK car-details URL, including price, specs, gallery, seller, and description via browser rendering.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/autotrader/ad' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lookup 2011 Vauxhall Astra at Selekt Motors

```json
{
  "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": "Selekt Motors",
    "type": "dealer",
    "phone": "07308350693",
    "rating": 4.8,
    "location": "Slough"
  },
  "subtitle": null,
  "description": "Selekt 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
}
```

## Documentation

## Overview
Extract full vehicle details from any AutoTrader UK advert page (`autotrader.co.uk/car-details/{id}`). Returns price, specifications, photo gallery, seller info, description, and reserve availability.

AutoTrader advert pages are React single-page applications (`sauron-adverts-app`). Price, specs, gallery, and seller blocks load via JavaScript after the initial HTML shell. Piloterr uses **website rendering** to execute the page in a browser, wait for key sections (`advert-price`, `overview`, `key-information`), and scrape structured JSON from the rendered DOM.

## Quickstart
```
GET https://api.piloterr.com/v2/autotrader/ad?query=https://www.autotrader.co.uk/car-details/202606053030491
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Full AutoTrader UK `/car-details/{id}` URL |

## Response fields
| Field | Type | Description |
|---|---|---|
| `id` | string | AutoTrader advert ID |
| `url` | string | Canonical listing URL |
| `title` | string \| null | Listing title |
| `subtitle` | string \| null | Trim / derivative |
| `price` | string \| null | Formatted price |
| `price_amount` | integer \| null | Numeric price in GBP |
| `description` | string \| null | Full listing description |
| `image` | string \| null | Main image URL |
| `images` | array | Full photo gallery URLs |
| `reserve_available` | boolean | Whether online reserve is available |
| `specifications` | object | Vehicle specs (engine, gearbox, mileage, fuel, etc.) |
| `specifications.registration` | string \| null | Registration year |
| `specifications.mileage` | string \| null | Mileage |
| `specifications.fuel_type` | string \| null | Fuel type |
| `specifications.gearbox` | string \| null | Transmission |
| `specifications.body_type` | string \| null | Body style |
| `specifications.engine` | string \| null | Engine size |
| `seller` | object | Dealer or private seller info |
| `seller.name` | string \| null | Seller name |
| `seller.type` | string \| null | `dealer` or `private` |
| `seller.location` | string \| null | Seller location |
| `seller.phone` | string \| null | Contact phone |
| `seller.rating` | number \| null | Dealer rating |

## Notes
- Targets **autotrader.co.uk** (UK). US listings on autotrader.com are not supported.
- `seller.phone` and `seller.rating` may be absent on private listings.
- `specifications` keys are normalized to snake_case.
- `subtitle` may be `null` on some listings.

## Main use cases
- Extract full vehicle specs for inventory or comparison tools
- Pull dealer contact details for automotive lead generation
- Monitor individual listings for price changes
- Build VIN-free market datasets from public advert pages