Tuned Global

Getting Started

This API provides READ access to public information content.

API Reference

Authentication

API Key Authentication

Basic HTTP Authentication

HMAC Authentication

Search

Album Search

Song Search

Catalogue

Retrieve Tracks for an Album

Retrieve Song detail

Upload Allowed Songs

Get Assets

Retrieve the image URL for album/track

Retrieve stream URL for a track

Retrieve preview URL for a track

Log Plays

Log a play for the specified track

Log plays in batches

CDS Metadata Feed

JSON Specification

JSON Example

Tools

API Explorer

TunedGlobal.API.Delivery Version 4

Catalogue Delivery Service

Production

Image Engine

<p class="slate-p " >Welcome to the Log Play API section of our comprehensive API documentation. This section outlines the functionalities that allow you to efficiently log user plays to be able to generate the Label reports as well as music usage and user activity reports. 
<strong class="slate-bold">Note:</strong> This section is only applicable if Tuned Global is responsible for managing the internal and external (label) reports.</p><p class="slate-p " ></p><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=info ><div class="callout-icon"><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p " >For reporting purposes, it is necessary to log the 30 second point of play.  However we would suggest that best practice is to log Start of Play, 30 seconds, the Skip action (and the seconds at which this action occurs) and End of File.  This leads to better insights into the behaviour of your users and your application.</p></div></div><h3 class="slate-h3 " ><span style="color:#666666">Getting Started</span></h3><p class="slate-p " >To start logging plays and unlocking valuable analytics and insights into user behaviour and content performance, refer to the technical documentation below. Explore the play logging endpoints, understand the data format, and get started with implementing the Log Play APIs in your applications.</p><p class="slate-p " ></p><h3 class="slate-h3 " ><span style="color:#666666">Security Model</span></h3><p class="slate-p " >All Log Play APIs use the Basic HTTP Auth security model. Please refer to the  <a href="https://app.theneo.io/tuned-global/Content-Delivery/authentication/basic-http-authentication" target="_self">Basic HTTP Auth </a> section of this documentation for more details.</p><p class="slate-p " ></p><p class="slate-p " ></p>

Welcome to the Log Play API section of our comprehensive API documentation. This section outlines the functionalities that allow you to efficiently log user plays to be able to generate the Label reports as well as music usage and user activity reports. 


 This section is only applicable if Tuned Global is responsible for managing the internal and external (label) reports.

To start logging plays and unlocking valuable analytics and insights into user behaviour and content performance, refer to the technical documentation below. Explore the play logging endpoints, understand the data format, and get started with implementing the Log Play APIs in your applications.

All Log Play APIs use the Basic HTTP Auth security model. Please refer to the  

 section of this documentation for more details.

<p class="slate-p " ></p><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=info ><div class="callout-icon"><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p " >This API is used for reporting plays for licensing reporting.  Consult with Tuned Global to ensure you are logging the correct actions for your Rights Holder Agreements.
This API is for logging multiple plays (a batch of plays).</p></div></div><p class="slate-p " ></p>

This API is used for reporting plays for licensing reporting.  Consult with Tuned Global to ensure you are logging the correct actions for your Rights Holder Agreements.
This API is for logging multiple plays (a batch of plays).

UTC datetime stamp when this action occurred

When

UserId

TrackId

Country

Type of log play. Acceptable values are Start, Progress, Skip, End

LogPlayType

Duration of the play. Acceptable values are 0, 5, 10, 30 or total song duration in seconds

Seconds

Source of the log play. Acceptable values are Queue, Station,Playlist,Album, Artist, Podcast,Log, ExtRadio, Continuous, System

Source

Type of play. Acceptable values are Stream, Offline, Cache, Download, Preview

PlayType

ID of the Source. This would be the AlbumId, ArtistId, PlaylistId, StationId depending of the Value used in

SourceId

UserIp

DeviceId

Latitude

Longitude

ID of the subscription / plan the user is on.

SubId

Guid for log play. If you are sending multiple 'PlayTypes' for the same play i.e. start, progress, skip or end, please use the same GUID for all these events.

Sections

Log plays in batches

Header Parameters

Body Parameters

Response

Response Attributes

What made this section helpful for you?

What made this section unhelpful for you?

Language Box

Response

What made this section helpful for you?

What made this section unhelpful for you?

Sections

Log plays in batches

Header Parameters

Body ParametersExpand all

Response

Response Attributes

What made this section helpful for you?

What made this section unhelpful for you?

Language Box

Response

What made this section helpful for you?

What made this section unhelpful for you?

Ask an AI

Code with AI

Body Parameters