VehiclesVE.api es la primera API REST de catálogo vehicular curada para Latinoamérica. Marcas, modelos, años, motores — y los aliases locales que tus usuarios realmente escriben: Machito, Burbuja, Sportero.
Stack de producción — sin sorpresas
# Una llamada. Datos reales. Nombres locales.
$ curl "https://vehiclesveapi.red111.dev/api/v1/vehicles\
?market=VE&make=toyota" \
-H "X-Api-Key: $VEAPI_KEY"
→ 200 OK · 142ms · application/json
{
"status": "success",
"data": [{
"id": 12,
"year_from": 1990, "year_to": null,
"fuel_type": "gasoline",
"model": { "name": "Land Cruiser 70" },
"popularity_score": 92,
"vehicle_aliases": [{ "alias_name": "Machito", "market": "VE" }]
}],
"meta": { "pagination": { "page": 1, "total": 25 } }
}01 · El problema
NHTSA, CarAPI, Autodata: todas pensadas para EE.UU. o Europa. Sin aliases locales. Sin el parque automotor real que circula en Caracas, Maracaibo o Valencia.
> GET /vehicles/search?q=machito
{
"results": [],
"count": 0
}> GET /api/v1/vehicles/search?q=machito
{
"status": "success",
"data": [{
"model": { "name": "Land Cruiser 70" },
"vehicle_aliases": [{ "alias_name": "Machito" }]
}]
}02 · Características
200+ vehículos que efectivamente circulan en Venezuela — pasajeros y comerciales — no listados teóricos importados de EE.UU.
"Machito", "Burbuja", "Sportero". Tu endpoint /search reconoce lo que tus usuarios escriben, incluyendo nombres coloquiales y variantes regionales.
Campos consistentes desde v1. Breaking changes solo en major. Campos snake_case, nulls explícitos, enums documentados.
Filtra por mercado, combustible, transmisión, tracción, HP, cilindrada, categoría y tipo de carrocería. Incluyendo vehículos comerciales con payload y GVWR.
Respuesta envuelta en status/data/meta. Paginación estándar por página. Errores con código, mensaje y request_id.
Headers X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Plan en cada respuesta. Sin cortes silenciosos.
03 · Documentación
El payload exacto que recibirá tu backend. Cambia de endpoint y observa la estructura completa.
X-Api-Keypage y per_page (máx 100)code, message y request_id/api/v1/vehicles?market=VE&make=toyota
04 · API Reference
?market=VE para ver solo las activas en ese mercado.name, slug, body_type y vehicle_category.market incluye popularity_score y vehicle_aliases. Paginado con page / per_page.vehicle_aliases.alias_name, models.name y makes.name. Máx 100 caracteres.full: incluye todos los aliases y disponibilidad por mercado. Cacheado 24h.message explica cuál.05 · Casos de uso
Selectores "marca → modelo → año → motor" que resuelven al vehículo correcto desde una búsqueda por alias.
Normaliza títulos publicados por usuarios: del listing caótico al catálogo limpio con ID canónico.
Fichas técnicas al instante: motor, cilindrada, transmisión y tracción por modelo y año.
Cotizaciones basadas en categoría real del vehículo (passenger, commercial) y especificaciones verificadas.
06 · Planes
Sin overage. Upgrade en cualquier momento. Cuota reiniciada el 1ro de cada mes.
Para explorar y prototipar. Trial único de 30 días.
Para MVPs y apps en producción.
Para equipos con tráfico alto y contratos anuales.
500 requests de prueba. Sin tarjeta. Trial de 30 días. Solo tu API key y el endpoint.
# 1. Exporta tu API key
$ export VEAPI_KEY="ve_live_…"
# 2. Primera llamada — vehículos activos en Venezuela
$ curl "https://vehiclesveapi.red111.dev/api/v1/vehicles?market=VE" \
-H "X-Api-Key: $VEAPI_KEY"
# 3. Busca por alias local
$ curl "https://vehiclesveapi.red111.dev/api/v1/vehicles/search?q=machito&market=VE" \
-H "X-Api-Key: $VEAPI_KEY"