# Carwow Used Car Listing API Documentation

Retrieve one used car listing on Carwow UK: title, variant, price in GBP, new list price, deal score, brand, model, body type, fuel, transmission, location, dealer name, year, mileage in miles, engine size, power in bhp, doors, seats, colour, CO2 in g/km, insurance group, performance figures, dealer description, key features, full equipment list and photo urls. The dealer phone number, registration plate and car history are not returned. A sold or expired listing answers 404 and is not billed.

- **Documentation:** [https://scrappa.co/docs/carwow-api/carwow_listing](https://scrappa.co/docs/carwow-api/carwow_listing)
- **API group:** Carwow API
- **Endpoint:** `GET https://scrappa.co/api/carwow/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 |
| --- | --- | --- | --- |
| `id` | string | Yes | Carwow listing id, 32 lowercase hexadecimal characters. Take it from the Used Car Search id field. Example: 477cee498868031513cd61317c4a9ccc. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/carwow/listing?id=477cee498868031513cd61317c4a9ccc"
```

## Example response

```json
{
    "success": true,
    "data": {
        "id": "477cee498868031513cd61317c4a9ccc",
        "url": "https://quotes.carwow.co.uk/deals/477cee498868031513cd61317c4a9ccc",
        "title": "Used 2022 BMW 4 Series 420i Step Auto M Sport for sale",
        "variant": "420i Step Auto M Sport",
        "state": "used",
        "price": 27490,
        "currency": "GBP",
        "rrp": 46180,
        "deal_score": 6.3,
        "brand": "BMW",
        "brand_slug": "bmw",
        "model": "4 Series",
        "model_slug": "4-series",
        "body_type": "coupe",
        "fuel": "petrol",
        "transmission": "automatic",
        "location": "Magdalen Laver",
        "dealer": {
            "name": "Prestige Cars GB",
            "top_rated": true
        },
        "year": 2022,
        "mileage": 20800,
        "engine_litres": 2,
        "power_bhp": 184,
        "doors": 2,
        "seats": 4,
        "colour": "Metallic - Black sapphire",
        "co2_g_km": 144,
        "emissions_standard": "euro-6",
        "insurance_group": "30E",
        "acceleration_0_62_mph_seconds": 7.5,
        "top_speed_mph": 149,
        "mpg": 44.8,
        "boot_litres": 440,
        "description": "Active Guard Plus,Airbags,Alarm System - Thatcham 1 with Remote Control and Engine Immobiliser,Attentiveness Assistant,B...",
        "features": [
            "Android Auto",
            "Apple CarPlay",
            "Cruise control",
            "Heated seats",
            "Navigation",
            "Parking Camera",
            "Parking Sensors",
            "Touchscreen infotainment"
        ],
        "equipment": [
            "Airbags",
            "Alarm System - Thatcham 1 with Remote Control and Engine Immobiliser",
            "Bluetooth Hands-Free Facility with USB Audio Interface and Audio Streaming"
        ],
        "images": [
            "https://carwow-uk-0.imgix.net/stock-car-custom-images/original/4441907d-bdab-08d9-8bd7-6a29391e612e?auto=format&cs=tinysrgb&fit=clip&ixlib=rb-1.1.0&q=60&w=900",
            "https://carwow-uk-0.imgix.net/stock-car-custom-images/original/9c1c4669-cda7-1fde-4e24-71c3ba3166f2?auto=format&cs=tinysrgb&fit=clip&ixlib=rb-1.1.0&q=60&w=900"
        ]
    },
    "meta": {
        "endpoint_family": "listing",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 404 | Resource Not Found | The requested Carwow resource does not exist. This response is not billable. |
| 503 | Invalid Source Response | The upstream answered with a page that no longer matches the documented contract. This response is not billable. |
| 503 | Service Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

## 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)