Dailymotion Video API
One video with its text, metrics, images, embed code, owner and extra fields.
GET /v1/dailymotion/videos/{videoId}1 credit Failed requests are free
About this endpoint
GET /v1/dailymotion/videos/{videoId} takes a video id such as x9hffw2. A video page URL, a dai.ly short link or an embed URL is accepted and reduced to the id.
On found, data.video carries the full record: title, description, tags, language, country, categoryId, durationSeconds, createdAt and uploadedAt, plus metrics.views, metrics.likes and the four windowed view counts. thumbnails and firstFrames give nine heights each, storyboard carries scrub previews, and embed gives a player URL and ready-made iframe markup. geoblocking, availability, owner, channel and hashtags describe where and by whom the video may be shown. extras adds detectedLanguage, categories, iabCategories, moderationReviewedAt, commentCount, hasTranscript and chapters, with extras.status saying whether they are included.
lookupStatus is found or not_found; a deleted or unknown id answers not_found with video: null and HTTP 200.
Dailymotion Video API FAQ
Which video ids does it accept?
An id such as x9hffw2, or a full https://www.dailymotion.com/video/x9hffw2 URL, a dai.ly short link or an embed URL. Links are reduced to the id, so a saved link can be sent as it is.
What does extras.status mean?
included means the extra fields are present. not_offered means there are none for this item, for example a live stream with no extra details. unavailable means they are temporarily unavailable and empty while the rest of the video is complete; a later request usually fills them.
What happens for a deleted video?
data.lookupStatus is not_found and data.video is null. The request still returns HTTP 200, so branch on lookupStatus instead of the status code.
How many credits does a video lookup cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
Other Dailymotion endpoints
- Search videosGET /v1/dailymotion/videos/search
- Related videosGET /v1/dailymotion/videos/{videoId}/related
- SubtitlesGET /v1/dailymotion/videos/{videoId}/subtitles
- CommentsGET /v1/dailymotion/videos/{videoId}/comments
- Comment repliesGET /v1/dailymotion/videos/{videoId}/comments/{commentId}/replies
- TranscriptGET /v1/dailymotion/videos/{videoId}/transcript
- UserGET /v1/dailymotion/users/{user}
- Search usersGET /v1/dailymotion/users/search