Clips Response Schema
The clip object is a variation of our publicly documented gif object. In addition to the properties provided by the gif object, clip objects have an additional video property that contains all of the media information for video format. The Pagination and Meta objects are also publicly documented.
| Property | Type | Description |
|---|---|---|
| type | string | Indicates the type of GIPHY asset, always “video” for clips |
| id | string | Unique ID for a GIPHY asset |
| url | string | URL linking to the GIPHY - Be Animated page for the clip |
| embed_url | string | URL used to access a rich media player for the Clip |
| duration | string | The duration of the video expressed as seconds plus a portion of a second as a decimal. |
| username | string | Username the Clip is attached to, if applicable |
| source | string | The page on which this Clip was found |
| title | string | The title that appears on GIPHY - Be Animated for the clip |
| rating | string | The MPAA-style rating for this content. Accepted values are G, PG, PG-13 and R |
| cta | CTA | An optional object containing data for connections to third party applications for custom GIPHY partnerships when available for a Clip. For example, for this GIF we link to a specific track within the Spotify app. |
| images | Image[] | An object containing data for various available formats and sizes of this GIF version (i.e no sound) of Clip. Use any of these for previews in a scrollable grid. Check here for more details. We do not generate the following renditions for Clips: preview, preview_gif, looping, fixed_width_small, fixed_width_small_still, fixed_height_small, fixed_height_small_still, downsized_small, downsized_still, downsized |
| user | User | An object containing data about the user associated with this clip, if applicable. Check here for more details |
| video | Video | An object that contains all of the media information for video format for the clip. Check here for more details |
The Video Object
| Property | Type | Description |
|---|---|---|
| description | string | Additional information about a Clip |
| assets | Object | Similar to the images properties, this provides various video renditions with their rendition name as the property:
The 360p rendition is always present by default. All other renditions will only be present if they are available. Each rendition contains: width, height, url |
| captions | Object | This object provides URLs to caption files in Subrip and Webvtt format (if available) based on transcriptions from the clip audio in the native language. Format of a captions object:
Additionally the mp4 assets within the video object contain a captions stream too if available in the clip’s native language |
| native | string | ISO 639-1 language code that is the native language caption for the clip. references property in captions object |