Your business intelligence dashboards can retrieve Triton Metrics analytics data with the Triton Metrics API. This API lets you run saved queries from these Triton Metrics applications:
Webcast Metrics
Podcast Metrics
Podcast Video
Demos+
Lineup Explore
Royalty Reports
TAP Explore (license required)
TAP Affidavits
Requirements
To use the Triton Metrics API, you need the following:
Triton Metrics API credentials. Access to the Triton Metrics API is part of a paid service. For more information, please contact Triton Digital.
A query ID from a saved Triton Explore query.
Migrate to Triton Metrics API V2
Please switch to v2 of the Triton Metrics API. Triton Metrics API v1 is no longer supported and will be deprecated on January 26, 2026.
The deprecated v1 API: https://metrics-api.tritondigital.com/docs/
The v2 API: https://metrics.api.tritondigital.com/docs
Triton Metrics API v2 has these changes:
Authentication: With JWT token only, requested from the Triton Login API.
A simpler, single endpoint: The multiple endpoints for requesting reports in v1 have been combined into a single endpoint.
Get a Query ID
You can save queries in Triton Metrics applications. Each saved query has its own query ID, which you can use to with the Triton Metrics API.
Log in to Triton Explore or Triton Metrics with your Triton user account.
Set up and save a query. See Saving and Scheduling Queries.
Go to Saved Queries in the application where you saved your query.
From the query’s options menu, select Copy ID.
Select Copy to copy the ID to your clipboard.
Select OK.
Paste the query ID into your business application’s API request.
Use the API
For detailed information, consult the Triton Metrics API documentation: https://metrics.api.tritondigital.com/docs.
Saved queries include a start and end date, either as specific dates or as presets, such as the last 7 days. You can override those dates in your API requests.
Parameter | Description | Required |
|---|---|---|
id | The query ID for a saved query. | Yes |
start | The start date for the queried data. The default is the start date in the saved query. | No |
end | The date after the last full day for which you want data. For example, The default is the end date used in the saved query. | No |
Authentication
You can use your regular Triton user account to create and save queries. You do not need to use an API User account to create or save queries themselves.
You can use an API User account to run any of the queries saved by regular users. However, a regular user may only use the query IDs for queries that they themselves have saved.
To make sure that the reports are complete, make sure that the API User account has the same access to content and Webcast Metrics permissions as the user who saved the query. Otherwise, the reports run by the API User account might only return a partial report.
To improve security the Triton Metrics API requires an API key to authorize requests:
API keys have a limited lifespan.
When a key expires, API requests fail with an appropriate error code, 401 Unauthorized.
To avoid using an expired API key, request a new key for each new query as part of the session flow.
The API key is a JWT (JSON web token). If desired, you can use the token’s
expclaim to determine when to request a new API key.
Limits
Some of these limits are also in your license agreement with Triton Digital. The license agreement takes precedence.
API throttling: If more than 10 requests are made in one minute, the API returns a 429 error ("too many requests") and you will have to wait one minute before making another request.
Dimensions and row limits: See Export Triton Metrics Reports.
Monthly request limit: Each API license allows for up to 1000 API calls/events per month.