API Documentation v1.0

CarData API Documentation

Complete guide to integrating with our car data API. Access thousands of car listings from major automotive websites with real-time updates and comprehensive filtering.

Get Started

Need an API Key?

Sign Up Free

Base URL

https://api.cardata.io/v1

Authentication

The CarData API uses Bearer token authentication. Include your API key in the Authorization header of each request.

✓ Correct Usage:

Authorization: Bearer YOUR_API_KEY

✗ Incorrect Usage:

Authorization: YOUR_API_KEY

API Endpoints

Get car listings with optional filters

Parameters

make
string
Optional
Filter by car make (e.g., 'toyota', 'honda')
model
string
Optional
Filter by car model (e.g., 'camry', 'civic')
year
integer
Optional
Filter by year (e.g., 2020, 2023)
min_price
integer
Optional
Minimum price filter
max_price
integer
Optional
Maximum price filter
location
string
Optional
Filter by location (city, state)
limit
integer
Optional
Number of results (max 100, default 20)
offset
integer
Optional
Pagination offset (default 0)
curl -X GET "https://api.cardata.io/v1/cars?make=toyota&year=2023&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Error Handling

400

Bad Request

Invalid request parameters or malformed request

401

Unauthorized

Invalid or missing API key

403

Forbidden

API key doesn't have required permissions

404

Not Found

Requested resource not found

429

Too Many Requests

Rate limit exceeded

500

Internal Server Error

Server error occurred

Rate Limits

Rate limits vary by subscription plan. All plans include burst capacity for peak usage periods.

Starter

1,000

requests/month

Pro

25,000

requests/month

Enterprise

Unlimited

requests/month

Response Headers

X-RateLimit-Limit: 25000

X-RateLimit-Remaining: 24850

X-RateLimit-Reset: 1672531200

Need Help?