API v3 has been deprecated. Please use API v4 instead

Genres

This endpoint lists all the genres available on Viki.com for specific scopes, along with their respective genre ids.

Scopes

Movies genres:

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

Series genres:

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

Music videos genres:

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

Response

{
   count:22,
   pagination:{
      previous:"",
      next:""
   },
   response:[
      {
         id:1,
         name:"Action & Adventure"
      },
      {
         id:2,
         name:"Anime"
      },
      {
         id:3,
         name:"Biographical"
      },
      {
         id:4,
         name:"Cartoon"
      },
      {
         id:5,
         name:"Classic & Period"
      },
      {
         id:6,
         name:"Comedy"
      },
      {
         id:7,
         name:"Crime"
      },
      {
         id:8,
         name:"Documentary"
      },
      {
         id:9,
         name:"Drama"
      },
      {
         id:10,
         name:"Entertainment"
      },
      {
         id:11,
         name:"Historical"
      },
      {
         id:12,
         name:"Horror & Supernatural"
      },
      {
         id:13,
         name:"Independent"
      },
      {
         id:14,
         name:"Lifestyle"
      },
      {
         id:16,
         name:"Live Action"
      },
      {
         id:15,
         name:"Live Show"
      },
      {
         id:17,
         name:"Music"
      },
      {
         id:18,
         name:"Romance"
      },
      {
         id:19,
         name:"SciFi & Fantasy"
      },
      {
         id:20,
         name:"Sports"
      },
      {
         id:21,
         name:"Variety Show"
      },
      {
         id:22,
         name:"Western"
      }
   ]
}

Parameter Filters

 The Viki genres API provides the following filters to surface the data you need out of this API listing.

  • origin_country{.params}
  • platform{.params}
  • subtitle_language{.params}
  • watchable_in{.params}

origin_country {.params}

Filters genres which have resources from the origin country. This parameter takes in a two-lettered country code. See here for a full list of usable country codes. For example,

GET /api/v3/genres/series.json?access_token=ACCESS_TOKEN&origin_country=kr{.codeblock}

will return genres of all available Korean series.

platform{.params} 

Filters genres that have resources licensed to be watchable in the platform. This parameter is only available if watchable_in is also passed to the API endpoint.

Possible platform options: mobile,  web,  tv

subtitle_language{.params}

Filters genres that have resources according to the subtitle language. For example:

GET /api/v3/genres/series.json?access_token=ACCESS_TOKEN&subtitle_language=fr{.codeblock} 

will return genres of all series that have French subtitles of at least 90% completion. This guarantees a high degree of subtitle coverage for the shows. This parameter takes in a two-lettered language code. See here for a list of usable language codes.

watchable_in{.params} 

Filters genres which have resources according to region licensing availability.

GET /api/v3/genres/series.json?access_token=ACCESS_TOKEN&watchable_in=us{.codeblock}

will return genres that have series watchable in the US. See here for a full list of usable country codes.