curl "https://platform.streampixel.io/api/v1/analytics/projects/664f1a2b3c4d5e6f7a8b9c0d/analytics/queue?startDate=2026-09-19T00:00:00Z&endDate=2026-09-26T00:00:00Z&granularity=daily" \
-H "x-api-key: $STREAMPIXEL_API_KEY"
const u = new URL('https://platform.streampixel.io/api/v1/analytics/projects/664f1a2b3c4d5e6f7a8b9c0d/analytics/queue');
u.search = new URLSearchParams({ startDate: '2026-09-19T00:00:00Z', endDate: '2026-09-26T00:00:00Z', granularity: 'daily' });
const { data } = await (await fetch(u, { headers: { 'x-api-key': process.env.STREAMPIXEL_API_KEY } })).json();
if (data.summary.p95WaitMs > 60_000) console.warn('viewers waited over a minute at p95; consider more capacity');
import os, requests
r = requests.get(
"https://platform.streampixel.io/api/v1/analytics/projects/664f1a2b3c4d5e6f7a8b9c0d/analytics/queue",
params={"startDate": "2026-09-19T00:00:00Z", "endDate": "2026-09-26T00:00:00Z", "granularity": "daily"},
headers={"x-api-key": os.environ["STREAMPIXEL_API_KEY"]},
)
print(r.json()["data"]["summary"])
{
"success": true,
"data": {
"summary": { "totalQueued": 37, "avgWaitMs": 41200, "medianWaitMs": 28000, "p95WaitMs": 131000, "peakConcurrent": 4, "peakBucket": "2026-09-23" },
"timeseries": [
{ "bucket": "2026-09-22", "queuedCount": 9, "peakConcurrentQueued": 2, "avgWaitMs": 30500, "peakWaitMs": 88000 },
{ "bucket": "2026-09-23", "queuedCount": 21, "peakConcurrentQueued": 4, "avgWaitMs": 52100, "peakWaitMs": 131000 }
]
}
}
Queue Analytics
How often viewers waited for a streaming server and how long.
GET
/
api
/
v1
/
analytics
/
projects
/
{projectId}
/
analytics
/
queue
curl "https://platform.streampixel.io/api/v1/analytics/projects/664f1a2b3c4d5e6f7a8b9c0d/analytics/queue?startDate=2026-09-19T00:00:00Z&endDate=2026-09-26T00:00:00Z&granularity=daily" \
-H "x-api-key: $STREAMPIXEL_API_KEY"
const u = new URL('https://platform.streampixel.io/api/v1/analytics/projects/664f1a2b3c4d5e6f7a8b9c0d/analytics/queue');
u.search = new URLSearchParams({ startDate: '2026-09-19T00:00:00Z', endDate: '2026-09-26T00:00:00Z', granularity: 'daily' });
const { data } = await (await fetch(u, { headers: { 'x-api-key': process.env.STREAMPIXEL_API_KEY } })).json();
if (data.summary.p95WaitMs > 60_000) console.warn('viewers waited over a minute at p95; consider more capacity');
import os, requests
r = requests.get(
"https://platform.streampixel.io/api/v1/analytics/projects/664f1a2b3c4d5e6f7a8b9c0d/analytics/queue",
params={"startDate": "2026-09-19T00:00:00Z", "endDate": "2026-09-26T00:00:00Z", "granularity": "daily"},
headers={"x-api-key": os.environ["STREAMPIXEL_API_KEY"]},
)
print(r.json()["data"]["summary"])
{
"success": true,
"data": {
"summary": { "totalQueued": 37, "avgWaitMs": 41200, "medianWaitMs": 28000, "p95WaitMs": 131000, "peakConcurrent": 4, "peakBucket": "2026-09-23" },
"timeseries": [
{ "bucket": "2026-09-22", "queuedCount": 9, "peakConcurrentQueued": 2, "avgWaitMs": 30500, "peakWaitMs": 88000 },
{ "bucket": "2026-09-23", "queuedCount": 21, "peakConcurrentQueued": 4, "avgWaitMs": 52100, "peakWaitMs": 131000 }
]
}
}
Return queueing statistics for a window: how many viewers queued, average, median and 95th-percentile wait, the peak number waiting at once and when, plus an hourly or daily series. A non-zero queue means demand exceeded the project’s concurrent-user allowance at that time.
Scope:
read. Default window: the last 7 days, in daily buckets.Path parameters
string
required
The project.
Query parameters
string
ISO 8601 start of the window. For API-key callers the window between
startDate and endDate is capped at 92 days; move the window to read a longer period.string
ISO 8601 end of the window.
string
default:"daily"
daily or hourly.Headers
string
required
Your Streampixel API key.
Response
object
totalQueued, avgWaitMs, medianWaitMs, p95WaitMs, peakConcurrent, peakBucket (the bucket label of the peak, null when nobody queued).array
Per bucket:
bucket (YYYY-MM-DD for daily, YYYY-MM-DDTHH:00:00Z for hourly), queuedCount (viewers who waited in that bucket), peakConcurrentQueued (most waiting at the same moment), avgWaitMs, peakWaitMs.curl "https://platform.streampixel.io/api/v1/analytics/projects/664f1a2b3c4d5e6f7a8b9c0d/analytics/queue?startDate=2026-09-19T00:00:00Z&endDate=2026-09-26T00:00:00Z&granularity=daily" \
-H "x-api-key: $STREAMPIXEL_API_KEY"
const u = new URL('https://platform.streampixel.io/api/v1/analytics/projects/664f1a2b3c4d5e6f7a8b9c0d/analytics/queue');
u.search = new URLSearchParams({ startDate: '2026-09-19T00:00:00Z', endDate: '2026-09-26T00:00:00Z', granularity: 'daily' });
const { data } = await (await fetch(u, { headers: { 'x-api-key': process.env.STREAMPIXEL_API_KEY } })).json();
if (data.summary.p95WaitMs > 60_000) console.warn('viewers waited over a minute at p95; consider more capacity');
import os, requests
r = requests.get(
"https://platform.streampixel.io/api/v1/analytics/projects/664f1a2b3c4d5e6f7a8b9c0d/analytics/queue",
params={"startDate": "2026-09-19T00:00:00Z", "endDate": "2026-09-26T00:00:00Z", "granularity": "daily"},
headers={"x-api-key": os.environ["STREAMPIXEL_API_KEY"]},
)
print(r.json()["data"]["summary"])
{
"success": true,
"data": {
"summary": { "totalQueued": 37, "avgWaitMs": 41200, "medianWaitMs": 28000, "p95WaitMs": 131000, "peakConcurrent": 4, "peakBucket": "2026-09-23" },
"timeseries": [
{ "bucket": "2026-09-22", "queuedCount": 9, "peakConcurrentQueued": 2, "avgWaitMs": 30500, "peakWaitMs": 88000 },
{ "bucket": "2026-09-23", "queuedCount": 21, "peakConcurrentQueued": 4, "avgWaitMs": 52100, "peakWaitMs": 131000 }
]
}
}
Errors
| Status | Cause |
|---|---|
403 | The key lacks read, or the project belongs to another account. |
404 | No project with that id. |
400 | granularity not daily or hourly; startDate/endDate not ISO 8601, startDate after endDate, or a window wider than 92 days (API-key callers only). |
429 | More than 300 reads in a minute (API-key callers). Retry-After is set. |