---
title: "GET /autotrader-uk/v1/dealer-listings"
method: GET
path: "/autotrader-uk/v1/dealer-listings"
tags: ["AutotraderUk"]
---

# GET /autotrader-uk/v1/dealer-listings

`GET /autotrader-uk/v1/dealer-listings`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/autotrader-uk/v1/dealer-listings`
- Auth: API key in header `X-API-KEY`

## Query parameters

- `postcode` string, required
- `price_search_type` 'total' | 'monthly'
- `make` string, nullable
- `model` string, nullable
- `body_type` string, nullable
- `colour` string, nullable
- `transmission` string, nullable
- `seller_type` 'private' | 'trade' | 'null', nullable
- `fuel_type[]` string[]
- `min_price` integer, nullable
- `max_price` integer, nullable
- `min_year_manufactured` integer, nullable
- `max_year_manufactured` integer, nullable
- `min_mileage` integer, nullable
- `max_mileage` integer, nullable
- `distance` integer, nullable
- `sort` 'relevance' | 'price_asc' | 'price_desc' | 'distance' | 'mileage' | 'year_dsc' | 'year_asc' | 'most_recent'
- `page` integer
- `retailer_id` string, required

## Response `200`

- string

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `404`: The requested listing or dealer is no longer available. This response is not billable.
- `422`: A public parameter or range is invalid. This response is not billable.
- `503`: The service could not obtain a complete result. This response is not billable.

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/2f4af6143d10?raw)