# AutoUncle Car API Documentation

Returns one car by its numeric AutoUncle id from a search result: the same fields as a search car plus compared_cars_count (how many similar cars the rating compares against) and price_history, a list of dated prices with ISO dates in ascending order. price_history is omitted when AutoUncle has no history for the car. Listings expire, so an id that is no longer listed answers 404 with error.code NOT_FOUND, which is not billable.

- **Documentation:** [https://scrappa.co/docs/autouncle-api/autouncle_car](https://scrappa.co/docs/autouncle-api/autouncle_car)
- **API group:** AutoUncle API
- **Endpoint:** `GET https://scrappa.co/api/autouncle/car`

## 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 | The numeric AutoUncle car id from a search result, for example 227114350. |
| `country` | string | No | de (Germany, default) or uk (United Kingdom). |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/autouncle/car?id=227114350&country=de"
```

## Example response

```json
{
    "success": true,
    "data": {
        "id": 227114350,
        "url": "https://www.autouncle.de/de/d/227114350-gebraucht-2023-bmw-320-sport-line-190-ps",
        "title": "BMW 320 d",
        "price": 20790,
        "predicted_price": 23400,
        "currency": "EUR",
        "price_rating": 4,
        "price_rating_label": "Guter Preis",
        "price_difference": 2610,
        "days_on_market": 28,
        "compared_cars_count": 716,
        "price_history": [
            {
                "date": "2026-09-17",
                "price": 22470
            },
            {
                "date": "2026-10-08",
                "price": 21490
            },
            {
                "date": "2026-10-14",
                "price": 20790
            }
        ]
    },
    "meta": {
        "endpoint_family": "car",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The requested car is not listed on AutoUncle (any more). This response is not billable. |
| 422 | Validation Error | A public parameter is invalid, including an unknown country or a non-numeric id. This response is not billable. |
| 503 | Service Unavailable | The service could not obtain a complete result from AutoUncle. 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)