Quick Start
Get vehicle specifications data for 47,000+ cars, 5,400+ trucks, and 1,800+ motorcycles via a simple REST API.
https://api.carsdataset.comX-API-Key: your_api_keyapplication/json100 req/min Paid: 1,000 req/minYour First Request
# Free preview — no API key needed curl "https://api.carsdataset.com/api/v1/preview/search?brand=BMW" # Full access — with API key curl -H "X-API-Key: your_api_key" \ "https://api.carsdataset.com/api/v1/search?brand=BMW"
Authentication
The API uses API key authentication. Include your key in the X-API-Key header with every request.
Free Preview Endpoints
These endpoints require no authentication and return a subset of fields — perfect for evaluation:
GET /api/v1/preview/search # Cars preview GET /api/v1/preview/trucks/search # Trucks preview GET /api/v1/preview/motorcycles/search # Motorcycles preview
Authenticated Endpoints
All other endpoints require a valid API key. Requests without a key return 401 Unauthorized.
curl -H "X-API-Key: sk_live_abc123..." \
"https://api.carsdataset.com/api/v1/search?brand=Toyota"
Try It Live
Hit the API right from your browser. Preview endpoints are free — no API key needed.
Free Preview Endpoints
No API key required. Returns a limited set of fields for evaluation purposes.
Search the cars database. Returns limited fields: brand, model, year, trim, segment, fuel_type, cylinders, power_hp, transmission, drive, weight.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| q | string | optional | Free-text search across brand, model, trim |
| brand | string | optional | Filter by brand name (e.g., BMW, Toyota) |
| model | string | optional | Filter by model name |
| segment | string | optional | Vehicle segment (SUV, Sedan, Hatchback, etc.) |
| fuel_type | string | optional | Fuel type (Gasoline, Diesel, Electric, Hybrid) |
| year_min | integer | optional | Minimum production year |
| year_max | integer | optional | Maximum production year |
| power_min | integer | optional | Minimum power in HP |
| power_max | integer | optional | Maximum power in HP |
| page | integer | optional | Page number (default: 1) |
| page_size | integer | optional | Results per page (default: 20, max: 100) |
Example Request
curl "https://api.carsdataset.com/api/v1/preview/search?brand=BMW&segment=SUV"
Example Response
{
"results": [
{
"brand": "BMW",
"model": "X5",
"year": 2024,
"trim": "xDrive40i",
"segment": "SUV",
"fuel_type": "Gasoline",
"cylinders": 6,
"power_hp": 375,
"transmission": "Automatic",
"drive": "AWD",
"weight": 2185
}
],
"total": 42,
"page": 1,
"page_size": 20
}
Search the trucks database. Returns limited fields for evaluation.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| q | string | optional | Free-text search |
| brand | string | optional | Filter by brand (e.g., Volvo, MAN, Scania) |
| segment | string | optional | Truck segment (Heavy, Medium, etc.) |
| fuel_type | string | optional | Fuel type |
| emission_standard | string | optional | Emission standard (Euro 6, etc.) |
| power_min | integer | optional | Minimum power in HP |
| power_max | integer | optional | Maximum power in HP |
| gvw_min | integer | optional | Minimum gross vehicle weight (kg) |
| gvw_max | integer | optional | Maximum gross vehicle weight (kg) |
| page | integer | optional | Page number (default: 1) |
| page_size | integer | optional | Results per page (default: 20, max: 100) |
Example Request
curl "https://api.carsdataset.com/api/v1/preview/trucks/search?brand=Volvo&segment=Heavy"
Search the motorcycles database. Returns limited fields for evaluation.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| q | string | optional | Free-text search |
| brand | string | optional | Filter by brand (e.g., Ducati, Honda, BMW) |
| category | string | optional | Category (Sport, Naked, Adventure, Cruiser, etc.) |
| fuel_type | string | optional | Fuel type |
| power_min | integer | optional | Minimum power in HP |
| power_max | integer | optional | Maximum power in HP |
| page | integer | optional | Page number (default: 1) |
| page_size | integer | optional | Results per page (default: 20, max: 100) |
Example Request
curl "https://api.carsdataset.com/api/v1/preview/motorcycles/search?brand=Ducati&category=Sport"
Cars Endpoints
Full access to 47,000+ car variants across 108 brands. Requires API key.
Get database statistics including total variants, brands, model count, and year range.
Example Request
curl -H "X-API-Key: your_api_key" \
"https://api.carsdataset.com/api/v1/stats"
Example Response
{
"total_variants": 47344,
"total_brands": 108,
"total_models": 1847,
"year_range": [1898, 2026],
"segments": ["SUV", "Sedan", "Hatchback", "Coupe", ...]
}
List all car brands with their variant counts.
Example Response
{
"brands": [
{ "brand": "Toyota", "count": 523 },
{ "brand": "BMW", "count": 487 },
...
]
}
List all models for a specific brand.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| brand | string | required | Brand name (e.g., BMW) |
Example Request
curl -H "X-API-Key: your_api_key" \
"https://api.carsdataset.com/api/v1/models?brand=BMW"
Full-featured search across all 40+ specification fields. Returns complete vehicle data including dimensions, performance, features, and more.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| q | string | optional | Free-text search across brand, model, trim |
| brand | string | optional | Filter by brand name |
| model | string | optional | Filter by model name |
| year_min | integer | optional | Minimum production year |
| year_max | integer | optional | Maximum production year |
| segment | string | optional | Vehicle segment |
| fuel_type | string | optional | Fuel type |
| power_min | integer | optional | Minimum power in HP |
| power_max | integer | optional | Maximum power in HP |
| page | integer | optional | Page number (default: 1) |
| page_size | integer | optional | Results per page (default: 20, max: 100) |
Example Request
curl -H "X-API-Key: your_api_key" \
"https://api.carsdataset.com/api/v1/search?brand=Porsche&segment=SUV&year_min=2020"
Example Response
{
"results": [
{
"id": 8421,
"brand": "Porsche",
"model": "Cayenne",
"year": 2024,
"trim": "Turbo GT",
"segment": "SUV",
"fuel_type": "Gasoline",
"engine_displacement_cc": 3996,
"cylinders": 8,
"power_hp": 659,
"torque_nm": 850,
"transmission": "Automatic",
"drive": "AWD",
"acceleration_0_100": 3.3,
"top_speed_kmh": 300,
"weight": 2340,
"length_mm": 4930,
"width_mm": 1995,
"height_mm": 1656,
"wheelbase_mm": 2895,
"fuel_consumption_combined": 13.2,
"co2_emissions": 300,
"features": ["Adaptive Air Suspension", "Ceramic Brakes", ...],
// ... 40+ fields total
}
],
"total": 12,
"page": 1,
"page_size": 20
}
Get complete specifications for a single vehicle by its ID.
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | required | Vehicle ID (from search results) |
Example Request
curl -H "X-API-Key: your_api_key" \
"https://api.carsdataset.com/api/v1/vehicle/8421"
Trucks Endpoints
Access 5,400+ commercial vehicle variants. Requires API key.
Get truck database statistics.
Example Request
curl -H "X-API-Key: your_api_key" \
"https://api.carsdataset.com/api/v1/trucks/stats"
List all truck brands with variant counts.
Example Request
curl -H "X-API-Key: your_api_key" \
"https://api.carsdataset.com/api/v1/trucks/brands"
Full search across all 45+ truck specification fields including GVW, axle configuration, emission standards, and more.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| q | string | optional | Free-text search |
| brand | string | optional | Filter by brand name |
| model | string | optional | Filter by model name |
| year_min | integer | optional | Minimum production year |
| year_max | integer | optional | Maximum production year |
| segment | string | optional | Truck segment (Heavy, Medium, etc.) |
| fuel_type | string | optional | Fuel type |
| emission_standard | string | optional | Emission standard (Euro 6, etc.) |
| power_min | integer | optional | Minimum power in HP |
| power_max | integer | optional | Maximum power in HP |
| gvw_min | integer | optional | Minimum gross vehicle weight (kg) |
| gvw_max | integer | optional | Maximum gross vehicle weight (kg) |
| page | integer | optional | Page number (default: 1) |
| page_size | integer | optional | Results per page (default: 20, max: 100) |
Example Request
curl -H "X-API-Key: your_api_key" \
"https://api.carsdataset.com/api/v1/trucks/search?brand=MAN&segment=Heavy&power_min=400"
Get complete specifications for a single truck by its ID.
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | required | Truck ID (from search results) |
Example Request
curl -H "X-API-Key: your_api_key" \
"https://api.carsdataset.com/api/v1/trucks/142"
Motorcycles Endpoints
Access 1,800+ motorcycle variants across 170+ brands. Requires API key.
Get motorcycle database statistics.
Example Request
curl -H "X-API-Key: your_api_key" \
"https://api.carsdataset.com/api/v1/motorcycles/stats"
List all motorcycle brands with variant counts.
Example Request
curl -H "X-API-Key: your_api_key" \
"https://api.carsdataset.com/api/v1/motorcycles/brands"
Full search across all 40+ motorcycle specification fields including engine, chassis, electronics, and performance data.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| q | string | optional | Free-text search |
| brand | string | optional | Filter by brand name |
| model | string | optional | Filter by model name |
| year_min | integer | optional | Minimum production year |
| year_max | integer | optional | Maximum production year |
| category | string | optional | Category (Sport, Naked, Adventure, Cruiser, Touring, etc.) |
| fuel_type | string | optional | Fuel type |
| power_min | integer | optional | Minimum power in HP |
| power_max | integer | optional | Maximum power in HP |
| page | integer | optional | Page number (default: 1) |
| page_size | integer | optional | Results per page (default: 20, max: 100) |
Example Request
curl -H "X-API-Key: your_api_key" \
"https://api.carsdataset.com/api/v1/motorcycles/search?brand=Ducati&category=Sport&power_min=150"
Get complete specifications for a single motorcycle by its ID.
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | required | Motorcycle ID (from search results) |
Example Request
curl -H "X-API-Key: your_api_key" \
"https://api.carsdataset.com/api/v1/motorcycles/305"
Pricing
Choose the dataset or API access plan that fits your needs.
Datasets (one-time purchase)
108 brands
40+ fields per vehicle
CSV + JSON export
Commercial vehicles
45+ fields per truck
CSV + JSON export
170+ brands
40+ fields per bike
CSV + JSON export
Cars + Trucks + Motos
Priority support
Quarterly updates
API Access
Limited fields
100 requests/min
No API key needed
All fields (40-45+ per vehicle)
1,000 requests/min
Email support
5,000 requests/min
Priority support
Early access to new datasets
Instant access. API key emailed on payment. Cancel anytime via the customer portal below.
Manage your subscription
Already a customer? Enter the email you used at checkout to open Stripe's secure customer portal. From there you can update your card, download invoices, or cancel your subscription — no login or password required.