---
title: "Run Queries with the Triton Metrics API"
slug: "triton-metrics-api"
updated: 2026-09-30T11:43:08Z
published: 2026-09-30T11:43:08Z
canonical: "help.tritondigital.com/triton-metrics-api"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.tritondigital.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Run Queries with the Triton Metrics API

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

> [!NOTE]
> Also see:
> 
> - [Saving and Scheduling Queries](/user/docs/saving-and-scheduling-queries)
> - [Triton Metrics API](https://metrics.api.tritondigital.com/docs)

## 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](/user/docs/contact-support).
- A query ID from a saved Triton Explore query.

## Migrate to Triton Metrics API V2

> [!WARNING]
> 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/](https://metrics-api.tritondigital.com/docs/.)

The v2 API: [https://metrics.api.tritondigital.com/docs](https://metrics.api.tritondigital.com/docs)

Triton Metrics API v2 has these changes:

- Authentication: With JWT token only, requested from the [Triton Login API](https://login.tritondigital.com/docs).
- 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.

![](https://cdn.document360.io/7124b381-0a94-401a-abbd-9df9c4ea5dff/Images/Documentation/Metrics-API-Get-Query-ID.png?sv=2026-02-06&spr=https&st=2026-10-16T12%3A49%3A18Z&se=2026-10-16T13%3A49%3A18Z&sr=c&sp=r&sig=ILox4lL8Ir8p6jVqwYcboLf8v6oxuLQgXVds%2Fk92JfE%3D)

1. Log in to [Triton Explore](https://metrics.tritondigital.com/#/tap/explore) or [Triton Metrics](https://metrics.tritondigital.com/#/podcast/explore) with your Triton user account.
2. Set up and save a query. See [Saving and Scheduling Queries](/user/docs/saving-and-scheduling-queries).
3. Go to **Saved Queries** in the 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](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, `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 |

### 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**](/user/docs/triton-user-roles-matrix#api-user-role) 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](/user/docs/creating-managing-users#specify-content-access) and [Webcast Metrics permissions](/user/docs/creating-managing-users#specify-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](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32)). If desired, you can use the token’s `exp` claim 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](/user/docs/exporting-triton-metrics-reports).
- Monthly request limit: Each API license allows for up to 1000 API calls/events per month.