Retrieve UTM analytics aggregated by date for the organization. The endpoint supports five UTM dimensions, each available at its own path. Returns daily totals of views, plays, unique views and unique plays for the given date range.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
GET /{utm_dimension}
{utm_dimension}Retrieve UTM analytics aggregated by date for the organization. The endpoint supports five UTM dimensions, each available at its own path. Returns daily totals of views, plays, unique views and unique plays for the given date range.
Different hostThis endpoint uses
data.pandavideo.cominstead of the standardapi-v2.pandavideo.com. Make sure to use the correct host when calling it.
AuthorizationRequires a valid Panda API key in the
Authorizationheader. The metrics returned correspond to the organization that owns the API key.
HTTP Method & Path
GET /{utm_dimension}
Base URL: https://data.pandavideo.com
Replace {utm_dimension} with one of the supported paths described in Path Parameters below.
Authentication Requirements
- Security Scheme:
PandaAuth(apiKey) - Header:
Authorization: <your_api_token>(no Bearer prefix)
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Authorization | header | string | Yes | Panda API token (without Bearer prefix) |
Path Parameters
Use one of the supported {utm_dimension} values below — each maps to its own UTM metric.
| Path | Dimension |
|---|---|
/utmSource | UTM source |
/utmMedium | UTM medium |
/utmCampaign | UTM campaign |
/utmTerm | UTM term |
/utmContent | UTM content |
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
start_date | string | Yes | Start date of the range. Format: YYYY-MM-DD |
end_date | string | Yes | End date of the range. Format: YYYY-MM-DD |
Request Body
No request body is required.
Response
Success Response (200)
Returns an object keyed by date (YYYY-MM-DD). Each value is the daily metrics object for that date. Days with no activity are omitted from the response.
{
"2026-04-27": { "view": 1, "play": 0, "unique_view": 1, "unique_play": 0 },
"2026-05-01": { "view": 1, "play": 1, "unique_view": 1, "unique_play": 1 },
"2026-04-30": { "view": 1, "play": 1, "unique_view": 1, "unique_play": 1 },
"2026-05-09": { "view": 1, "play": 0, "unique_view": 1, "unique_play": 0 },
"2026-05-05": { "view": 17, "play": 12, "unique_view": 6, "unique_play": 5 },
"2026-05-13": { "view": 5, "play": 1, "unique_view": 5, "unique_play": 1 },
"2026-05-19": { "view": 29, "play": 18, "unique_view": 13, "unique_play": 12 },
"2026-05-20": { "view": 1, "play": 1, "unique_view": 1, "unique_play": 1 },
"2026-05-22": { "view": 1, "play": 1, "unique_view": 1, "unique_play": 1 },
"2026-05-23": { "view": 36, "play": 26, "unique_view": 25, "unique_play": 17 },
"2026-05-16": { "view": 1, "play": 0, "unique_view": 1, "unique_play": 0 }
}Response Schema
The response is an object whose keys are dates (YYYY-MM-DD) and whose values are daily metrics objects with the following fields:
| Field | Type | Description |
|---|---|---|
view | integer | Total views on that day |
play | integer | Total plays on that day |
unique_view | integer | Unique viewers on that day |
unique_play | integer | Unique plays on that day |
Days with no activity are omitted from the response.
Error Responses
- 401 Unauthorized: API token inválido ou ausente
- 403 Forbidden: Token sem permissão para acessar este recurso
- 422 Unprocessable Entity: Parâmetros de data inválidos (formato ou intervalo)
- 500 Internal Server Error: Erro no servidor
Example Usage
cURL
curl -X GET \
'https://data.pandavideo.com/utmSource?start_date=2026-04-25&end_date=2026-05-25' \
-H 'Authorization: your_api_token_here'