BDS Public API v1

La API pública de Blue Digital Score (v2.1.1) permite a desarrolladores y agencias acceder a los datos de evaluación tecnológica de manera programática. Todas las respuestas son en formato JSON.

Endpoints Disponibles

GET /api/v1/rankings

Obtiene el Top 100 global de agencias ordenadas por BDS.

Respuesta Exitosa (200 OK)

{
  "status": "success",
  "count": 100,
  "data": [
    {
      "rank": 1,
      "company_id": "...",
      "company_name": "Agencia...",
      "slug": "agencia-...",
      "global_score": 95.5,
      "algorithm_version": "2.1.1",
      "completed_at": "2026-08-01T00:00:00Z"
    }
  ]
}

GET /api/v1/agencies/{slug}

Obtiene el perfil completo de una agencia, incluyendo sus dimensiones e indicadores.

Parámetros

slug (string): El identificador único de la agencia (ej: ogilvy-colombia).

GET /api/v1/compare/{agencyA}-vs-{agencyB}

Compara directamente dos agencias devolviendo sus dimensiones estructuradas y el ganador según el Global Score.

GET /api/v1/rankings/history

Obtiene snapshots históricos del ranking global según fechas pasadas disponibles.

Parámetros (Query)

date (string, Opcional): Fecha en formato YYYY-MM-DD.

Rate Limiting & Políticas

La API pública está diseñada para integraciones ligeras (ej. widgets y consultas esporádicas). Existe un límite estricto de 100 requests por minuto por IP. Cualquier abuso resultará en un status HTTP 429 Too Many Requests.

Manejo de Errores

En caso de error (agencia no encontrada, etc.), la API devolverá un JSON estandarizado:

{
  "status": "error",
  "message": "Agencia no encontrada",
  "code": 404
}