Obtenez une clé API de test
How to Get Started
Fill the Form
Entrez le nom de votre projet, votre e-mail et l'URL du site Web où vous prévoyez d'utiliser notre API. Si vous n'avez pas encore de site Web - laissez-le vide.
Get Your API Key
Votre clé API de démonstration sera envoyée à votre e-mail.
Make First Request
Utilisez l'exemple de code pour essayer nos endpoints optimisés pour l'IA: /trims/{id}/full pour des données complètes du véhicule ou /search/vehicles pour une recherche en langage naturel.
Build Your App
Intégrez les données des véhicules dans votre application ou site Web en utilisant notre documentation et SDK.
Essayez la Recherche avec IA
Testez notre recherche en langage naturel: décrivez un véhicule en texte simple et obtenez des résultats pertinents avec des spécifications clés — parfait pour les chatbots et assistants IA.
Quick Start Code Example
Copiez ce code et remplacez YOUR_API_KEY par votre clé de test. Les exemples montrent les endpoints agrégés (/full) et la recherche intelligente — optimisé pour les applications AI/LLM.
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+ exemples prêts à l'emploi disponibles sur GitHub
Voir les Exemples GitHubDifférences entre l'API de démonstration et l'API complète
| Feature | API de démonstration | API complète |
|---|---|---|
| Données | 2 manufacturers | 109K+ véhicules |
| Endpoints agrégés (/full) | ||
| Recherche intelligente (/search/vehicles) | ||
| Breadcrumbs et Key Specs | ||
| Data Updates | Static snapshot | Monthly updates |
| Uptime SLA | Sans SLA | 99.9% |
| Use Case | Testing & evaluation | Production apps |
| Price | FREE | Payant |
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?
Oui, la clé de démonstration utilise le même mécanisme d'authentification et les mêmes points de terminaison d'API que les clés payantes, ce qui facilite la mise à niveau sans changer votre code.
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.
Puis-je tester les nouveaux endpoints agrégés avec la clé de démonstration?
L'API de démonstration inclut toutes les nouvelles fonctionnalités: endpoints agrégés /trims/{id}/full et /equipments/{id}/full, breadcrumbs et keySpecifications. Vous pouvez tester la structure de réponse complète optimisée pour l'IA.
Puis-je tester la recherche de véhicules avec la clé de démonstration?
Oui, l'endpoint /search/vehicles est disponible avec l'API de démonstration. Essayez des requêtes en langage naturel comme "Audi A4 2.0" ou "BMW X5 diesel" pour tester la fonctionnalité de recherche avec IA.
