Vine oEmbed API
Returns a simple embed HTML for a single Vine video, specified by either a full URL or video ID, in an oEmbed-compatible format.
The Vine video markup is meant to be cached on your servers for up to the suggested cache lifetime specified by the cache_age
response parameter.
Resource URL
https://vine.co/oembed.{format}
Resource Information
Query parameters
Either the id
or url
parameter must be specified in a request. It is not necessary to include both.
The ID of the desired Vine video.
Example Value: Ml16lZVTTxe
The URL of the Vine video to be embedded.
Example Values:
To embed the Vine at https://vine.co/v/Ml16lZVTTxe
, use: https%3A%2F%2Fvine.co%2Fv%2FMl16lZVTTxe
Set the maximum width of the displayed embed in whole pixels.
Example Value: 500
Set the maximum height of the displayed embed in whole pixels.
Example Value: 500
Do not include the Vine embed JavaScript in the response.
Example Request
GET
https://vine.co/oembed.json?url=https%3A%2F%2Fvine.co%2Fv%2FMl16lZVTTxe
Example Result
{ "version": 1.0, "type": "video", "cache_age": 3153600000, "provider_name": "Vine", "provider_url": "https://vine.co/", "author_name": "The White House", "author_url": "https://vine.co/u/944054069482373120", "title": "Marine One, ready for takeoff. \ud83d\ude81", "thumbnail_url": "https://v.cdn.vine.co/r/thumbs/3A1E5CC27C1116110482407841792_2.5.1.13603721890676705621.mp4.jpg?versionId=_B5dDtCI.ZNd_JLK_.sFmfpQq44iXdey", "thumbnail_width": 480, "thumbnail_height": 480, "html": "<iframe class=\"vine-embed\" src=\"https://vine.co/v/Ml16lZVTTxe/embed/simple\" width=\"600\" height=\"600\" frameborder=\"0\"><\/iframe><script async src=\"//platform.vine.co/static/scripts/embed.js\"><\/script>", "width": 600, "height": 600 }