Developer API documentation

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}