Developer API documentation

Charts Endpoints

These endpoints provide ordered lists of entities, based on either the most recent unit of timeseries data or various kinds of analysis on the timeseries e.g. acceleration.

General URI Format

To request today’s chart use:

http://api.semetric.com/chart/[uuid]?token=[api_key]

Where uuid is a valid chart ID (see list below).

To request a listing of all the historic chart IDs use:

/chart/[uuid]/chart/

Or to request a historic chart for a specific date use either:

/chart/[uuid]?start_time=[utc_epoch_time]

/chart/[uuid]?date=[utc_iso_date_format]

Example

The following command:

http://api.semetric.com/chart/bb789492225c4c4da2e15f617acc9982?token=[api_key]

produced this response:

{
   "response":{
      "name":"Fans added last day",
      "now_id":"bb789492225c4c4da2e15f617acc9982",
      "start_time":1396137600,
      "period":86400,
      "class":"chart",
      "end_time":1396224000,
      "previous_id":"c1a0f8725e385465b1fad8d0bd553bcd",
      "data":[
         {
            "class":"rank",
            "value":164299,
            "rank":1,
            "artist":{
               "class":"artist",
               "id":"1418b8d3a3284125a319764083790b7c",
               "name":"Shakira"
            }
         },
         {
            "class":"rank",
            "value":116299,
            "rank":2,
            "artist":{
               "class":"artist",
               "id":"625cc7cba2bf4a3ab438f5cbf7c72cb3",
               "name":"Selena Gomez"
            }
         },
         {
            "class":"rank",
            "value":115554,
            "rank":3,
            "artist":{
               "class":"artist",
               "id":"35bff379cd084f6e92fc145b3496843f",
               "name":"Ariana Grande"
            }
         },
         ...
         ]
     }
}

Available Artist Charts

These charts are built using all known artists, for the specified metric, and top 50 are returned.

Chart Name UUID
fans added during last day bb789492225c4c4da2e15f617acc9982
fans added during last week a5e7dbdfcd984dc28c350c26a2e703c0
fans daily high flyers c6db7136d639444d9ab54a3c66e0b813
fans total 6aacf495049d4de99c809b0ad8120c39
views during last day 1574c43703344292a753fecf0f793c2e
views during last week b0de4888427d46ac8f599f2f6d51e293
views high flyers 33e77c5fcb06412193995c9a4bb054f4
views total 3040cc0f02ed4dd1a2da9ea95c9a8272
new comments last day d21e3cd170924bcd8874ec15d84b64f1
new comments last week 75f972a32f3547e197668d545f4cda1d
comments total 7908e358427f4efe9f5aac6df69bfcbd
plays last day d527eeba4bdc42178b49d977b375936f
plays last week 627b42c981d4413b83191efd8183a982
plays high flyers b857276b34cf488f9a934765c3281af7
plays total 7a614a370a2848b29c156e27dde582c8