Car Database API v2.0

Complete Car Database REST API with enhanced features, improved performance, and better data structure. Access makes, models, generations, trims, and full vehicle specifications.

Get Started View Examples
⚠️ Important: This is version 2.0 of our API. For the original API v1, visit the v1 documentation. Both versions are currently supported during the migration period.

What's New in v2.0

🚀 Enhanced Performance

Improved database structure with better indexing and optimized queries for faster response times.

📊 Better Data Structure

New normalized database schema with separate tables for makes, models, generations, and trims.

🔧 Simplified API

Removed language parameter (Russian support) for cleaner and more focused API design.

⚡ Smart Caching

Built-in file caching system with 1-hour cache lifetime to reduce database load.

🔒 Enhanced Security

Improved API key validation and expiration checking with better error handling.

🌐 Multiple Formats

Support for JSON, XML, CSV, Excel (XLS), and TXT formats from the same endpoint.

API Formats & Base URL

Base URL for v2.0:
https://databases.one/api_v2/

JSON (Default)

Perfect for web applications with CORS support and UTF-8 encoding.

https://databases.one/api_v2/?format=json&select=make&api_key=Your_Database_Api_Key

XML

Structured XML output for enterprise systems and legacy applications.

https://databases.one/api_v2/?format=xml&select=make&api_key=Your_Database_Api_Key

CSV

Comma-separated values for spreadsheets and data analysis tools.

https://databases.one/api_v2/?format=csv&select=make&api_key=Your_Database_Api_Key

Excel (XLS)

Microsoft Excel XLSX format with automatic download.

https://databases.one/api_v2/?format=xls&select=make&api_key=Your_Database_Api_Key

TXT

Text file with pipe delimiter for easy parsing.

https://databases.one/api_v2/?format=txt&select=make&api_key=Your_Database_Api_Key

🚀 Try Our Live Demo

Test the API v2.0 with our demo endpoints (uses test API key):

View All Makes Acura Models Acura Trims Last Update

Car Makes

Retrieve vehicle manufacturers (brands) from our database.

Get All Car Makes

Endpoint:
https://databases.one/api_v2/?format=json&select=make&api_key=Your_Database_Api_Key
Response Example:
{
  "errors": 0,
  "result": [
    {
      "make_id": "1",
      "Make": "Acura"
    },
    {
      "make_id": "2",
      "Make": "Alfa Romeo"
    },
    ...
  ]
}

Get Specific Makes

Get multiple makes by ID:
https://databases.one/api_v2/?format=json&select=make&make_id=1,2,3&api_key=Your_Database_Api_Key
Get single make:
https://databases.one/api_v2/?format=json&select=make&make_id=1&api_key=Your_Database_Api_Key

Car Models

Retrieve vehicle models filtered by make.

Get All Models for a Make

Endpoint (Acura example):
https://databases.one/api_v2/?format=json&select=model&make_id=1&api_key=Your_Database_Api_Key
Response Example:
{
  "errors": 0,
  "result": [
    {
      "model_id": "1",
      "Model": "CSX"
    },
    {
      "model_id": "2",
      "Model": "ILX"
    },
    ...
  ]
}

Get Specific Model

Direct model access by ID:
https://databases.one/api_v2/?format=json&select=model&model_id=1&api_key=Your_Database_Api_Key

Car Trims & Details

Get detailed vehicle specifications including trims, generations, and complete vehicle data.

Get All Trims

Endpoint:
https://databases.one/api_v2/?format=json&select=trim&make_id=1&api_key=Your_Database_Api_Key

Get Generations

Endpoint:
https://databases.one/api_v2/?format=json&select=generation&make_id=1&api_key=Your_Database_Api_Key

Get Full Vehicle Details

Endpoint (requires trim_id):
https://databases.one/api_v2/?format=json&select=detail&trim_id=1&api_key=Your_Database_Api_Key

Complete Vehicle Data Example

{
  "errors": 0,
  "result": [
    {
      "id": "1",
      "Make": "Acura",
      "Model": "CSX",
      "Year": "2005-2011",
      "Body_Type": "Sedan",
      "Generation": "CSX",
      "Trim": "2.0 MT (155 Hp)",
      "Engine_Volume": "1998",
      "Engine_Power": "155",
      "Engine_Type": "Petrol",
      "Drive": "FWD",
      "Gearbox": "Manual",
      "Doors": "4",
      "Seats": "5",
      "Segment": "Premium",
      "Start_Year_Production": "2005",
      "End_Year_Production": "2011",
      "image": "",
      "date_update": "2024-05-23",
      "is_active": "1"
    }
  ]
}

Vehicle Specifications

Access various vehicle specifications and filter options.

Body Types

https://databases.one/api_v2/?select=body&api_key=Your_Database_Api_Key

Sedan, SUV, Coupe, Hatchback, Convertible, etc.

Drive Types

https://databases.one/api_v2/?select=drive&api_key=Your_Database_Api_Key

FWD, RWD, AWD, 4WD

Gearbox Types

https://databases.one/api_v2/?select=gearbox&api_key=Your_Database_Api_Key

Manual, Automatic, CVT, DSG

Engine Types

https://databases.one/api_v2/?select=engine_type&api_key=Your_Database_Api_Key

Petrol, Diesel, Electric, Hybrid

Vehicle Segments

https://databases.one/api_v2/?select=segment&api_key=Your_Database_Api_Key

Premium, Economy, SUV, Sports, Luxury

Production Years

https://databases.one/api_v2/?select=year&api_key=Your_Database_Api_Key

Filter by production years

Utility Functions & Examples

Get Last Update Date

https://databases.one/api_v2/?select=date_update&api_key=Your_Database_Api_Key

Check when database was last updated

Count All Records

https://databases.one/api_v2/?select=count_rows&api_key=Your_Database_Api_Key

Total vehicle records in database

Count Makes

https://databases.one/api_v2/?select=count_makes&api_key=Your_Database_Api_Key

Number of manufacturers

Count Models

https://databases.one/api_v2/?select=count_models&api_key=Your_Database_Api_Key

Number of vehicle models

Get All Data (Filtered)

https://databases.one/api_v2/?select=all&start_date=2024-01-01&api_key=Your_Database_Api_Key

Get all records updated since date

Date Range Filter

https://databases.one/api_v2/?select=all&start_date=2024-01-01&end_date=2024-06-01&api_key=Your_Database_Api_Key

Get records within date range

API Parameters Reference

Parameter Type Required Description Default
api_key String Yes Your unique API key -
format String No Output format: json, xml, csv, txt, xls json
select String No Data type: make, model, generation, trim, body, drive, gearbox, engine_type, segment, year, detail, all, date_update, count_* make
make_id Integer/String No Single ID or comma-separated IDs 0 (all)
model_id Integer No Model identifier 0
generation_id Integer No Generation identifier 0
trim_id Integer No Trim identifier (required for detail) 0
is_active Integer No Filter active records: 0=all, 1=active 0
start_date Date No Filter from date (YYYY-MM-DD) 0
end_date Date No Filter to date (YYYY-MM-DD) 0

API Error Codes

⚠️ Important: The API returns HTTP 200 status for all responses, with errors indicated in the response body.

System Error Codes

111Invalid Api Key
222Expired Api Key
333Invalid Language Variable (deprecated in v2)
444Invalid Select Variable
555No Access
666Missing Variables
777Invalid Date Variable
888Database Query Error
999Configuration Error

Error Response Example

{
  "errors": 1,
  "error": [
    {
      "code": "111",
      "message": "Invalid Api Key"
    }
  ]
}

Migration Guide: v1 to v2

✅ Benefits of Upgrading to v2.0

  • Improved performance and response times
  • Better data structure with more vehicle details
  • Enhanced caching system
  • Simplified API without language parameters
  • New vehicle segments and specifications

📋 Migration Steps

  1. Update Endpoints: Change /api/ to /api_v2/
  2. Remove Language Parameter: v2 doesn't support lang parameter
  3. Update ID References: Make/Model IDs may have changed in v2
  4. Test Thoroughly: Test all API calls with your v2 API key
  5. Update Documentation: Update your integration documentation

v1.0 (Old)

https://databases.one/api/?format=json&select=make&lang=en&api_key=KEY

Features:

  • Table: auto_databases_one
  • Russian language support
  • Old ID structure

v2.0 (New) RECOMMENDED

https://databases.one/api_v2/?format=json&select=make&api_key=KEY

Features:

  • Table: cars_databases_one
  • No language parameter
  • New ID structure
  • Better performance

Get Started with API v2.0

Ready to upgrade to v2.0 or need help with migration?

Contact Support View v1.0 Docs

Need an API Key?

Contact us at support@databases.one for pricing and API key generation.

By using our API, you agree to our Terms of Service and Privacy Policy.

© 2024 Databases.one - Car Database API v2.0

All vehicle data is regularly updated and maintained for accuracy.

Terms | Privacy | Support