Get Dailymotion video
Get a Dailymotion video with title, counts, owner and thumbnails.
Headers
Get your API keyAPI key (`sfk_...`)
Dailymotion video id, e.g. `x9hffw2`. A video URL such as https://www.dailymotion.com/video/x9hffw2 is also accepted.
pattern: ^x[0-9a-z]{1,11}$
Endpoint-specific response payload.
Whether the item was found. A deleted or unknown id is `not_found`. The lists of a deleted user (videos, followers) and the `source=api` related list of a deleted video stay available on Dailymotion, so they are `found` while the user or video itself is `not_found`.
one of: found, not_found
The video when found; otherwise null.
Video id, e.g. `x9hffw2`.
Video page URL.
Short link (dai.ly).
Title.
Description text. It can contain `<br>` or `<br />` line breaks and a literal `\r`; strip the markup if you need plain text.
Tags the owner set.
Language code the owner set.
Country code the owner set.
Category id, as listed by the channels endpoint.
Length in seconds. 0 on live videos and placeholders.
≥ 0
When the video was created. Null where Dailymotion holds a placeholder date. `sort=old` can list these rows ahead of the oldest real dates; `uploadedAt` is still filled.
When the file was uploaded.
Whether the video is marked explicit.
Whether the owner marked the video as made for kids.
Whether the video may be embedded elsewhere.
Where the video is blocked or allowed.
`allow`: the video is shown everywhere, or only in `countries` when any are listed. `deny`: it is blocked in `countries`.
one of: allow, deny
Lower-case two-letter country codes the rule names.
Whether the owner is a partner.
Whether the owner is verified.
Whether the owner flagged the video as altered with AI.
Publication status, `published` on a public video.
When the record was last changed.
The same image at several heights.
Image at its original size.
60 pixels high.
120 pixels high.
180 pixels high.
240 pixels high.
360 pixels high.
480 pixels high.
720 pixels high.
1080 pixels high.
The first frame of the video at several heights.
First frame, 60 pixels high.
First frame, 120 pixels high.
First frame, 180 pixels high.
First frame, 240 pixels high.
First frame, 360 pixels high.
First frame, 480 pixels high.
First frame, 720 pixels high.
First frame, 1080 pixels high.
Preview images for scrubbing.
Sprite sheet of thumbnails along the video.
The same sprite sheet at 320 pixels wide.
Filmstrip of 60-pixel frames.
Seek-bar preview image.
Embed code.
Player URL for an iframe.
Ready-made iframe markup.
Frame size.
Width in pixels.
≥ 0
Height in pixels.
≥ 0
Width divided by height. Below 1 is a vertical video.
Counts for the video.
Views over the video's life.
≥ 0
Views in the last hour.
≥ 0
Views in the last day.
≥ 0
Views in the last week.
≥ 0
Views in the last month.
≥ 0
Likes. 0 on most videos.
≥ 0
Hashtags in the description, with the leading #.
Languages Dailymotion made subtitles for with AI.
Where the video was shot, when the owner set it.
Longitude.
Latitude.
Comment prompt the owner set, when there is one.
The prompt text.
When it was written.
When it was last changed.
`video` or similar.
Quality tiers on offer, e.g. `sd`, `hq`.
Live-stream fields. Null on an on-demand video.
Whether this is a live video (not on demand).
Whether the stream is on air now.
State of a live video: `on_air`, `unprogrammed`, `scheduled_not_started` and similar.
State of the recording of a live video.
Viewers now. 0 on the on-air streams sampled.
≥ 0
Viewers over the whole stream.
≥ 0
When the live video starts.
When the live video ends.
When the live video is scheduled to air.
How often a scheduled live video repeats.
Audio bitrate of the stream.
≥ 0
Whether the live video is recorded automatically.
Visibility and permissions.
Whether the video is private.
Whether the video is published.
Whether a password is needed to watch.
Whether the video can be added to playlists.
Whether in-stream ads are blocked.
Whether others may stitch the video into theirs.
A Dailymotion user.
User id, e.g. `x2znl3e`.
Username.
Display name.
Profile page URL.
Profile description text. It can contain `<br>` or `<br />` line breaks; strip the markup if you need plain text.
Account status, `active` on a public user.
Country code the user set.
City the user set.
Language code the user set.
When the account was created.
Whether the user is verified.
Whether the user is a Dailymotion partner.
Counts for the user.
Views of all the user's videos.
≥ 0
Videos.
≥ 0
Playlists.
≥ 0
Followers.
≥ 0
Accounts the user follows.
≥ 0
Reposts.
≥ 0
Community members.
≥ 0
Communities the user belongs to.
≥ 0
Child accounts.
≥ 0
Links the user lists on the profile.
Website the user lists.
Facebook page the user lists.
Twitter or X page the user lists.
Instagram page the user lists.
Pinterest page the user lists.
The profile picture at several sizes.
Square, 25 pixels.
Square, 60 pixels.
Square, 80 pixels.
Square, 120 pixels.
Square, 190 pixels.
Square, 240 pixels.
Square, 360 pixels.
Square, 480 pixels.
Square, 720 pixels.
The profile cover image at several sizes.
Cover image at its original size.
Cover, 100 pixels high.
Cover, 150 pixels high.
Cover, 200 pixels high.
Cover, 250 pixels high.
A Dailymotion category.
Category id, e.g. `music`.
Category name, e.g. `Music`.
URL slug on the site, which can differ from the id.
Category description text. It can contain `<br>` or `<br />` line breaks; strip the markup if you need plain text.
When the category was created.
When the category was last changed.
Extra video fields. Empty when `status` is `unavailable`.
`included`: the fields below are present. `not_offered`: Dailymotion has none for this item (a live stream), so they are empty. `unavailable`: they are temporarily unavailable and empty; every other field of the video is complete, and a later request usually fills them.
one of: included, not_offered, unavailable
Language Dailymotion detected in the audio, e.g. `en`.
Content categories Dailymotion assigned.
Category name, e.g. `NEWS`.
Category slug, e.g. `content-news`.
IAB advertising categories at 70% confidence or more, e.g. `iab-326`.
When Dailymotion's moderators last reviewed the video.
Whether Dailymotion marks the video as suggestive.
Whether Dailymotion may show ads on the video.
Best quality offered, e.g. `HD1080P`.
Comments on the video as Dailymotion counts them, replies included. The comments endpoint's `total` counts top-level comments only, so it is lower when there are replies.
≥ 0
Whether a transcript exists. Read it with the transcript endpoint.
Chapters. Empty on every video sampled.
Start of the chapter, `HH:MM:SS,mmm`.
Chapter title.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/dailymotion/videos/x9hffw2" \
-H "x-api-key: YOUR_API_KEY"Responses
A Dailymotion video.