API v3 has been deprecated. Please use API v4 instead

Subscriptions

The Subscriptions endpoint exposes subscriptions users have made to various Viki resources.

List Subscriptions for User

Return a list of subscriptions for a particular user.

GET: /api/v3/users/:id/subscriptions(.json|.xml)

{
  "count":1,
  "pagination":{
    "previous":"",
    "next":""
  },
  "response":[
  {"id":1021923,
  "created_at":"November 06, 2012 05:38",
  "type":"series",
  "resource":{
    "id":50,
    "title":"Boys Over Flowers",
    "title_language":"en",
    "description":"A Korean drama adaptation of the Japanese manga Hana Yori Dango. Jan Di is an average girl whose family owns a dry cleaning store. Jan Di meets the four richest and most spoiled boys known as the F4. After saving a boy from jumping off the roof of Shinhwa High School, she is admitted into the school on a swimming scholarship. Jan Di tries to avoid confrontation with the F4. However, when Jan Di's friend accidentally gets ice cream on the leader of the F4's shoes, she's forced to declare war...",
    "description_language":"en",
    "uri":"http://www.viki.com/api/v3/series/50.json",
    "web_uri":"http://www.viki.com/channels/50-boys-over-flowers",
    "subscriptions":{"count":12669},
    "created_at":"December 11, 2008 12:44",
    "genres":[
      {"id":6, "name":"Comedy"},
      {"id":9, "name":"Drama"},
      {"id":23, "name":"Korean Drama"},
      {"id":18, "name":"Romance"}],
    "origin_country":"Korea",
    "image":"http://x1.vikiassets.com/uploads/channel/thumbnail/50/dee6eddafa01accc3caca927ed4263c23afff034.jpg/w460/h335/a",
    "episodes":{
      "count":25,
      "uri":"http://www.viki.com/api/v3/series/50/episodes.json"
    },
    "subtitles":
      {"sr":100,"pt":99,"vi":99,"bn":99,"tr":99,"pl":99,"th":99,"no":99,"cs":99,"tl":99,"nl":99,"en":99,"fi":99,"fr":99,"ar":99,"de":99,"el":99,"ro":99,"ms":99,"es":99,"sl":99,"hu":99,"id":99,"it":99,"ja":99,"sk":99,"fa":99,"ru":99,"sv":99,"ko":98,"gl":95,"mn":92,"he":86,"zh":76,"bg":57,"sq":48,"da":37,"cy":29,"ku":19,"hi":18,"jv":7,"ps":6,"my":6,"lt":2,"br":2,"ne":2,"ta":2,"gu":1,"to":1,"hm":1,"ur":1,"az":1,"nn":1}}
  }

Show Subcription

Show details of a particular subscription.

GET: /api/v3/users/:id/subscriptions/:id(.json|.xml)

Create Subscription

This requires authentication with the user (grant type: password).

POST: /api/v3/users/:id/subscriptions(.json|.xml)

Parameters:

  • subscription:
  • type: String. Type of target object to subscribe: ‘movie’, ‘series’, ‘artist’, ‘newscast’.
  • id: Integer. ID of the target object.

example:

curl http://www.viki.com/api/v3/users/526361/subscriptions.json?access_token=XXX -d "subscription[type]=series&subscription[id]=50"

Delete Subscription

This requires authentication with the user.

DELETE: /api/v3/users/:id/subscriptions/:id(.json|.xml)