Erhalten Sie einen Test-API-Schlüssel

Der Test-API-Schlüssel wird an Ihre E-Mail gesendet

How to Get Started

1

Fill the Form

Geben Sie Ihren Projektnamen, E-Mail und Website-URL ein, wo Sie unsere API verwenden möchten. Wenn Sie noch keine Website haben - lassen Sie es leer.

2

Get Your API Key

Ihr Demo-API-Schlüssel wird an Ihre E-Mail gesendet.

3

Make First Request

Verwenden Sie das Codebeispiel, um unsere AI-optimierten Endpoints zu testen: /trims/{id}/full für vollständige Fahrzeugdaten oder /search/vehicles für nat ürlichsprachige Suche.

4

Build Your App

Integrieren Sie Fahrzeugdaten in Ihre Anwendung oder Website unter Verwendung unserer Dokumentation und SDK.

5

Probieren Sie die AI-gestützte Suche

Testen Sie unsere natürlichsprachige Suche: beschreiben Sie ein Fahrzeug in einfachem Text und erhalten Sie relevante Ergebnisse mit Schlüsselspezifikationen — perfekt für Chatbots und KI-Assistenten.

Quick Start Code Example

Kopieren Sie diesen Code und ersetzen Sie YOUR_API_KEY durch Ihren Testschlüssel. Beispiele zeigen aggregierte Endpoints (/full) und intelligente Suche — optimiert für AI/LLM-Anwendungen.

const API_KEY = 'YOUR_API_KEY';

// One request replaces 6 separate API calls!
// Get full trim data: breadcrumbs + specs + equipments
const response = await fetch(
  'https://v3.api.car2db.com/trims/263119/full',
  {
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Referer': 'https://yourwebsite.com'
    }
  }
);

const data = await response.json();
const trim = data.trim || data; // Handle both /full and regular response

// All data in one response:
console.log(trim.name);                    // → "2.5 AT"
console.log(trim.breadcrumbs?.make?.name);  // → "Toyota"
console.log(trim.breadcrumbs?.model?.name); // → "Camry"

// Key specs optimized for LLMs:
console.log(trim.keySpecifications?.engineVolume);  // → 2496
console.log(trim.keySpecifications?.power);         // → 200
console.log(trim.keySpecifications?.transmission);  // → "Automatic"

// All specifications grouped by category:
trim.specifications?.forEach(group => {
  console.log(group.category.name);  // → "Engine", "Transmission", etc
  group.items.forEach(spec => {
    console.log(`${spec.name}: ${spec.value}`);
  });
});
import requests

API_KEY = 'YOUR_API_KEY'

# Natural language search - find vehicles by description
headers = {
    'Authorization': f'Bearer {API_KEY}',
    'Referer': 'https://yourwebsite.com'
}

response = requests.get(
    'https://v3.api.car2db.com/search/vehicles',
    headers=headers,
    params={'q': 'Toyota Camry 2.5 automatic'}
)

if response.status_code == 200:
    results = response.json()
    
    # Results grouped by models with relevance score
    for model in results.get('results', []):
        print(f"{model['model']['name']} ({model['matchingTrimsCount']} trims)")
        
        for trim in model.get('matchingTrims', []):
            print(f"  {trim['name']} ({trim['yearBegin']}-{trim['yearEnd']})")
            print(f"  Relevance: {trim['relevanceScore']}")
            
            # Key specs included in search results:
            specs = trim.get('keySpecifications', {})
            print(f"  Engine: {specs.get('engineVolume')}L {specs.get('power')}hp")
            print(f"  Transmission: {specs.get('transmission')}")
else:
    print(f"Error: {response.status_code}")
<?php
$apiKey = 'YOUR_API_KEY';

// Get trim with full context: breadcrumbs + key specs
// Replace 263119 with a real trim ID
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://v3.api.car2db.com/trims/263119/full');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer {$apiKey}",
    "Referer: https://yourwebsite.com"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$data = json_decode($response, true);
$trim = $data['trim'] ?? $data; // Handle both formats

if (isset($trim['breadcrumbs'])) {
    // Breadcrumbs provide full navigation context:
    $breadcrumbs = $trim['breadcrumbs'];
    echo "{$breadcrumbs['make']['name']} ";        // → "Toyota"
    echo "{$breadcrumbs['model']['name']} ";       // → "Camry"
    echo "{$breadcrumbs['generation']['name']} ";  // → "XV70"
    echo "{$trim['name']}\n";                      // → "2.5 AT"
    
    // Key specifications optimized for AI/LLM:
    $specs = $trim['keySpecifications'] ?? [];
    echo "Engine: {$specs['engineVolume']} cm\n";    // → "2496 cm"
    echo "Power: {$specs['power']}hp\n";           // → "200hp"
    echo "Drive: {$specs['drive']}\n";             // → "Front"
}
API_KEY="YOUR_API_KEY"

# Get equipment with ALL options grouped by category
curl -X GET "https://v3.api.car2db.com/equipments/54321/full" \
     -H "Authorization: Bearer $API_KEY" \
     -H "Referer: https://yourwebsite.com"

# Response includes complete equipment data in one request:
{
  "equipment": {
    "id": 54321,
    "name": "Prestige",
    "breadcrumbs": {
      "make": { "id": 10, "name": "Toyota" },
      "model": { "id": 120, "name": "Camry" }
    }
  },
  "options": {
    "Safety": [
      { "name": "Airbags", "value": "8" },
      { "name": "ABS", "value": "Standard" }
    ],
    "Comfort": [
      { "name": "Climate Control", "value": "Dual-zone" },
      { "name": "Heated Seats", "value": "Front & Rear" }
    ],
    "Multimedia": [
      { "name": "Display", "value": "10.1 inch touchscreen" }
    ]
  }
}
# Zero-code AI Integration
# Connect Claude Desktop, Cursor, VS Code to Car2DB API

## Claude Desktop Configuration
# File: claude_desktop_config.json
{
  "mcpServers": {
    "car2db": {
      "command": "npx",
      "args": ["-y", "@car2db/mcp-server"],
      "env": {
        "CAR2DB_API_KEY": "your_api_key_here",
        "CAR2DB_LANGUAGE": "en-US"
      }
    }
  }
}

## GitHub Copilot / VS Code Configuration
# File: .vscode/mcp.json
{
  "mcpServers": {
    "car2db": {
      "command": "npx",
      "args": ["-y", "@car2db/mcp-server"],
      "env": {
        "CAR2DB_API_KEY": "your_api_key_here",
        "CAR2DB_LANGUAGE": "en-US"
      }
    }
  }
}

# Now ask AI: "Find specifications for Toyota Camry 2.5"
# AI will automatically use Car2DB API via MCP Server!

40+ einsatzbereite Beispiele verfügbar auf GitHub

GitHub-Beispiele ansehen

Unterschiede zwischen Demo- und Voll-API

Feature Demo-API Voll-API
Daten 2 manufacturers 109K+ Fahrzeuge
Aggregierte Endpoints (/full)
Intelligente Suche (/search/vehicles)
Breadcrumbs & Key Specs
Data Updates Static snapshot Monthly updates
Uptime SLA Kein SLA 99.9%
Use Case Testing & evaluation Production apps
Price FREE Kostenpflichtig

Frequently Asked Questions

What data is included in the demo API?

The demo API includes complete specifications for 2 manufacturers (e.g., Audi and BMW) with all available models, generations, series, and trims. You get access to 80 technical specifications per vehicle, just like the full API.

How long is the demo API key valid?

Your demo API key is valid for 1 year.

Can I use the demo API in production?

No, demo API keys are intended for testing and evaluation only. The limited data (2 manufacturers) and rate limits make them unsuitable for production use. Upgrade to a full API plan for production deployment.

How do I upgrade to the full API?

Simply visit our pricing page and choose the API Subscription plan. Your demo API key will be upgraded to a full production key immediately after payment.

Is my demo API key the same format as production keys?

Ja, der Demo-Schlüssel verwendet den gleichen Authentifizierungsmechanismus und die gleichen API-Endpunkte wie kostenpflichtige Schlüssel, was ein einfaches Upgrade ohne Code-Änderungen ermöglicht.

Can I request additional manufacturers for testing?

Demo keys are limited to the 2 pre-selected manufacturers. Other vehicle models can be seen on the interactive demo.

Kann ich die neuen aggregierten Endpoints mit dem Demo-Schlüssel testen?

Die Demo-API enthält alle neuen Funktionen: /trims/{id}/full und /equipments/{id}/full aggregierte Endpoints, Breadcrumbs und keySpecifications. Sie können die vollständige AI-optimierte Antwortstruktur testen.

Kann ich die Fahrzeugsuche mit dem Demo-Schlüssel testen?

Ja, der /search/vehicles-Endpunkt ist mit der Demo-API verfügbar. Probieren Sie natürlichsprachige Abfragen wie "Audi A4 2.0" oder "BMW X5 Diesel", um die KI-gestützte Suchfunktion zu testen.

Car2DB Support