Solicitudes

GET /api/analytics/requests

GET /api/analytics/requests/:videoId

Recuentos diarios de solicitudes HTTP de CDN para la entrega de vídeo. Estos recuentos vienen de los logs de entrega, no del player. Para las vistas, el tiempo de visionado y los completions que informa el player, usa Reproducciones.

Omite :videoId para todo el espacio de trabajo. Añade el id de vídeo a la ruta para un vídeo.

Requiere analytics.read. Consulta Resumen para autenticación y alcance de categorías. Las Claves API no pueden pasar filtros de categorías o Tags en este endpoint.

Parámetros

Parámetro	Obligatorio	Descripción
`startDate`	Sí	Inicio del rango. ISO 8601 o `YYYY-MM-DD`. Inclusivo.
`endDate`	Sí	Fin del rango. ISO 8601 o `YYYY-MM-DD`. Inclusivo.
`:videoId`	No	Id de vídeo en la ruta. Omítelo para los totales del espacio de trabajo.

Ignite trata startDate como el inicio de ese día de calendario y endDate como el final de ese día de calendario. Si al menos un día del rango tiene datos, los días sin datos se rellenan con views: 0.

Las llamadas a nivel de espacio de trabajo siguen devolviendo totales de todo el espacio de trabajo cuando la Clave API está limitada a categorías específicas. Una llamada por vídeo solo se realiza correctamente cuando ese vídeo está dentro del alcance de categorías de la clave.

Solicitud

CURL


curl -X GET "https://app.ignitevideo.cloud/api/analytics/requests?startDate=2026-08-01&endDate=2026-08-31" \
-H "Authorization: Bearer YOUR_API_KEY"
 
curl -X GET "https://app.ignitevideo.cloud/api/analytics/requests/VIDEO_ID?startDate=2026-08-01&endDate=2026-08-31" \
-H "Authorization: Bearer YOUR_API_KEY"

JavaScript / Node.js


const workspace = await fetch(
'https://app.ignitevideo.cloud/api/analytics/requests?startDate=2026-08-01&endDate=2026-08-31',
{ headers: { Authorization: `Bearer YOUR_API_KEY` } }
);
const video = await fetch(
'https://app.ignitevideo.cloud/api/analytics/requests/VIDEO_ID?startDate=2026-08-01&endDate=2026-08-31',
{ headers: { Authorization: `Bearer YOUR_API_KEY` } }
);

PHP


$client = new GuzzleHttp\Client();
$workspace = $client->request('GET', 'https://app.ignitevideo.cloud/api/analytics/requests', [
'query' => ['startDate' => '2026-08-01', 'endDate' => '2026-08-31'],
'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
]);
$video = $client->request('GET', 'https://app.ignitevideo.cloud/api/analytics/requests/VIDEO_ID', [
'query' => ['startDate' => '2026-08-01', 'endDate' => '2026-08-31'],
'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
]);

Respuesta


[
  {
    "date": string,
    "dateString": "2026-08-31",
    "views": number
  },
  [...]
]

dateString es el día de calendario (YYYY-MM-DD). Úsalo como clave del día. views es el número de solicitudes CDN ese día. Un rango sin datos devuelve []. Un vídeo desconocido o fuera de alcance devuelve 403.

Errores

Status	Body	Significado
`400`	Texto plano	Falta `startDate` / `endDate` o no es válido, o `videoId` no válido
`403`	—	Falta `analytics.read`, clave deshabilitada o id VOD fuera de alcance
`403`	`{ "error": "filters_not_supported_for_api_tokens" }`	Filtros de categorías o Tags en una solicitud con Clave API