MusicGraph API Documentation

Artist Metrics API

API calls to retrieve an artist's followers, song plays and video views across leading sources such as Twitter, Facebook, LastFM and Vevo

The base URL path for artist metrics queries is: http://api.musicgraph.com/api/v2/artist/{id}/metrics

Metrics Endpoints

Resource URL Description
/{id}/metrics Return a list of all the available metrics sources for an artist
/{id}/metrics/facebook Return Facebook metrics data
/{id}/metrics/lastfm Return LastFM metrics data
/{id}/metrics/twitter Return Twitter metrics data
/{id}/metrics/vevo Return Vevo metrics data

Artist Name and ID Lookup

The API provides auto-complete suggestions — or, “predictions” – for artist names. Auto-complete minimizes the number of false positives for artist searches. You can search a list of suggested artists using a prefix this will return a list of potential artist matches based upon a query string.

Parameter Required Description Example
api_key yes The developer API key api_key=c8303e90962e3a5ebd5a1f260a69b138
prefix yes Contains &prefix=gree
genre no Use to filter the suggest results. Values here &genre=rock
decade no Use to filter the suggest results. Values here &decade=2000s
limit no By default, the API will return 20 results. Use the limit query string parameter to return a custom number of results (max 100). &limit=20
offset no Use the offset query parameter to perform pagination on the results set. &offset=10

Examples:

Artist Metrics Search

You can perform artist metrics search operations using parameters and filters detailed below.

Parameter Required Description Example
api_key yes The developer API key api_key=c8303e90962e3a5ebd5a1f260a69b138
limit no By default, the API will return 20 results. Use the limit query string parameter to return a custom number of results (max 100). &limit=40
offset no Use the offset query parameter to perform pagination on the results set. &offset=10
artist_id yes The ID of the artist; obtained using the Artist Suggest Search &artist_id=ee2564c7-a6b5-11e0-b446-00251188dd67

Examples:

You can search for Adele's social metrics.

http://api.musicgraph.com/api/v2/artist/ee2564c7-a6b5-11e0-b446-00251188dd67/metrics?api_key=c8303e90962e3a5ebd5a1f260a69b138

You can search for Adele's Facebook metrics.

http://api.musicgraph.com/api/v2/artist/ee2564c7-a6b5-11e0-b446-00251188dd67/metrics/facebook?api_key=c8303e90962e3a5ebd5a1f260a69b138

You can search for Adele's Vevo metrics.

http://api.musicgraph.com/api/v2/artist/ee2564c7-a6b5-11e0-b446-00251188dd67/metrics/vevo?api_key=c8303e90962e3a5ebd5a1f260a69b138

You can search for Adele's LastFm metrics.

http://api.musicgraph.com/api/v2/artist/ee2564c7-a6b5-11e0-b446-00251188dd67/metrics/lastfm?api_key=c8303e90962e3a5ebd5a1f260a69b138

You can search for Adele's Twitter metrics.

http://api.musicgraph.com/api/v2/artist/ee2564c7-a6b5-11e0-b446-00251188dd67/metrics/twitter?api_key=c8303e90962e3a5ebd5a1f260a69b138

Try it out!