Developer API documentation

KPI and Summary Endpoints

These endpoints provide summary information about entities. Currently the only exposed entity is artist, forthcoming will include entities in other domain areas.

General URI format

http://api.semetric.com/[entity_type]/[id]/[endpoint]?[arguments]

Where:

  • id is an entity id from any defined identification scheme (see ID Schemas);
  • endpoint can be set to nothing, or the kpi function as described below;
  • arguments must include token=[api_key].

Artist KPIs and Summaries

/artist/[id]/

Summary data is given for all the data sources that are valid for the artist, including 2 weeks of cumulative and diff data for each data source.

/artist/[id]/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

http://api.semetric.com/artist/8091b18ba3254023aadd197c79cdd209/?token=[api_key]
{
   "response":{
      "entities":[
         {
            "name":"Plays SoundCloud",
            "summary":{
               "week":{
                  "attribute":"plays",
                  "start_time":1387756800,
                  "processing":"processed",
                  "variant":"diff",
                  "period":604800,
                  "start_offset":124682,
                  "end_time":1395619200,
                  "country":"ALL",
                  "data":[
                     128467,
                     131325,
                     133611,
                     135436,
                     137175,
                     139493,
                     143034,
                     147801,
                     152716,
                     160691,
                     165491,
                     169350,
                     174646,
                     76148
                  ],
                  "class":"dense"
                },
                ...
            }
         ],
         "class": "list"
      },
   "success": true
}