Follow these steps to start retrieving auction data from the API.
Create an account to access the API.
Sign Up / Sign InAfter signing up and subscribing to a plan, generate an API key in your profile settings.
Go to ProfileKeep your API key secure. Include it in all requests using the Authorization header:
Authorization: Bearer YOUR_API_KEYQuery the /makes endpoint to get a list of all vehicle makes in the database.
curl "https://api.oldcarsdata.com/makes"{
"data": [
"Toyota",
"Ford",
"Chevrolet",
"BMW",
"Mercedes-Benz"
]
}Use the /models endpoint to get available models for a specific make.
curl "https://api.oldcarsdata.com/models?make=Toyota"{
"data": [
"Land Cruiser",
"Supra",
"Celica",
"Corolla"
]
}Now you can retrieve auction data using the /auctions endpoint with the make and model you discovered.
curl "https://api.oldcarsdata.com/auctions?make=Toyota&model=Land+Cruiser&limit=10" \
-H "Authorization: Bearer YOUR_API_KEY"{
"data": [
{
"id": 12345,
"source": "bringatrailer",
"url": "https://bringatrailer.com/listing/...",
"title": "1970 Toyota Land Cruiser FJ40",
"auction_status": "sold",
"price": 45000,
"auction_end_date": "2024-01-15",
"mileage": 85000,
"year": 1970,
"listing_make": "Toyota",
"listing_model": "Land Cruiser",
"engine": "4.2L I6",
"drivetrain": "4WD",
"transmission": "Manual",
"body_style": "SUV",
"exterior_color": "Beige",
"interior_color": "Brown",
...
}
],
"meta": {
"total": 150,
"page": 1,
"limit": 10,
"total_pages": 15
}
}You're ready to start building with the API. Explore the endpoint documentation for detailed information on all available parameters, filters, and response fields.