oEmbed API

Overview

Videobot supports the oEmbed protocol, enabling automatic video unfurling in platforms like Slack, Discord, social media, and AI tools like ChatGPT.

When you share a Videobot embed URL, platforms that support oEmbed will automatically fetch video metadata and display a rich preview with the video player.

How It Works

Every Videobot embed page includes an oEmbed discovery link:

<link rel="alternate" type="application/json+oembed"
      href="https://videobot.com/embed/oembed?url=..."
      title="Videobot oEmbed">

Platforms automatically detect this link and fetch the oEmbed data to render a video player instead of a plain link.

Endpoint

GET https://videobot.com/embed/oembed

Parameters

Parameter	Required	Description
url	Yes	URL-encoded Videobot embed URL
format	No	Response format (only json is supported)

Example Request

curl "https://videobot.com/embed/oembed?url=https%3A%2F%2Fvideobot.com%2Fembed%2FU4yKQXp1%3Flang%3Den&format=json"

Example Response

{
  "version": "1.0",
  "type": "video",
  "provider_name": "Videobot",
  "provider_url": "https://videobot.com",
  "title": "Company Name | Videobot",
  "width": 378,
  "height": 720,
  "thumbnail_url": "https://customer-xxx.cloudflarestream.com/.../thumbnail.jpg",
  "thumbnail_width": 378,
  "thumbnail_height": 720,
  "html": "<iframe src=\"https://videobot.com/embed/U4yKQXp1?lang=en\" width=\"378\" height=\"720\" frameborder=\"0\" allow=\"autoplay; fullscreen; picture-in-picture\" allowfullscreen></iframe>"
}

Video Dimensions

Dimensions are calculated based on the Videobot's aspect ratio:

Orientation	Aspect Ratio	Dimensions
Vertical (default)	21:40	378 × 720
Horizontal	40:21	1280 × 672

The horizontal orientation is determined by the ?horizontal=true parameter in the embed URL.

Supported Platforms

oEmbed is a widely adopted standard. Platforms that will automatically unfurl Videobot links include:

• Slack
• Discord
• Notion
• Medium
• And many more...

Additional Metadata

In addition to oEmbed, Videobot embed pages include:

• Open Graph video tags (og:video, og:video:type, etc.)
• Twitter Player Card (twitter:card=player)
• Schema.org VideoObject (JSON-LD structured data)

These ensure maximum compatibility across different platforms and search engines.