Skip to content

The most comprehensive automotive database for JavaScript/TypeScript. Includes 100+ car brands, 2000+ models with generations (1968-present), and 1200+ auto parts. Perfect for dealerships, e-commerce, and automotive apps.

License

Notifications You must be signed in to change notification settings

lifeofcapo/car-api

Repository files navigation

🚗 Car Brands, Models & Parts Database

npm version npm downloads GitHub stars GitHub last commit License

📚 Documentation · NPM

Save hundreds of euros on commercial APIs!

The most comprehensive automotive database for JavaScript/TypeScript. Includes 100+ car brands, 2000+ models with generations (1968-present), and 1200+ auto parts. Perfect for dealerships, e-commerce, and automotive apps.

✨ Features

  • 🚙 100+ Car Brands - Audi, BMW, Toyota, Ford, Tesla, and more
  • 📅 Generations with years - Exact production years (1968-present)
  • 🔧 1200+ Auto Parts - Comprehensive parts catalog
  • 📦 Lightweight & Tree-shakeable - Use only what you need
  • 🌐 Works everywhere - Node.js, browsers, React, Vue, Angular
  • 📘 TypeScript ready - Full type definitions included

📦 Installation

npm install auto-parts-db
# or
yarn add auto-parts-db
# or
pnpm add auto-parts-db

🚀 Quick Start

import { getBrands, getModelsByBrand, searchParts } from 'auto-parts-db';

// Get all car brands
const brands = getBrands();
console.log(brands); // ['Audi', 'BMW', 'Toyota', ...]

// Get models for a specific brand
const audiModels = getModelsByBrand('Audi');
console.log(audiModels[0]); 
// { name: 'A4', generations: [{ name: 'B5', yearFrom: 1994, yearTo: 2001 }, ...] }

// Search for auto parts
const brakeParts = searchParts('тормоз');
console.log(brakeParts); // All brake-related parts

Auto parts store integration

import { searchParts } from 'auto-parts-db';

// User searches for "absorber"
const parts = searchParts('absorber');
// Returns all parts containing 'absorber' in name or slug

💡 Use Cases

  • Car Catalogs: Building filters by brand, model, and year
  • Auto Parts E-commerce: Creating compatible parts finder systems
  • Automotive Portals: Enriching content with structured data
  • Mobile Applications: For taxi services, car sharing, maintenance
  • Analytics & Research: Automotive market analysis

🤝 Contributing

Contributions are welcome! Feel free to:

  • Add missing car brands or models
  • Extend parts catalog
  • Improve data accuracy

About

The most comprehensive automotive database for JavaScript/TypeScript. Includes 100+ car brands, 2000+ models with generations (1968-present), and 1200+ auto parts. Perfect for dealerships, e-commerce, and automotive apps.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published