v1

latestOpenAPI 3.0.02026-07-24674164.7 KB

List videos

get/rest/videos

Query parameters

fieldsstring
<p>List of fields to return.</p><p>To add several fields, separate each value with a comma (i.e. <code>title,description</code>)</p><p><p><b>Sample of possible values:</b> <code>title</code> <code>description</code> <code>id</code> <code>channel</code> <code>content_provider_id</code> <code>country</code> <code>created_time</code> <code>duration</code> <code>embed_html</code> <code>embed_url</code> <code>geoblocking</code> <code>is_created_for_kids</code> <code>language</code> <code>mode</code> <code>private</code> <code>private_id</code> <code>publish_date</code> <code>published</code> <code>url</code></p><p>See the <a href="https://developers.dailymotion.com/reference/video-fields/">exhaustive list of possible values and their description</a>.
availabilityboolean

Limit the result set to available videos.

channelstring
<p>Limit the result set to this category.</p><p><b>Sample values:</b> <code>news</code> <code>auto</code> <code>animals</code><p><a href="https://developers.dailymotion.com/reference/video-categories/">See all video categories</a>.</p>
countrystring

Limit the result set to this country (declarative, may be null). Allowed values are ISO 3166-1 alpha-2 country codes.

created_afterstring

Limit the result set to videos created after this date and time.

created_beforestring

Limit the result set to videos created before this date and time.

exclude_channel_idsstring
<p>List of <a href="https://developers.dailymotion.com/reference/video-categories/">categories</a> to exclude from the result set.</p><p><b>Sample values:</b> <code>news</code> <code>auto</code> <code>animals</code>
exclude_idsstring

List of video ids to exclude from the result set.

explicitboolean

Limit the result set to the provided explicit value for videos.

exportableboolean

Limit the result set to exportable (i.e: no-export flag not set) videos

featuredboolean

Limit the result set to featured videos.

flagsstring
<p>List of simple boolean flags available to reduce the result set.</p><p><a href="https://developers.dailymotion.com/reference/video-filters#flags">See allowed values.</a></p>
has_gameboolean

Limit the result set to videos related to a video-game.

hdboolean

Limit the result set to high definition videos (vertical resolution greater than or equal to 720p).

idsstring

Limit the result set to this list of video identifiers (works only with xIDs).

in_historyboolean

Limit the result set to videos in your watch history.

is_created_for_kidsboolean

Limit the result set to the provided is_created_for_kids value for videos.

languagesboolean
<p>Limit the result set to this list of languages.<br>Min length: 1<br>Max length: 150</p><p><b>Sample value:</b> <code>[fr,en,it]</code></p>
liststring
<p>Limit the result set to this video list.<br>Warning: Can not be combined with a <a href="https://developers.dailymotion.com/reference/video-filters#search">search</a>.</p><p><b>Allowed values:</b> <code>what-to-watch</code> or <code>recommended</code></p>
liveboolean

Limit the result set to live streaming videos.

live_offairboolean

Limit the result set to off-air live streaming videos.

live_onairboolean

Limit the result set to on-air live streaming videos.

live_upcomingboolean

Limit the result set to upcoming live streaming videos.

longer_thannumber
<p>Limit the results to videos with a duration longer than or equal to the specified number of minutes.<br>Min value: 0</p>
modestring
<p>Limit the result set to videos of this mode.</p><p><b>Allowed values:</b> <code>vod</code> or <code>live</code></p>
no_liveboolean

Limit the result set to non-live streaming videos.

no_live_recordingboolean

Limit the result set to live recording videos.

no_premiumboolean

Limit the result set to free video content.

nogenrestring
<p>Limit the result set by excluding this genre.<br>Min length: 1<br>Max length: 150</p>
ownersstring
<p>Limit the result set to this list of user identifiers or logins.<br>Min length: 1<br>Max length: 150</p>
partnerboolean

Limit the result set to partner videos.

password_protectedboolean

Limit the result set to password protected partner videos.

premiumboolean

Limit the result set to premium SVOD and TVOD video content.

privateboolean

Limit the result set to private videos.

related_videos_algorithmstring
<p>Forces the recommendation result to use a specific algorithm.<br>Min length: 1<br>Max length: 150</p><p><b>Allowed values:</b> <code>uploader-only</code>, <code>uploader-with-siblings</code>, <code>uploader-with-parent</code> or <code>uploader-with-children</code></p>
searchstring
<p>Limit the result set to this full text search.<br>Min length: 1<br>Max length: 150</p>
shorter_thannumber
<p>Limit the results to videos with a duration shorter than or equal to the specified number of minutes.<br>Min length: 0</p>
sortstring
<p>Change the default result set ordering.</p><p><b>Allowed values:</b> <code>recent</code>, <code>visited</code>, <code>visited-hour</code>, <code>visited-today</code>, <code>visited-week</code>, <code>visited-month</code>, <code>relevance</code>, <code>random</code>, <code>trending</code>, <code>old</code>, <code>live-audience</code>, <code>least-visited</code>, <code>live-airing-time</code> or <code>id-asc</code></p>
timeframenumber
<p>Limit the result set to videos created after this N last seconds.<br>Min value: 0</p>
ugcboolean

Limit the result set to user generated video content (no partner content).

ugc_partnerboolean

Limit the result set to user generated or partner video content.

unpublishedboolean

Limit the result set to unpublished videos.

verifiedboolean

Limit the result set to verified partner videos.

limitnumber
<p>Limits the number of results per page.<br>Max: 100</p>
pagenumber
<p>The page number to load. Allows to navigate from one page to the other when the results are on several pages.<br>Max: 10 if <code>limit=100</code><br>Depends if <code>has_more</code> at the top of the page is <code>true</code> or <code>false</code></p>