Endpoints

Six routes, the whole catalog.

REST sobre HTTPS con respuestas { data, meta }, errores problem+json (RFC 9457) y paginación por cursor. Base: https://catalog.keybeapi.com/v1

GET/v1/brands

Todas las marcas, con paginación por cursor.

GET/v1/brands/{slug}

Una marca: país, fundación, premios y eslogan.

GET/v1/vehicles

Vehicles con filtros brand, bodyType, powertrain, year, minPrice, maxPrice y sort.

GET/v1/vehicles/{slug}

Ficha completa del vehículo: precio, versiones y especificaciones.

GET/v1/vehicles/{slug}/media

Fotos y videos oficiales (scope media:read, plan Growth o superior).

GET/v1/health

Estado del servicio, sin autenticación.

GET /v1/vehicles/bmw-ix
{
  "data": {
    "slug": "bmw-ix", "brandSlug": "bmw", "brandName": "BMW",
    "name": "iX", "modelYear": 2027, "bodyType": "suv", "powertrain": "bev",
    "startingPrice": { "amount": 1799900, "currency": "MXN" }
  }
}

Safety y eventos

Autenticación

API key por header X-API-Key, con rotación cada 90 días.
OAuth2 client credentials con scopes catalog:read y media:read.
TLS 1.2+, CORS y rate limiting por plan.

Encolamiento de eventos

CloudEvents 1.0 sobre SNS/SQS FIFO (plan Enterprise).
vehicle.created, vehicle.updated, price.changed, brand.updated.
Deduplicación, reintentos con backoff y DLQ.

Plans

Connect starting free.

DeveloperFree1,000 requests/month

Catalog completo (catalog:read)
API key en minutos
Sin tarjeta

Request an API key

Growth$99 USD/mes100,000 requests/month

Todo lo de Developer
Fotos y videos (media:read)
SLA 99.5%

Get Growth

EnterpriseCustomVolumen por contrato

Webhooks y eventos (CloudEvents)
SLA 99.9% + soporte dedicado
Onboarding con el equipo

Talk to the team

Reference pricing; the BIKY team builds tailored contracts.

View technical docs (Swagger)