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 Stats 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: Stats
paths:
/api/v1/stats:
get:
summary: Market statistics
description: Asking-price summary, top makes and fuel types by share of live stock. Rate-limited. Shares, never counts.
operationId: getStats
responses:
'200':
description: pricing { averagePrice, lowestPrice, highestPrice }, topMakes[], fuelTypeBreakdown[]
'429':
$ref: '#/components/responses/RateLimited'
tags:
- Stats
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.