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

Response formats JSON, XML
Requires authentication? No
Rate limited? No

Query parameters

Either the id or url parameter must be specified in a request. It is not necessary to include both.

Parameter Description Example value
id The ID of the desired Vine video. Ml16lZVTTxe
url The URL of the Vine video to be embedded https%3A%2F%2Fvine.co%2Fv%2FMl16lZVTTxe
maxwidth Set the maximum width of the displayed embed in whole pixels 500
maxheight Set the maximum height of the displayed embed in whole pixels 500
omit_script Do not include the Vine embed JavaScript in the response 1

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
}