API calls to retrieve an artist's followers, song plays and video views across leading sources such as Twitter, Facebook, LastFM and Vevo
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 |
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:
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.
You can search for Adele's Facebook metrics.
You can search for Adele's Vevo metrics.
You can search for Adele's LastFm metrics.
You can search for Adele's Twitter metrics.