The Wayback Machine - https://web.archive.org/web/20151028175344/https://dev.twitter.com/web/vine/oembed

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.

id required

The ID of the desired Vine video.

Example Value: Ml16lZVTTxe

url required

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

maxwidth

Set the maximum width of the displayed embed in whole pixels.

Example Value: 500

maxheight

Set the maximum height of the displayed embed in whole pixels.

Example Value: 500

omit_script

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
}