Uzyskaj testowy klucz API

Testowy klucz API zostanie wysłany na Twój email

How to Get Started

1

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.

2

Get Your API Key

Twój demonstracyjny klucz API zostanie wysłany na Twój email.

3

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.

4

Build Your App

Zintegruj dane pojazdów ze swoją aplikacją lub stroną internetową, korzystając z naszej dokumentacji i SDK.

5

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 GitHub

Róż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.

Car2DB Support