MusicGraph API Documentation

Artist Social URLS API

API call to retrieve an artist's social urls across leading sources such as Twitter, Facebook, LastFM and Vevo, YouTube and more.

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

Metrics Endpoints

Resource URL Description
/{id}/social-urls Return a list of all the available social urls for an artist

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 Social URLS 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 URLS.

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

Try it out!