# Auto Trader UK Listing API Documentation

Retrieve one vehicle listing by advert id with full specs, key specification, equipment features, gallery, history, ownership, running costs, finance, price indicator, mileage comparison, dealer summary and the public description. Private contact data is stripped.

- **Documentation:** [https://scrappa.co/docs/autotrader-uk-api/autotrader_uk_listing](https://scrappa.co/docs/autotrader-uk-api/autotrader_uk_listing)
- **API group:** Auto Trader UK API
- **Endpoint:** `GET https://scrappa.co/api/autotrader-uk/v1/listing`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `advert_id` | string | Yes | Listing identifier, e.g. 202608215320508. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/autotrader-uk/v1/listing?advert_id=202608215320508"
```

## Example response

```json
{
    "success": true,
    "data": {
        "listing": {
            "id": "202608215320508",
            "details": {
                "title": "2018 BMW 4 Series"
            }
        }
    },
    "meta": {
        "endpoint_family": "listing"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Record Not Found | The requested listing or dealer is no longer available. This response is not billable. |
| 422 | Validation Error | A public parameter or range is invalid. This response is not billable. |
| 502 | Invalid Source Response | Auto Trader UK returned an invalid response. This response is not billable. |
| 503 | Service Unavailable | The service could not obtain a complete result. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)