VIDEO
Status: PRODUCTION A
VIDEO
link type represents any video file accessible at a given URL, including common formats like MP4, WebM, MOV, AVI, FLV, and more.
GIF files are also considered videos and will return this type.
In addition to the standard preview fields (title
, description
, image
), VIDEO
links provide comprehensive technical details—such as duration, dimensions, format, and codec—plus optional snapshots and responsive video assets.
This allows you to tailor the viewing experience, optimize performance, and provide meaningful metadata to your users.
What It Includes
Whentype
is VIDEO
, the response includes a video
object with fields like:
- duration: Total length of the video in seconds.
- width, height: The video’s resolution if available.
- format: The container/format used (e.g., mp4, webm, mov, gif).
- size: File size in bytes.
- bitRate, frameRate, videoCodec: Technical parameters to fine-tune user experience, such as playback quality or buffering strategies.
- hasAudio: Indicates if the video includes an audio track.
- author: If available, the creator’s name or source.
- image & video fields: Responsive images and video renditions for adaptive streaming, as well as
snapshots
—preview frames from various points in the video.
Example Request
Example Response
Special Notes
- Adaptive Experiences: Use responsive images and possibly multiple video renditions to provide a seamless viewing experience across varying network conditions and device capabilities.
- Author & Metadata: If an author or a descriptive title is available, it enhances the user’s understanding of the content.
- Snapshots: Grab frames at different timestamps to show previews (e.g., thumbnails for video timelines).