Requests

GET /api/analytics/requests

GET /api/analytics/requests/:videoId

Daily CDN HTTP request counts for video delivery. These counts come from delivery logs, not from the player. For player-reported views, watch time, and completions, use Plays.

Omit :videoId for the whole workspace. Add the video id to the path for one video.

Requires analytics.read. See Overview for authentication and category scope. API keys cannot pass category or tag filters on this endpoint.

Parameters

Parameter	Required	Description
`startDate`	Yes	Start of the range. ISO 8601 or `YYYY-MM-DD`. Inclusive.
`endDate`	Yes	End of the range. ISO 8601 or `YYYY-MM-DD`. Inclusive.
`:videoId`	No	Video id in the path. Omit for workspace totals.

Ignite treats startDate as the start of that calendar day and endDate as the end of that calendar day. If at least one day in the range has data, days without data are filled with views: 0.

Workspace-wide calls still return full-workspace totals when the API key is limited to specific categories. A per-video call only succeeds when that video is inside the key’s category scope.

Request

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

Response


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

dateString is the calendar day (YYYY-MM-DD). Use it as the day key. views is the number of CDN requests that day. A range with no data returns []. An unknown or out-of-scope video returns 403.

Errors

Status	Body	Meaning
`400`	Plain text	Missing or invalid `startDate` / `endDate`, or an invalid `videoId`
`403`	—	Missing `analytics.read`, a disabled key, or an out-of-scope VOD id
`403`	`{ "error": "filters_not_supported_for_api_tokens" }`	Category or tag filters on an API key request