API Publica de tuBurra

Accede a datos publicos de vehiculos en venta en Venezuela. Todos los endpoints son de solo lectura (GET) y no requieren autenticacion. No se exponen datos de usuarios.

Rate Limiting

Maximo 100 solicitudes por minuto por IP. Los headers X-RateLimit-Limit y X-RateLimit-Remaining indican tu estado actual.

Base URL

https://tuburra.com

GET/api/v1/vehiculos

Listado paginado de vehiculos activos. Solo lectura.

Parametros (query string)

Parametro	Tipo	Descripcion
`categoria`	string	Filtrar por categoria: vehiculos, motos, camiones, embarcaciones, autobuses, bicicletas, patinetes, aviones
`estado`	string	Filtrar por estado (ej: Zulia, Miranda)
`ciudad`	string	Filtrar por ciudad (busqueda parcial)
`marca`	string	Filtrar por marca exacta (ej: Toyota)
`tipo_vehiculo`	string	Filtrar por tipo/subcategoria (ej: SUV, Sedan)
`precio_min`	number	Precio minimo en USD
`precio_max`	number	Precio maximo en USD
`page`	number	Pagina (default: 1)
`limit`	number	Resultados por pagina (max: 50, default: 20)

Ejemplo

/api/v1/vehiculos?categoria=vehiculos&estado=Zulia&page=1&limit=20

Respuesta

{
  "data": [
    {
      "id": 1,
      "marca": "Toyota",
      "modelo": "Corolla",
      "year": 2020,
      "price": 15000,
      "estado": "Zulia",
      "ciudad": "Maracaibo",
      "categoria": "vehiculos",
      "tipo_vehiculo": "Sedan",
      ...
    }
  ],
  "meta": {
    "total": 45,
    "page": 1,
    "limit": 20,
    "totalPages": 3
  }
}

GET/api/v1/estadisticas

Estadisticas agregadas: conteo por marca, precio promedio por categoria, conteo por tipo.

Parametros (query string)

Parametro	Tipo	Descripcion
`categoria`	string	Filtrar estadisticas por categoria

Ejemplo

/api/v1/estadisticas?categoria=vehiculos

Respuesta

{
  "data": {
    "total": 150,
    "byBrand": [
      { "brand": "Toyota", "count": 45 },
      { "brand": "Chevrolet", "count": 30 }
    ],
    "byCategory": { "vehiculos": 100, "motos": 50 },
    "avgPriceByCategory": { "vehiculos": 12500, "motos": 3500 },
    "byType": { "Sedan": 40, "SUV": 35 }
  }
}

GET/api/v1/marcas

Marcas y modelos disponibles, con conteo de modelos por marca.

Parametros (query string)

Parametro	Tipo	Descripcion
`categoria`	string	Filtrar marcas por categoria

Ejemplo

/api/v1/marcas?categoria=vehiculos

Respuesta

{
  "data": [
    {
      "brand": "Toyota",
      "models": ["Corolla", "Hilux", "RAV4"],
      "count": 3
    }
  ],
  "meta": {
    "totalBrands": 25,
    "totalModels": 120
  }
}

¿Necesitas ayuda con la API? Contactanos en soporte@tuburra.com