Table of content

Embed videos with oEmbed

What is oEmbed

oEmbed is a format for allowing an embedded representation of a URL on third-party sites. The protocol allows a website to turn a Dailymotion video page URL into a structured data set, making it easy to embed and share content across the web.

When to use it

This protocol is the preferred method when you need to transform the URL provided into an embed code. For more information, see the oEmbed specification.

How to use it

Use the following endpoint to request the corresponding video information using only a Dailymotion video URL. Add in URL params from the table below to configure the response.

Available URL parameters

ParameterParameter description
urlThe Dailymotion URL for a video (required)
maxwidthThe maximum width the embedded video can take on the destination page
maxheightThe maximum height the embedded video can take on the destination page
formatResponse format, either json or xml. Defaults to json
callbackWhen returning JSON, wrap in this function
playerThe player ID that the loaded player will be created with. This ID can be accessed via the Players tab on Dailymotion Studio.


Call using URL parameters:

// Replace x7tgad0 with your Video ID and xfh28 with your own Player ID

JSON response:

"type": "video",
"version": "1.0",
"provider_name": "Dailymotion",
"provider_url": "",
"title": "Midnight Sun | Iceland",
"description": "",
"author_name": "Dailymotion player demo",
"author_url": "",
"width": 478,
"height": 268,
"html": "<iframe frameborder=\"0\" width=\"478\" height=\"268\" src=\"\" allowfullscreen allow=\"autoplay; fullscreen; picture-in-picture\"></iframe>",
"thumbnail_url": "",
"thumbnail_width": 427,
"thumbnail_height": 240