---
title: "Consumer API"
slug: "consumer-api"
updated: 2026-03-09T15:28:45Z
published: 2026-03-09T15:28:45Z
---

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

# Consumer API

You can integrate published content and metadata from Omny Studio in your web and mobile players with Omny Studio’s consumer API:

[https://api.omny.fm/docs/consumer-api/](https://api.omny.fm/docs/consumer-api/)

This API let third-parties integrate metadata about published content in custom players and content directories on a website or in a mobile app.

Only publicly-published content will be available in the consumer API. Hidden programs, private clips or private playlists are not accessible.

The Consumer API is a read-only API. To create, edit or delete content, see [Management API](/user/docs/management-api).

## Analytics

If you'd like to track the number of plays/downloads from your custom players, you can define and track custom sources. See [Track Downloads from Custom Sources](/user/docs/tracking-downloads-from-custom-sources)

If you'd like to track consumption data for plays on custom players, you can send player events to the consumption analytics API. See [Consumption Analytics API for Third-party Players](/user/docs/consumption-analytics-api-for-third-party-players-beta).

## Caching

Responses are cached up to 10 minutes. Updates to clip metadata may not be reflected until the cache is refreshed.

## CORS

CORS (Cross-Origin Resource Sharing) requests are allowed from any domain.

For optimal API performance, we recommend making [simple requests](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#Simple_requests). These do not specify any custom HTTP headers, which avoids triggering a CORS preflight request.

## Rate Limits

There are no practical rate limits to this API. However, our web application firewall, [Cloudflare](https://www.cloudflare.com/), may block traffic it deems to be malicious or harmful.

## Disable Preloading

Disable preloading and auto-playing in your player to ensure that only user-initiated playback triggers downloads. This ensures that download analytics are accurate and that your player conforms to IAB guidelines. For details, see [IAB Tech Lab Podcast Technical Measurement Guidelines](https://iabtechlab.com/wp-content/uploads/2024/02/PodcastMeasurement_v2.2_final.pdf).

To disable preloading, you must explicitly use the `preload="none"` attribute in [video](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/video) and [audio](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/audio) HTML elements and the [HTMLMediaElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement) HTML DOM API. Most browsers use a default of `preload="metadata"`.