V5 of the Clips API is now available

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 to slug.
  • 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`
2 Likes

Will old clip URLs remain after the 6 month period?

The old Clip URLs should already redirect to a new URL without the channel name in it.

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.