Developer API documentation

Events Endpoints

These endpoints provide lists of events which are associated with a given entity. Three types of events are available: tv, release, and upload

General URI Format

Calls are of the form:

http://api.semetric.com/[entity_type]/[id]/[tv|release|upload]/?token=[api_key]

Where:

  • entity_type can be either the generic type entity, or one of the specific names for supported entities;
  • id is the id of the entity (see ID Schemas);
  • token=YOURAPIKEY must be given.

The event types are:

  • tv provides television features or appearances for an entity (currently only US TV);
  • release provides a list of releases;
  • upload provides a list of the uploaded video and audio for streaming services.

Examples

The following command lists the TV events for Lil Wayne:

http://api.semetric.com/artist/08f2c17632f349c7a742c56289b98465/tv/?token=[api_key]

The JSON response is:

{
"response": {
    "entities": [
        {
            "class": "tv",
            "country": "US",
            "end_time": 1308528000,
            "id": "musicmetric:183965",
            "name": "Lil Wayne was a performer on Unplugged, MTV2 Presents Unplugged Re
                     Cut Lil Wayne",
            "start_time": 1308441600
        },
        {
            "class": "tv",
            "country": "US",
            "end_time": 1307923200,
            "id": "musicmetric:183965",
            "name": "Lil Wayne was a performer on Unplugged, MTV2 Presents Unplugged Lil Wayne",
            "start_time": 1307836800
        },
        ...
        ]
},
"success": true
}

The following command lists the release events for Skrillex:

http://api.semetric.com/artist/7668a8e2506b4282b396ee6c2851979e/release/?token=[api_key]

The JSON response is:

{
   "response":{
      "entities":[
         {
            "name":"Try It Out",
            "country":"US",
            "start_time":1381708800,
            "class":"ep",
            "end_time":1381795200,
            "media_type":"Digital Media",
            "id":"musicbrainz:f75653f0-1da0-41f5-9229-a11f4968d207"
         },
         {
            "name":"Spring Breakers",
            "country":"US",
            "start_time":1363046400,
            "class":"album",
            "end_time":1363132800,
            "media_type":"CD",
            "id":"musicbrainz:5deb04e3-447c-423d-8e92-dd662f5c8b49"
         },
         {
            "name":"Leaving EP",
            "country":"XW",
            "start_time":1357084800,
            "class":"ep",
            "end_time":1357171200,
            "media_type":"Digital Media",
            "id":"musicbrainz:ac892119-67b3-4c2b-a122-415584d5cd51"
         },
      ...
      ]
   },
   "success":true
}