InicioGuíasReferencia de la API
API de AnalyticsEndpoints

Estadísticas usadas por el panel de Turbo

Devuelve un elemento por velocidad de Turbo del reproductor, con views, plays, engagement, retención en el pitch, clics y conversiones. Las fechas se leen en UTC. Si el reproductor no existe en la empresa, la respuesta es `400` con `{"error": ["Player could not be found for the current request"]}`.

POST
/turbo/stats_by_player

Authorization

apiToken apiVersion userAgent
X-Api-Token<token>

Accede a la aplicación y copia tu token de API; luego, solo tienes que definir el encabezado X-Api-Token con él.

In: header

X-Api-Version<token>

La versión de la API que se usará. Las versiones compatibles actualmente son:

  • v1: La versión estable actual

Una solicitud sin este encabezado, o con cualquier otro valor, la responde el edge con 404 y {"error_msg":"404 Route Not Found"}.

In: header

User-Agent<token>

Se requiere un User-Agent no vacío que identifique tu integración. Las solicitudes sin él se rechazan en el edge antes de llegar a la API.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/turbo/stats_by_player" \  -H "Content-Type: application/json" \  -d '{    "start_date": "2026-09-01 00:00:00",    "end_date": "2026-09-30 23:59:59",    "player_id": "64a5c8072e6fd10009828db2",    "video_duration": 1200,    "pitch_time": 300  }'
[  {    "speed": 1,    "views": 150,    "plays": 60,    "engagement": 0.38,    "pitch": 0.21,    "clicks": 9,    "conversions": 2,    "amount_brl": 39400,    "amount_usd": 0,    "amount_eur": 0,    "conversion_rate": 3.51  },  {    "speed": 1.2,    "views": 148,    "plays": 57,    "engagement": 0.41,    "pitch": 0.24,    "clicks": 11,    "conversions": 3,    "amount_brl": 59100,    "amount_usd": 0,    "amount_eur": 0,    "conversion_rate": 5.56  }]

Cuenta los parámetros de consulta registrados para un reproductor POST

Devuelve cuántas veces se registró cada parámetro de consulta de la URL de la página para el reproductor, como `utm_source`, `utm_campaign`, `src` o `sck`. Se cuenta cualquier parámetro de consulta, no solo los UTM.

Listar todos los reproductores GET

Devuelve los reproductores de la empresa de la API key, con la duración de su vídeo y su tiempo de pitch. Los reproductores eliminados no se listan.