Delivery / Playback API

API Reference: View the complete Arc XP Audio API specification

The delivery API returns a ready-to-play, time-limited CDN (content delivery network) URL for a published audio clip or podcast episode, along with optional waveform data and metadata. Unlike the editorial API used to create and manage content, the delivery API puts your organization and environment in the delivery hostname instead of using a Bearer-token editorial call. Requests send your Arc XP API token as an x-api-key header.

In most cases you do not call this directly: the Arc Audio Player calls it for you when you give it a media-id, org-id, and env. Reach for it if you build a custom player or need the delivery URL server-side.

Note

The delivery API runs on your organization’s API domain, https://{org}-config-{env}.api.arc-cdn.net (the same hostname pattern other Arc XP delivery APIs use), not under /audiocenter/api/editorial. In the examples that follow, replace YOUR_ORG with your organization ID; the environment (prod or sandbox) also forms part of the hostname. The player constructs these URLs for you from org-id and env.

Get a clip’s media URL

curl -H "x-api-key: YOUR_API_TOKEN" \
  "https://YOUR_ORG-config-prod.api.arc-cdn.net/audio/v1/media/clip/{audio_id}?waveform=true&meta=true"

Query parameters:

• renditionKey: which encoded rendition to return; defaults to aac-standard.
• waveform: set true to include waveform data for envelope display (defaults to false).
• meta: set true to include the clip’s metadata (defaults to false).

The response is a deliverable: a uri (the time-limited CDN URL), plus waveform and metadata when requested.

{
  "uri": "https://.../signed-delivery-url",
  "waveform": { "...": "condensed amplitude data" },
  "metadata": { "title": "My Clip", "description": "…" }
}

Get a podcast episode’s media URL

curl -H "x-api-key: YOUR_API_TOKEN" \
  "https://YOUR_ORG-config-prod.api.arc-cdn.net/audio/v1/media/podcast/{podcast_id}/episode/{episode_guid}"

The episode endpoint accepts the renditionKey parameter (default aac-standard) and returns only the deliverable shape’s uri field. The clip endpoint’s waveform and meta parameters, along with the metadata field, apply to clips only.

Relationship to the Arc Audio Player

The Arc Audio Player performs this lookup internally: given media-id + org-id + env, it builds https://{org-id}-config-{env}.api.arc-cdn.net/audio/v1/media/clip/{media-id}, sends your arc-token as x-api-key, and wires the returned uri (and waveform) into the player. See Customizing the Arc Audio Player to embed it, or use this API directly to feed a custom player. For exhaustive field definitions, see the API specification linked earlier.