# AutoUncle Search API Documentation

Search used cars on AutoUncle for Germany (country=de, EUR) or the United Kingdom (country=uk, GBP). Every car carries its price, the predicted market price, a price rating from 1 (expensive) to 5 (best price), the price difference and the days on market. Paginate with page. AutoUncle returns a variable number of cars per page and no total, so has_more is true while the page holds cars; a page past the end returns an empty cars array, which is a successful, billable response. Filters such as min_year, max_year and the price range can add a few similar cars next to the exact matches. price_rating_label is available for Germany only.

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

## 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 |
| --- | --- | --- | --- |
| `country` | string | No | de (Germany, default) or uk (United Kingdom). |
| `brand` | string | No | Car brand, for example BMW. |
| `model` | string | No | Car model, for example 320. Needs brand. |
| `min_price` | integer | No | Minimum price in the country currency. |
| `max_price` | integer | No | Maximum price in the country currency. |
| `min_year` | integer | No | Minimum build year, 1950 to 2100. |
| `max_year` | integer | No | Maximum build year, 1950 to 2100. |
| `fuel_type` | array | No | Repeatable fuel filter in the country language, for example fuel_type[]=Diesel. Up to 5 values. |
| `page` | integer | No | 1-based page number, 1 to 100. Defaults to 1. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/autouncle/search?country=de&brand=BMW&model=320&page=1"
```

## Example response

```json
{
    "success": true,
    "data": {
        "search_metadata": {
            "country": "de",
            "page": 1,
            "result_count": 50,
            "has_more": true
        },
        "cars": [
            {
                "id": 228563103,
                "url": "https://www.autouncle.de/de/d/228563103-gebraucht-2021-bmw-320-m-sport-190-ps",
                "title": "BMW 320 d Touring M Sport LED PA DA ACC AHK HiFi",
                "brand": "BMW",
                "model": "320",
                "price": 27980,
                "predicted_price": 27300,
                "currency": "EUR",
                "price_rating": 3,
                "price_rating_label": "Fairer Preis",
                "price_difference": -680,
                "days_on_market": 1,
                "mileage_km": 104527,
                "year": 2021,
                "fuel": "Diesel",
                "latitude": 51.252162,
                "longitude": 7.131963
            }
        ]
    },
    "meta": {
        "endpoint_family": "search",
        "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)