Run Queries with the Triton Metrics API

Prev Next

Your company's business intelligence dashboards can retrieve Triton Metrics analytics data with the Triton Metrics API. This API lets you run the queries that you’ve saved in these Triton Explore 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 Triton Explore query that you’ve created and saved with your Triton Metrics API credentials.

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.

  1. Log in to a Triton Metrics application with your Triton Metrics API credentials.

  2. Set up and save a query. See Saving and Scheduling Queries.

  3. Go to Saved Queries in the Triton Metrics application where you saved your query.

  4. From the query’s options menu, select Copy ID.

  5. Select Copy to copy the ID to your clipboard.

  6. Select OK.

  7. 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.

When creating and saving queries to use with the API, be sure to log in with your Triton Metrics API credentials. The Triton Metrics API can only access queries that were saved by the same user who created the queries.

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, end=2021-04-01 returns data up to the end of 2021-03-31.

The default is the end date used in the saved query.

No

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 Triton Metrics user interface and export tools.

  • Monthly request limit: Each API license allows for up to 1000 API calls/events per month.