UMG Catalog / 7digital API
This guide describes how to use the 7digital API endpoints to access the UMG catalog made available for this hackathon
Overview
Universal Music Group have made a some of their songs available for this 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 = 7d4vr6cgb392Identified 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 = 7d4vr6cgb392consumer_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
letter={text}
Artist search
Search the catalog for artists that match a supplied text string
q={text}
Artist releases
Returns a list of streamable releases for a specific artist
&artistId={int}
&usageTypes=adsupportedstreaming
Artist toptracks
Returns a list of streamable tracks for a specific artist
&artistId={int}
&usageTypes=adsupportedstreaming
Release search
Search the catalog for releases
that match a supplied text string
&q={text}
&usageTypes=adsupportedstreaming
Release tracks
Returns a list of streamable tracks for a specific release
&releaseId={int}
&usageTypes=adsupportedstreaming
Track search
Search the catalog for releases that match a supplied text string
&q={text}
&usageTypes=adsupportedstreaming
Track stream
Stream full length (or partial clip) audio for a specific track
See later page
&trackId={int}
Last updated