Dailymotion

Search Dailymotion videos

Search Dailymotion videos by term, category, language, country, tag, duration and time window.

GET/v1/dailymotion/videos/search
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
14
querystringquery

Search term, up to 150 characters. Any language.

min 1 chars · max 150 chars

sortstringquery

Order. Default: relevance with a query, otherwise recent. Relevance and old need a query. `old` can start with videos whose `createdAt` is null. Relevance order can shift between pages, so a row can repeat.

one of: relevance, recent, old, visited, visited-hour, visited-today, visited-week, visited-month, trending

categorystringquery

Category id, as listed by the channels endpoint (`id`), e.g. `music`, `news`, `auto` (Cars).

one of: animals, auto, people, fun, creation, school, videogames, kids, lifestyle, shortfilms, music, news, sport, tech, travel, tv, webcam

languagestringquery

Two-letter language code the owner set, e.g. `en`.

pattern: ^[A-Za-z]{2}$

countrystringquery

Two-letter country code the owner set, e.g. `us`.

pattern: ^[A-Za-z]{2}$

tagsstringquery

One tag the owner set on the video.

min 1 chars · max 100 chars

livestringquery

`onair` for live videos streaming now, `offair` for other live videos. The list can change between requests, so treat an empty `onair` result as unreliable. A row returned for `onair` can still have `onAir` false.

one of: onair, offair

minDurationintegerquery

Shortest video, in minutes.

≥ 0 · ≤ 86400

maxDurationintegerquery

Longest video, in minutes.

≥ 0 · ≤ 86400

createdAfterstringquery

Only videos created after this time (ISO 8601 with a time zone, 2005-01-01 or later). With createdBefore this windows past 1,000 rows. A category with a date window and no query can be slow.

createdBeforestringquery

Only videos created before this time (ISO 8601 with a time zone, 2005-01-01 or later). With createdAfter this windows past 1,000 rows. A category with a date window and no query can be slow.

includeExplicitstringquery

Include videos marked explicit. Default: false, as on the site's own search.

one of: true, false

pageintegerquery

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

≥ 1 · ≤ 100

limitintegerquery

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
48

Endpoint-specific response payload.

Videos, in order.

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 match, counted up to 1000. A larger real total shows as 1000. 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/videos/search?query=news&category=news" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Dailymotion videos.