This is the documentation for version 3 of Viki’s official API. This API is still a work in progress, which means periodic changes are expected from time to time. Viki API V2 is deprecated, though documentation may still be found here.
All API endpoints are accessed through the www.viki.com/api/v3 domain.
We use authentication to track usage data of our API. OAuth2.0 authentication is required to access all Viki v3 API endpoints. A thorough authentication guide is available here.
All API resources may be retrieved in either JSON or XML formats. These formats are called by adding
.xml extensions to your requests. Leaving out the format extension will cause an error. For example:
will return a list of movie resources in JSON format, and calling:
will return the same list of movie resources in XML format.
The only exceptions are subtitles and JSONP resources, covered below.
Subtitles are returned as JSON only either as uncompressed(.json) or compressed(.gz) formats. For example:
will return all the of subtitles in JSON format, and calling:
will return the same subtitles in a gzip file.
More information on JSONP may be found here.
All times returned in the Viki V3 API are in UTC.
All the image URIs returned in the Viki API may be resized arbitrarily by adding the following extension to the URI:
/size/ZZZxYYY (ZZZ=width, YYY=height). The maximum dimensions for an image are 2000x2000.
Here’s a full list of resources exposed in the Viki V3 API.
There is a mailing list for the Viki API were you can write for support: email@example.com
To see the group of already asked questions please direct to our google group page.