Using 7digital API

Overview

Capitol Music Group have made a some of their songs available for the Milwaukee hackathon

• ≈ 20,000 songs

• ≈ 1,500 unique artists

• ≈ 5,000 albums/singles

• Covers many genres, rock, pop, country....etc

• Spans each decade from 1960's to present

7digital have activated some of their API endpoints to get access to the UMG catalog

• Browse catalog and discover artists, albums and tracks

• Get data for artists, albums and tracks - artist name, album title, track name

• Retrieve album artwork (CD covers) for every album in the catalog

• Stream full length audio files for every song in the catalog

API Architecture

Catalog Schema

​List of catalog metadata can be found on this page​

Accessing UMG Catalog using 7digital API

Access to UMG catalog using 7digital services (API)

• Provided through a REST style interface

• Controlled by a consumer key that needs to passed in as a parameter

• consumer_key = 7d4vr6cgb392

• Identified by a shop identifier that needs to be passed in as a parameter

• shopId = 2020

Streaming audio files requires API requests to be signed with an oauth 1.0 signature

• Sign requests using consumer key and secret

• consumer_key = 7d4vr6cgb392

• consumer_secret = m4ntskavq56rddsa

Sample API Call

​http://api.7digital.com/1.2/artist/search?shopId=2020&oauth_consumer_key=7d4vr6cgb392&q=john​

Call Components	Meaning
http://api.7digital.com/1.2	7digital API site and version
artist/search	API endpoint name - search artists
?shopId=2020	Parameter to identify UMG catalog
&oauth_consumer_key=7d4vr6cgb392	Parameter for consumer key
&q=john	Parameter for search query string

API Endpoint List

The following table lists the endpoints that we have made available for this hackathon. For each endpoint there is a sample call that works and returns real results. Click on these links to see how each call is constructed and obtain the call responses

Endpoint	Use	Sample Call	Main Parameter
​Artist browse​	Browse the catalog for artist names that start with supplied text string	​GET artist/browse​	letter={text}
​Artist search​	Search the catalog for artists that match a supplied text string	​GET artist/search​	q={text}
​Artist releases​	Returns a list of streamable releases for a specific artist	​GET artist/releases​	&artistId={int} &usageTypes=adsupportedstreaming
​Artist toptracks​	Returns a list of streamable tracks for a specific artist	​GET artist/toptracks​	&artistId={int} &usageTypes=adsupportedstreaming
​Release search​	Search the catalog for releases that match a supplied text string	​GET release/search​	&q={text} &usageTypes=adsupportedstreaming
​Release tracks​	Returns a list of streamable tracks for a specific release	​GET release/tracks​	&releaseId={int} &usageTypes=adsupportedstreaming
​Track search​	Search the catalog for releases that match a supplied text string	​GET track/search​	&q={text} &usageTypes=adsupportedstreaming
​Track stream​	Stream full length (or partial clip) audio for a specific track	See later page	&trackId={int}