Search Dailymotion videos
Search Dailymotion videos by term, category, language, country, tag, duration and time window.
Headers
Get your API keyAPI key (`sfk_...`)
Search term, up to 150 characters. Any language.
min 1 chars · max 150 chars
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
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
Two-letter language code the owner set, e.g. `en`.
pattern: ^[A-Za-z]{2}$
Two-letter country code the owner set, e.g. `us`.
pattern: ^[A-Za-z]{2}$
One tag the owner set on the video.
min 1 chars · max 100 chars
`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
Shortest video, in minutes.
≥ 0 · ≤ 86400
Longest video, in minutes.
≥ 0 · ≤ 86400
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.
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.
Include videos marked explicit. Default: false, as on the site's own search.
one of: true, false
Page number (1-100). Default: 1. A list never reaches past 1000 rows.
≥ 1 · ≤ 100
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
Endpoint-specific response payload.
Videos, in order.
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.
Views over the video's life.
≥ 0
Likes. 0 on most videos.
≥ 0
Thumbnail, 240 pixels high.
Thumbnail, 720 pixels high.
Whether this is a live video.
Whether a live stream is on air now. It can be false on a row returned for `live=onair`.
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.
The user who owns a video or a playlist.
User id, e.g. `x2znl3e`.
Username.
Display name.
Profile page URL.
Whether the user is verified.
Whether the user is a Dailymotion partner.
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.
Current page number (1-based).
≥ 0
Whether another page is available.
Next page number when more pages exist; null on the last page.
≥ 0
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/search?query=news&category=news" \
-H "x-api-key: YOUR_API_KEY"Responses
Dailymotion videos.