# AutoTrack Search

Search current AutoTrack.nl vehicle listings. Enum facets (make, fuel, transmission, body type, seller type, province) and range facets (price, year, mileage, power) map to the upstream facet body. has_more is computed from the live total. The make_id value is a UUID from the filters endpoint. The upstream facet taxonomy is not part of the response; read it from the filters endpoint.

- **Documentation:** [https://scrappa.co/docs/autotrack-nl-api/autotrack_nl_search](https://scrappa.co/docs/autotrack-nl-api/autotrack_nl_search)
- **API group:** AutoTrack API
- **Endpoint:** `GET https://scrappa.co/api/autotrack-nl/listings/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 |
| --- | --- | --- | --- |
| `pageNumber` | integer | No | Page number, starting at 1. |
| `pageSize` | integer | No | Listings per page, 1 to 100. Defaults to 30. |
| `sortField` | string | No | relevance, bouwjaar, datumGeplaatst, kilometerstand, merkModelUitvoering, prijs or afstand. |
| `sortOrder` | string | No | asc or desc. |
| `make_id` | array | No | Repeatable make/model UUID from the filters endpoint. |
| `fuel` | array | No | Repeatable fuel value, for example BENZINE or DIESEL. |
| `transmission` | array | No | Repeatable transmission value: AUTOMATISCH or HANDMATIG. |
| `body_type` | array | No | Repeatable body type, for example SUV or STATIONWAGEN. |
| `seller_type` | array | No | Repeatable seller type, for example OFFICIELE_MERKDEALER. |
| `province` | array | No | Repeatable province, for example Utrecht. |
| `listed_within_days` | integer | No | Only listings posted within this many days. |
| `price_min` | integer | No | Minimum price in EUR. |
| `price_max` | integer | No | Maximum price in EUR. |
| `year_min` | integer | No | Minimum first-registration year. |
| `year_max` | integer | No | Maximum first-registration year. |
| `mileage_min` | integer | No | Minimum mileage in km. |
| `mileage_max` | integer | No | Maximum mileage in km. |
| `power_min` | integer | No | Minimum power in hp. |
| `power_max` | integer | No | Maximum power in hp. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/autotrack-nl/listings/search?pageSize=3&sortField=prijs&sortOrder=asc"
```

## Example response

```json
{
    "success": true,
    "data": {
        "total": 224936,
        "page_number": 1,
        "page_size": 3,
        "has_more": true,
        "listings": [
            {
                "id": 60203016,
                "kenteken": "97HVXN",
                "price": 350,
                "currency": "EUR",
                "vehicle": {
                    "make": "Peugeot",
                    "model": "206",
                    "year": 2002,
                    "mileage_km": 298443
                }
            }
        ]
    },
    "meta": {
        "endpoint_family": "search"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A public parameter or range is invalid. 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)