Anfragen

GET /api/analytics/requests

GET /api/analytics/requests/:videoId

Tägliche CDN-HTTP-Anfragen für die Video-Auslieferung. Diese Zählungen stammen aus Delivery-Logs, nicht vom Player. Für Views, Watch Time und Completions, die der Player berichtet, nutze Wiedergaben.

Lass :videoId weg für den gesamten Workspace. Füge die Video-ID zum Pfad hinzu für ein einzelnes Video.

Erfordert analytics.read. Siehe Übersicht für Authentifizierung und Kategorie-Scope. API-Keys können auf diesem Endpoint keine Kategorie- oder Tag-Filter übergeben.

Parameter

Parameter	Erforderlich	Beschreibung
`startDate`	Ja	Start des Bereichs. ISO 8601 oder `YYYY-MM-DD`. Inklusive.
`endDate`	Ja	Ende des Bereichs. ISO 8601 oder `YYYY-MM-DD`. Inklusive.
`:videoId`	Nein	Video-ID im Pfad. Weglassen für Workspace-Totals.

Ignite behandelt startDate als Beginn dieses Kalendertags und endDate als Ende dieses Kalendertags. Wenn mindestens ein Tag im Bereich Daten hat, werden Tage ohne Daten mit views: 0 gefüllt.

Workspace-weite Aufrufe liefern weiterhin Totals für den gesamten Workspace, wenn der API-Key auf bestimmte Kategorien beschränkt ist. Ein Pro-Video-Aufruf gelingt nur, wenn das Video im Kategorie-Scope des Keys liegt.

Anfrage

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'],
]);

Antwort


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

dateString ist der Kalendertag (YYYY-MM-DD). Nutze ihn als Tagesschlüssel. views ist die Zahl der CDN-Anfragen an diesem Tag. Ein Bereich ohne Daten liefert []. Ein unbekanntes oder außerhalb des Scopes liegendes Video liefert 403.

Fehler

Status	Body	Bedeutung
`400`	Klartext	Fehlendes oder ungültiges `startDate` / `endDate` oder ungültige `videoId`
`403`	—	Fehlendes `analytics.read`, deaktivierter Key oder VOD-ID außerhalb des Scopes
`403`	`{ "error": "filters_not_supported_for_api_tokens" }`	Kategorie- oder Tag-Filter bei einer API-Key-Anfrage