Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Autoza UK Public Dealers API
description: 'Public read-only API for searching vehicles, dealers, and market data on Autoza UK (autoza.co.uk). No authentication required. Rate limit (F312): the endpoints marked "rate-limited" allow 100 requests per 24 hours per IP without a key; an x-api-key header with a key issued by Autoza raises that to 1,000. Over the limit they answer 429 with X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers. The limit is approximate: each server instance keeps its own count, so requests spread across instances may get further before a 429. Plan for 100 a day. Listing and dealer counts are never published.'
version: 1.0.0
contact:
name: Autoza Support
email: info@autoza.co.uk
url: https://autoza.co.uk
servers:
- url: https://autoza.co.uk
description: Production
tags:
- name: Dealers
paths:
/api/v1/dealers:
get:
summary: Search dealers
description: Search for car dealers across the UK. Each dealer carries checkedByAutoza, true only where the Autoza team checked the dealer by hand. Rate-limited.
operationId: searchDealers
parameters:
- name: location
in: query
schema:
type: string
description: City or region
- name: checkedByAutoza
in: query
schema:
type: boolean
description: true = only dealers the Autoza team checked by hand
- name: page
in: query
schema:
type: integer
default: 1
- name: limit
in: query
schema:
type: integer
default: 20
maximum: 50
responses:
'200':
description: Dealer list
'429':
$ref: '#/components/responses/RateLimited'
tags:
- Dealers
/api/v1/dealers/{id}:
get:
summary: Get dealer profile
description: 'Get a dealer profile: name, description, public address, phone, website and review count. No stock count is published.'
operationId: getDealer
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Dealer profile
'404':
description: Dealer not found
tags:
- Dealers
components:
responses:
RateLimited:
description: 'Over the limit: 100 requests per 24 hours per IP without a key, 1,000 with an x-api-key (approximate: counted per server instance).'
headers:
X-RateLimit-Limit:
schema:
type: integer
X-RateLimit-Remaining:
schema:
type: integer
X-RateLimit-Reset:
schema:
type: integer
description: Unix time (seconds) when the window resets
securitySchemes:
apiKey:
type: apiKey
in: header
name: x-api-key
description: Optional. Raises the daily limit from 100 to 1,000.