Obtenga una clave API de prueba

La clave API de prueba se enviará a su correo electrónico

How to Get Started

1

Fill the Form

Ingrese el nombre de su proyecto, correo electrónico y URL del sitio web donde planea usar nuestra API. Si aún no tiene un sitio web, déjelo en blanco.

2

Get Your API Key

Su clave API de demostración será enviada a su correo electrónico.

3

Make First Request

Utilice el ejemplo de código para probar nuestros endpoints optimizados para IA: /trims/{id}/full para datos completos del vehículo o /search/vehicles para búsqueda en lenguaje natural.

4

Build Your App

Integre datos de vehículos en su aplicación o sitio web utilizando nuestra documentación y SDK.

5

Pruebe la Búsqueda con IA

Pruebe nuestra búsqueda en lenguaje natural: describa un vehículo en texto simple y obtenga resultados relevantes con especificaciones clave — perfecto para chatbots y asistentes de IA.

Quick Start Code Example

Copie este código y reemplace YOUR_API_KEY con su clave de prueba. Los ejemplos muestran endpoints agregados (/full) y búsqueda inteligente — optimizados para aplicaciones 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+ ejemplos listos para usar disponibles en GitHub

Ver Ejemplos de GitHub

Diferencias entre API de demostración y API completa

Feature API de demostración API completa
Datos 2 manufacturers 109K+ vehículos
Endpoints agregados (/full)
Búsqueda inteligente (/search/vehicles)
Breadcrumbs y Key Specs
Data Updates Static snapshot Monthly updates
Uptime SLA Sin SLA 99.9%
Use Case Testing & evaluation Production apps
Price FREE De pago

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?

Sí, la clave de demostración utiliza el mismo mecanismo de autenticación y los mismos puntos finales de API que las claves de pago, lo que facilita la actualización sin cambiar su código.

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.

¿Puedo probar los nuevos endpoints agregados con la clave de demostración?

La API de demostración incluye todas las nuevas funciones: endpoints agregados /trims/{id}/full y /equipments/{id}/full, breadcrumbs y keySpecifications. Puede probar la estructura de respuesta completa optimizada para IA.

¿Puedo probar la búsqueda de vehículos con la clave de demostración?

Sí, el endpoint /search/vehicles está disponible con la API de demostración. Pruebe consultas en lenguaje natural como "Audi A4 2.0" o "BMW X5 diesel" para probar la funcionalidad de búsqueda con IA.

Car2DB Support