Skip to main content

Glossary

Client ID​

An opaque identifier your app generates per end user. Sent on all requests as clientId. The clientId should be consistent for a single user across multiple devices and and multiple sessions.

Token / Secret​

Static credentials used to obtain a short‑lived bearer token via /authenticate. You can obtain your credentials in the Clips Studio.

Bearer Token​

Short‑lived credential returned by /authenticate and sent in the Authorization: Bearer <token> header for all other API calls.

Collection​

A curated grouping of clips returned by /collections and /collection.

Track​

A full‑length audio file (e.g., MP4 320k). Retrieved by /track-fetch for preview or clipping.

Clip​

A 30- to 60‑second section of a track, which may be a curated clip or a custom clip.

Curated Clip​

A curated segment of a track, selected by Feed's expert curators and provided by default where the API provides the track as track.curatedClip.

Custom Clip​

A user‑defined clip created via /clip.

Explicitness​

Metadata that that indicates whether or not a song contains profane lyrics, or if profanity has been edited out of a song.

Rating​

Feed.fm's MPAA-style rating system that classifies age-appropriate content based on words and lyrical themes (ie. sex, drugs, and/or violence).

Format​

Audio encoding and bitrate. The API formats these as a single string value comprised of {encoding}:{bitrate}, e.g., aac:128, mp3:128, mp4:320.

Play Method​

When reporting a play via the /play endpoint, you will provide a method that describes how the content is used:

  • Stream - it is being streamed directly from our system
  • Offline - it was previously streamed, and is now being reported retroactively. A timestamp muist be included.
  • Sync - it was added to other media, like a video, and that content was played.

ISRC​

International Standard Recording Code identifying a specific recording (track.isrc in the API).

Failure Code​

A machine‑readable error code indicating why a request or item failed. See Reference → Error handling.

Error Data​

Optional structured context returned with an error to aid debugging (errorData).