Documentation Index

Fetch the complete documentation index at: https://support.iono.fm/llms.txt

Use this file to discover all available pages before exploring further.

API access

  • Updated on Jul 28, 2026
  • Published on Jul 28, 2026
  • 2 minute(s) read
Prev Next

The audio analytics data available via our dashboard can also be queried directly against an API to enable integration with automated tooling.

Availability & usage limits

API access is not available to all packages and each package allows only a certain amount of analytics data to be queried per month. For example, a package might allow 10gb of query data per month.

Query data usage is calculated by the size of data that needs to scanned and evaluated on the database to produce a result, not the size of the output data. For example, a query for the top 10 podcast episodes in a week might need to scan 80mb of data to determine the results which is only 10 items of output.

Only direct queries against the API that are authenticated via the token counts towards query usage. Queries made in our reporting dashboard or preview panels in the publisher dashboard do not count towards monthly usage.

Query results may be cached for up to an hour, meaning the same query within an hour will not return updated results. Queries served from the cache do not count towards the usage limit.

API information

The "Account" page of the dashboard shows information and functions around the analytics API:

Image

  • The a API token to use for automated requests,
  • How much API query data has been used in the current month,
  • How much is still available,
  • Functionality to create a new API token.

A new token can be generated any time the publisher suspects unauthorized access is taking place or the token has been shared with unauthorized persons. In this case existing tools need to be updated to the new token. Please allow up to 20 minutes for the new token to become active.

Using the API token

The API token provided on the dashboard should be provided as an HTTP Bearer Token by any direct API requests. For example:

curl -H "Authorization: Bearer ce6b50c998d68eec0987be99404" https://api.iono.fm/v1/reporting/server/podcast/totals/metrics?range=last_7_days&provider_id=1&result_type=full'

Providing the incorrect token will result in HTTP 403 "Forbidden" responses.

API documentation

We have a complete set of API documentation here.

This documents all the endpoints, parameters and responses that our API supports in addition to an overview of the measurement rules and metrics that is implemented on our analytics.

This can be quite a complex starting point for inexperienced users, if you are struggling to access your analytics data via our API please contact our support email for further assistance.