Dailymotion

Get Dailymotion playlist

Get a Dailymotion playlist and a page of its videos.

GET/v1/dailymotion/playlists/{playlistId}
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
playlistIdstringrequiredpath

Dailymotion playlist id, e.g. `x6lqos`. A playlist URL such as https://www.dailymotion.com/playlist/x6lqos is also accepted.

pattern: ^x[0-9a-z]{1,11}$

pageintegeroptionalquery

Page number (1-100). Default: 1. A list never reaches past 1000 rows.

≥ 1 · ≤ 100

limitintegeroptionalquery

Rows per page (1-100). Default: 30. A page costs the same at any size. A list never reaches past 1000 rows, so a page size of 100 reaches at most page 10.

≥ 1 · ≤ 100

Response fields
67

Endpoint-specific response payload.

datalookupStatus
string

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 playlist when found; otherwise null.

dataplaylistid
string

Playlist id.

dataplaylisturl
stringnullable

Playlist page URL.

dataplaylistname
stringnullable

Playlist name.

dataplaylistdescription
stringnullable

Description text. It can contain `<br>` or `<br />` line breaks; strip the markup if you need plain text.

dataplaylistvideoCount
integernullable

Videos in the playlist. It can be higher than `total` on the playlist endpoint, whose video list leaves out explicit videos.

≥ 0

dataplaylistisPrivate
booleannullable

Whether the playlist is private.

dataplaylistthumbnailUrl
stringnullable

Thumbnail, 240 pixels high.

dataplaylistlargeThumbnailUrl
stringnullable

Thumbnail, 720 pixels high.

dataplaylistcreatedAt
stringnullable

When the playlist was created.

dataplaylistupdatedAt
stringnullable

When the playlist was last changed.

The user who owns a video or a playlist.

dataplaylistownerid
stringnullable

User id, e.g. `x2znl3e`.

dataplaylistownerusername
stringnullable

Username.

dataplaylistownerscreenName
stringnullable

Display name.

dataplaylistownerurl
stringnullable

Profile page URL.

dataplaylistownerverified
booleannullable

Whether the user is verified.

dataplaylistownerpartner
booleannullable

Whether the user is a Dailymotion partner.

A page of the playlist's videos. Empty when the playlist is not found.

datavideos[]id
string

Video id, e.g. `x9hffw2`.

datavideos[]url
stringnullable

Video page URL.

datavideos[]shortUrl
stringnullable

Short link (dai.ly).

datavideos[]title
stringnullable

Title.

datavideos[]description
stringnullable

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.

datavideos[]tags[]
stringoptional
datavideos[]language
stringnullable

Language code the owner set.

datavideos[]country
stringnullable

Country code the owner set.

datavideos[]categoryId
stringnullable

Category id, as listed by the channels endpoint.

datavideos[]durationSeconds
integernullable

Length in seconds. 0 on live videos and placeholders.

≥ 0

datavideos[]createdAt
stringnullable

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.

datavideos[]uploadedAt
stringnullable

When the file was uploaded.

datavideos[]viewCount
integernullable

Views over the video's life.

≥ 0

datavideos[]likeCount
integernullable

Likes. 0 on most videos.

≥ 0

datavideos[]thumbnailUrl
stringnullable

Thumbnail, 240 pixels high.

datavideos[]largeThumbnailUrl
stringnullable

Thumbnail, 720 pixels high.

datavideos[]isLive
boolean

Whether this is a live video.

datavideos[]onAir
booleannullable

Whether a live stream is on air now. It can be false on a row returned for `live=onair`.

datavideos[]explicit
booleannullable

Whether the video is marked explicit.

datavideos[]madeForKids
booleannullable

Whether the owner marked the video as made for kids.

datavideos[]allowEmbed
booleannullable

Whether the video may be embedded elsewhere.

Where the video is blocked or allowed.

datavideos[]geoblockingmode
string

`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.

datavideos[]geoblockingcountries[]
stringoptional
datavideos[]partner
booleannullable

Whether the owner is a partner.

datavideos[]verified
booleannullable

Whether the owner is verified.

datavideos[]alteredWithAi
booleannullable

Whether the owner flagged the video as altered with AI.

datavideos[]status
stringnullable

Publication status, `published` on a public video.

The user who owns a video or a playlist.

datavideos[]ownerid
stringnullable

User id, e.g. `x2znl3e`.

datavideos[]ownerusername
stringnullable

Username.

datavideos[]ownerscreenName
stringnullable

Display name.

datavideos[]ownerurl
stringnullable

Profile page URL.

datavideos[]ownerverified
booleannullable

Whether the user is verified.

datavideos[]ownerpartner
booleannullable

Whether the user is a Dailymotion partner.

datatotal
integernullable

Videos the playlist lists, counted up to 1,000. It can be lower than `playlist.videoCount`, which includes explicit videos this list leaves out. Null when Dailymotion does not count the list on this page.

≥ 0

Pagination state for the current page.

datapagepage
integer

Current page number (1-based).

≥ 0

datapagehasMore
boolean

Whether another page is available.

datapagenextPage
integernullable

Next page number when more pages exist; null on the last page.

≥ 0

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/dailymotion/playlists/x3q6vw" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A Dailymotion playlist.