API v3 has been deprecated. Please use API v4 instead

Newscasts

Newscasts are collections of news clips.

List Newscasts

Get a list of newscasts resources on Viki. 

GET: /api/v3/newscasts(.json|.xml){.codeblock}

Response

Here’s a sample response, with only one newscast resource in the listing for brevity’s sake.

{
  count:4,
  pagination:{
    previous:"",
    next:""
  },
  response:[
    {
      id:6365,
      description:"Entertainment News - Indonesia, gives you access to international and local entertainment news in Bahasa. Get the latest scoop on your favorite Indonesian and international stars, shows and movies in your own language.",
      title:"Entertainment News - Indonesia",
      title_language:"en",
      description_language:"en",
      uri:"http://www.viki.com/api/v3/newscasts/6365.json",
      web_uri:"http://www.viki.com/channels/6365-vscoop-indonesia",
      created_at:"November 22, 2011 08:05",
      image:"http://m3.viki.com/aHR0cDovL2MwLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvNjM2NS83MjhiNmZhZmU4ZmMyNWEwZWEzOGJmYjkzN2JjOTQ0MmU2ZmUzOTljLmpwZw==",
      newsclips:{
        count:57,
        uri:"http://www.viki.com/api/v3/newscasts/6365/newsclips.json"
      }
    },
    {
      id:3451,
      description:"Entertainment News - USA, brings you the latest entertainment news, gossip and happenings of your favorite Hollywood celebrities. Get the latest scoop all the way from USA, in your own language!",
      title:"Entertainment News - USA",
      title_language:"en",
      description_language:"en",
      uri:"http://www.viki.com/api/v3/newscasts/3451.json",
      web_uri:"http://www.viki.com/channels/3451-vscoop-usa",
      created_at:"March 07, 2011 03:16",
      image:"http://m3.viki.com/aHR0cDovL2MyLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvMzQ1MS8xMjdiZTU4MjhjNDlkZDZiNGZjYzJmNDVkOGZiNmQ2YjZjNzEyMTRiLmpwZw==",
      newsclips:{
        count:3811,
        uri:"http://www.viki.com/api/v3/newscasts/3451/newsclips.json"
      }
    },
    {
      id:3227,
      description:"Entertainment News - Taiwan, brings you the latest entertainment news, gossip and happenings of your favorite Taiwanese stars. Get the latest scoop all the way from Taiwan, in your own language!",
      title:"Entertainment News - Taiwan",
      title_language:"en",
      description_language:"en",
      uri:"http://www.viki.com/api/v3/newscasts/3227.json",
      web_uri:"http://www.viki.com/channels/3227-vscoop-taiwan",
      created_at:"February 15, 2011 14:01",
      image:"http://m3.viki.com/aHR0cDovL2MzLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvMzIyNy82NjY1MDRkYzMzNzA0ZjQzMTg1YmQ3NzM3ZWYxY2EwM2RhZGJkYjQ5LmpwZw==",
      newsclips:{
        count:0,
        uri:"http://www.viki.com/api/v3/newscasts/3227/newsclips.json"
      }
    },
    {
      id:1659,
      description:"Entertainment News - Korea brings you the latest entertainment news, gossip and happenings of your favorite Hallyu stars. Get the latest scoop all the way from Korea, in your own language!
",
      title:"Entertainment News - Korea ",
      title_language:"en",
      description_language:"en",
      uri:"http://www.viki.com/api/v3/newscasts/1659.json",
      web_uri:"http://www.viki.com/channels/1659-v-scoop",
      created_at:"August 05, 2010 13:05",
      image:"http://m1.viki.com/aHR0cDovL2MwLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvMTY1OS82ODM1YzA2ZmM2YjMxMzFkZWZjYWUzYTlhNjcyZjlhNTZlN2IwMGUwLmpwZw==",
      newsclips:{
        count:971,
        uri:"http://www.viki.com/api/v3/newscasts/1659/newsclips.json"
      }
    }
  ]
}

Parameter Options

  • language{.params}
  • page{.params}
  • per_page{.params}
  • order{.params}

language{.params}

the language parameter may be passed to display newscast titles and descriptions in your language of choice. For example,

GET /api/v3/newscasts.json?access_token=ACCESS_TOKEN&language=ko{.codeblock}

will return a list of newscasts resources with names and descriptions in Korean. For items with no Korean translations available, titles and descriptions will default to English. See here for a full list of usable language codes.

page{.params}

the page option is used to get a specific page of results. By default API responses are paginated, with 25 items per page. So:

GET /api/v3/newscasts.json?access_token=ACCESS_TOKEN&page=2{.codeblock}

will return the second page of the newscast results.

per_page{.params}

the per_page option is used to specify the number of items per page.

order{.params}

The order option is used to specify the sorting criteria of the results. Possible values are:

  • title - sorts resources by title (alphabetical)
  • created_at - sorts resources according to creation date (latest)

Show Newscast

Get a single newscast resource.

GET: /api/v3/newscasts/:id(.json|.xml){.codeblock}

A sample query:

GET: /api/v3/newscasts/6365.json?access_token=ACCESS_TOKEN{.codeblock}

Response:

{
  id:6365,
  description:"Entertainment News - Indonesia, gives you access to international and local entertainment news in Bahasa. Get the latest scoop on your favorite Indonesian and international stars, shows and movies in your own language.",
  title:"Entertainment News - Indonesia",
  title_language:"en",
  description_language:"en",
  uri:"http://www.viki.com/api/v3/newscasts/6365.json",
  web_uri:"http://www.viki.com/channels/6365-vscoop-indonesia",
  created_at:"November 22, 2011 08:05",
  image:"http://m3.viki.com/aHR0cDovL2MwLnZpa2lhc3NldHMuY29tL3VwbG9hZHMvY2hhbm5lbC90aHVtYm5haWwvNjM2NS83MjhiNmZhZmU4ZmMyNWEwZWEzOGJmYjkzN2JjOTQ0MmU2ZmUzOTljLmpwZw==",
  newsclips:{
    count:57,
    uri:"http://www.viki.com/api/v3/newscasts/6365/newsclips.json"
  }
}