Dailymotion

List related Dailymotion videos

List the videos Dailymotion relates to a video.

GET/v1/dailymotion/videos/{videoId}/related
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
videoIdstringrequiredpath

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}$

sourcestringoptionalquery

`site` (default) is the site's related list: 30 to 90 videos, redrawn each call, page 1 only. `api` is a shorter fixed list of 17 to 18 videos that pages.

one of: site, api

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
50

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

datasource
string

Which list this page is: `site` for the site's related list, `api` for the shorter fixed list.

one of: site, api

Related videos, in order. Empty when the video is not found. A video that was deleted or is not public is not listed.

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

How many rows the list holds, counted up to 1000. With `source=site` it is the number of rows in this sample and can change between calls.

≥ 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/videos/x9hffw2/related?source=api" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Videos related to a Dailymotion video.