AudioDN API Documentation

Welcome to the AudioDN API documentation. This API allows you to manage audio collections, tracks, and streaming sessions.

Getting Started

To get started with the AudioDN API:

  1. Obtain your API key from the AudioDN dashboard
  2. Include the API key in the Authorization header of your requests
  3. Start making API calls to manage your audio content

Choose Your Integration Path

Compare the three approaches to find the best fit for your project.

Client-Side
Fastest setup
Server-Side
Maximum control
Hybrid
Best of both
Description Drop-in components with API keys. No backend required.Full API access. Build custom upload and playback interfaces.Backend creates sessions, frontend uses ADN components.
Best For Prototypes, static sites, personal projectsMobile apps, custom platforms, enterpriseSaaS products, paywalled content, multi-tenant apps
Complexity Low High Medium
Security Basic Maximum High
Setup Time 5 minutes1-2 hours30 minutes
View Guide → View Guide → View Guide →

Glossary

Client

An organization or individual that uses Audio Delivery Network (AudioDN) to manage and deliver audio content. Clients access the platform via API or web components.

Creator

A sub-account under a client. Typically represents an individual content contributor, such as an artist or podcaster. Used for tracking usage, access control, and analytics at a granular level.

Collection

A logical container (similar to a folder) used to organize one or more tracks. Collections help manage uploads, playback, and display in players.

Track

An individual audio file uploaded to AudioDN. Tracks can be music, spoken word, podcasts, or any other type of audio content.

Original (Upload)

The exact, unmodified audio file provided by the client or creator at upload time. Stored for reference and future variant generation.

Variant

A processed version of the original track. Variants are generated for specific use cases such as streaming optimization, compression, previews, or waveform generation.

Cover Image / Cover Art

An optional image associated with a track, collection, or client account. Displayed in the player and used for aesthetic theming.

Theme

A palette of colors automatically extracted from a cover image. Used to generate a visual theme for players and other components.

Color

The primary accent color shown on the player and uploader UI. Selected automatically from the theme or set manually via API.

Player (Component)

A customizable, embeddable web component that plays tracks and collections. Designed for easy integration into websites and apps.

Uploader (Component)

A customizable web component that allows users to upload audio files into collections. Includes support for track metadata and cover images.

Base URL

All endpoints are prefixed with /v1/

https://api.audiodeliverynetwork.com/v1/