The following changes are now in effect for all Clips API endpoints as they move from V4 to V5.
- The Clip identifier in a response has been changed from
id
toslug
. -
Clip URLs in a response now use just a
slug
instead of a channel and slash preceding the slug. - The
language
parameter has been added as an optional query string when requesting top Clips and followed Clips.
These points are explained in greater detail below or you can jump right to the Clips documentation.
#Support and deprecation of Clips V4
V4 of the Clips API endpoints will no longer be supported as of today. However, it will be available for a period of six months providing time for updates to your development (on or about October 13, 2017).
Clip identifier
id
in API responses has been changed to slug
.
...
"game": "",
"id": "AmazonianEncouragingLyrebirdAllenHuhu",
"slug": "AmazonianEncouragingLyrebirdAllenHuhu",
"language": "en",
...
Clip URLs
Channel references are no longer found in URLs, only a slug
. Here’s a before and after example of embed code that you may receive from any of the Clips API endpoints.
Before
height="360" width="640" frameborder="0" scrolling="no" allowfullscreen="true">
</iframe>```
**After**
```<iframe
src="https://clips.twitch.tv/embed?clip=IncredulousAbstemiousFennelImGlitch"
height="360" width="640" frameborder="0" scrolling="no" allowfullscreen="true">
</iframe>```
##`language` parameter
`language` is a comma-separated list of language identifiers (e.g. `es` or `en,es,th`) , which will limit the returned videos to only those that match the specified languages. If no language is specified, all languages are returned. There is a maximum of 28 languages for this parameter. This parameter can be used when requesting top Clips and followed Clips.
**Example:**
`https://api.twitch.tv/kraken/clips/top?language=en`