Skip to content

using-7digital-api.md

Latest commit

 

History

History
160 lines (138 loc) · 7.51 KB

using-7digital-api.md

File metadata and controls

160 lines (138 loc) · 7.51 KB

Using 7digital API

Overview

Universal Music Group have made a some of their songs available for the Abbey Road Red 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 contains a link to our online documentation for each endpoint, and a sample working call for each endpoint. You can use this to help understand how our calls are constructed and what the responses look like

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 next page &trackId={int}