Summary calls

These endpoints provide summary information about entities right now. Currently the only exposed entity is artist forthcoming will include track and release.

artist

Calls are of the form:

http://api.semetric.com/artist/[id]/[call]?[option]

Where id is an artist id from any defined identification scheme (see A bit about identification), call is one of the functions defined below, and options are and desired calltime options, seperatated by & and specified as key=value. token=YOURAPIKEY must be given.

kpi

Current aggregate performance and deltas of an artist across many networks. Every data source provided (varies by artist) gives three indicators: current and previous, which are deltas for their respective time periods and total which an absolute figure for now, minus an ingestion delay.

example

The following command:

$curl http://api.semetric.com/artist/fe66302b0aee49cfbd7d248403036def/kpi?token=YOURAPIKEYHERE

will produce this json response:

{"response": {
    "fans": {
        "twitter": {"current": 40279, "total": 10346353, "previous": 40508},
        "myspace": {"current": 786, "total": 1581722, "previous": 942},
        "youtube": {"current": 748, "total": 475084, "previous": 814},
        "facebook": {"current": 143681, "total": 34890295, "previous": 161061},
         "lastfm": {"current": 4860, "total": 2344028, "previous": 3707},
         "total": {"current": 190354, "total": 49637482, "previous": 207032}},
    "plays": {
        "lastfm": {"current": 514975, "total": 113785570, "previous": 284464},
        "total": {"current": 691774, "total": 696114172, "previous": 470631},
        "myspace": {"current": 120579, "total": 438806896, "previous": 117560},
        "youtube": {"current": 56220, "total": 143521706, "previous": 68607},
        "radio": {"current": 0, "total": 0, "previous": 0}},
    "comments": {
        "myspace": {"current": 41, "total": 206684, "previous": 46},
        "total": {"current": 235, "total": 315855, "previous": 258},
        "youtube": {"current": 196, "total": 105132, "previous": 212},
        "ilike": {"current": -2, "total": 4039, "previous": 0}},
    "views": {
        "myspace": {"current": 137068, "total": 75757165, "previous": 109064},
        "total": {"current": 179785, "total": 128022729, "previous": 151781},
        "youtube": {"current": 42717, "total": 52265564, "previous": 42717}}},
"success": true}