Uzyskaj testowy klucz API
How to Get Started
Fill the Form
Wprowadź nazwę projektu, e-mail i adres URL witryny, w której planujesz użyć naszego API. Jeśli nie masz jeszcze strony - pozostaw puste.
Get Your API Key
Twój demonstracyjny klucz API zostanie wysłany na Twój email.
Make First Request
Użyj przykładu kodu, aby przetestować nasze endpointy zoptymalizowane dla AI: /trims/{id}/full dla pełnych danych pojazdu lub /search/vehicles dla wyszukiwania w języku naturalnym.
Build Your App
Zintegruj dane pojazdów ze swoją aplikacją lub stroną internetową, korzystając z naszej dokumentacji i SDK.
Wypróbuj Wyszukiwanie AI
Przetestuj nasze wyszukiwanie w języku naturalnym: opisz pojazd prostym tekstem i uzyskaj istotne wyniki z kluczowymi specyfikacjami — idealne dla chatbotów i asystentów AI.
Quick Start Code Example
Skopiuj ten kod i zastąp YOUR_API_KEY swoim kluczem testowym. Przykłady pokazują zagregowane endpointy (/full) i inteligentne wyszukiwanie — zoptymalizowane dla aplikacji 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+ gotowych przykładów dostępnych na GitHub
Zobacz Przykłady GitHubRóżnice między demo API a pełnym API
| Feature | Demo API | Pełne API |
|---|---|---|
| Dane | 2 manufacturers | 109K+ pojazdów |
| Zagregowane endpointy (/full) | ||
| Inteligentne wyszukiwanie (/search/vehicles) | ||
| Breadcrumbs i Key Specs | ||
| Data Updates | Static snapshot | Monthly updates |
| Uptime SLA | Bez SLA | 99.9% |
| Use Case | Testing & evaluation | Production apps |
| Price | FREE | Płatne |
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?
Tak, klucz demonstracyjny używa tego samego mechanizmu uwierzytelniania i tych samych punktów końcowych API co klucze płatne, co ułatwia aktualizację bez zmiany kodu.
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.
Czy mogę przetestować nowe zagregowane endpointy z kluczem demo?
API demo zawiera wszystkie nowe funkcje: zagregowane endpointy /trims/{id}/full i /equipments/{id}/full, breadcrumbs i keySpecifications. Możesz przetestować pełną strukturę odpowiedzi zoptymalizowaną dla AI.
Czy mogę przetestować wyszukiwanie pojazdów z kluczem demo?
Tak, endpoint /search/vehicles jest dostępny z API demo. Spróbuj zapytań w języku naturalnym, takich jak "Audi A4 2.0" lub "BMW X5 diesel", aby przetestować funkcję wyszukiwania z AI.
