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 " >This section outlines the essential aspects of authenticating your requests to access our API services securely. Authentication is a crucial step in ensuring that only authorized users and applications can interact with our APIs, protecting sensitive data and maintaining the integrity of our services.</p><h2 class="slate-h2 " ><span style="color:#666666">Types of Authentication</span></h2><p class="slate-p " >We offer different authentication methods to suit diverse use cases and requirements. The most common authentication mechanisms supported by our APIs are:</p><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">API Key Authentication</strong>: This method involves including a unique API key with each request under a specific Http header. The API key acts as a simple yet effective way to identify and authorize applications or users.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Basic HTTP Authentication: </strong>Basic HTTP Authentication is a widely-used, simple, and stateless authentication method. It involves including the username and password in the request&apos;s &quot;Authorization&quot; header encoded in Base64 format. It is essential to use this method only over secure connections (HTTPS) to prevent credentials from being transmitted in plaintext.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">HMAC Authentication: </strong>HMAC (Hash-based Message Authentication Code) is a more advanced authentication method that ensures both integrity and authenticity of API requests. It involves generating a cryptographic hash using secret keys and the request data, which is then sent along with the request. The server verifies the hash to authenticate the request and detect any tampering.</div></li></ol><h2 class="slate-h2 " ><span style="color:#666666">
Getting Started with Authentication</span></h2><p class="slate-p " >To start using the API and benefit from its functionality, clients will need to obtain the necessary authentication credentials from Tuned Global. The process typically involves registering for an API key, obtaining the required username and password for Basic HTTP Authentication, or to be able to generate the HMAC credentials, depending on the authentication method you choose.</p><p class="slate-p " >In the following sub sections, we&apos;ll provide step-by-step guides and code examples for each authentication type to help you seamlessly integrate authentication into your applications.</p>

This section outlines the essential aspects of authenticating your requests to access our API services securely. Authentication is a crucial step in ensuring that only authorized users and applications can interact with our APIs, protecting sensitive data and maintaining the integrity of our services.

We offer different authentication methods to suit diverse use cases and requirements. The most common authentication mechanisms supported by our APIs are:

To start using the API and benefit from its functionality, clients will need to obtain the necessary authentication credentials from Tuned Global. The process typically involves registering for an API key, obtaining the required username and password for Basic HTTP Authentication, or to be able to generate the HMAC credentials, depending on the authentication method you choose.

In the following sub sections, we'll provide step-by-step guides and code examples for each authentication type to help you seamlessly integrate authentication into your applications.

<p class="slate-p " >This method involves including a unique API key with each request under a special http header called “StoreId”. Tuned Global will provide the API key once your details are registered in our system. 
Since this model only requires an API Key in the header, it does not deliver sensitive information and is used to request catalogue metadata i.e. search, images etc.</p><p class="slate-p " ></p><h2 class="slate-h2 " ><span style="color:#666666">Examples</span></h2><p class="slate-p " >Following are the usage examples from the curl and postman. </p><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">Plain text</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-shell keep-markup drop-tokens"><div class="slate-code_line">curl -X GET --header &quot;Accept: application/json&quot; --header &quot;StoreId: TESTAPIKEY&quot; &quot;https://api-delivery-connect.tunedglobal.com/api/v5/search/master/songs?filter.name=hello</div></code></pre></div><div style="text-align:left"><img src="https://theneo-prod-public.s3.amazonaws.com/images-1690173109461.png" style="
              width:1179px;
	            height:269px;
	            aspect-ratio:1179 / 269"
         /></div><p class="slate-p " ></p>

This method involves including a unique API key with each request under a special http header called “StoreId”. Tuned Global will provide the API key once your details are registered in our system. 
Since this model only requires an API Key in the header, it does not deliver sensitive information and is used to request catalogue metadata i.e. search, images etc.

Following are the usage examples from the curl and postman. 

curl -X GET --header "Accept: application/json" --header "StoreId: TESTAPIKEY" "https://api-delivery-connect.tunedglobal.com/api/v5/search/master/songs?filter.name=hello

Sections

API Key Authentication

Examples

What made this section helpful for you?

What made this section unhelpful for you?

Status Codes

What made this section helpful for you?

What made this section unhelpful for you?

Sections

API Key Authentication

Examples

What made this section helpful for you?

What made this section unhelpful for you?

Status Codes

What made this section helpful for you?

What made this section unhelpful for you?

Ask an AI

Code with AI