Platform API Reference

Channel

A channel object represents a category of videos on Dailymotion (formerly a channel), for example: shortfilms, videogames, news, etc. (See full list below)

Manipulating channels

To retrieve a specific channel object, perform a GET request on /channel/<CHANNEL_ID>. By default, only a small number of fields marked as default are returned (such as the object identifier), please refer to the complete field list below. For help on requesting specific fields, see the fields selection section.

To retrieve a list of channel objects, perform a GET request on /channels. You can then use filters (if any) to filter down the result set, see the filtering section for more information.

Sample channel API call: /channel/music
Test it further with the API Explorer.

Channel fields

Here is the list of fields you can retrieve on every channel object. You can retrieve these using the fields query-string parameter on any graph object request. See the fields selection section for more information.

DATE

created_time

Date and time when this channel was created.

public readable

Sample value: 1287507036

Date and time when this channel was created.

STRING

description

Comprehensive localized description of this channel.

public readable default minlength: 1 maxlength: 150

Sample value: Everything about video-games!

Comprehensive localized description of this channel.

IDENTIFIER

id

Unique object identifier (unique among all channels)

public readable default

Sample value: xga6gkn

Unique object identifier (unique among all channels)

STRING

item_type

Graph type of this object (hopefully channel)

public readable minlength: 1 maxlength: 150

Sample value: channel

Graph type of this object (hopefully channel)

STRING

name

Localized short name of this channel.

public readable default minlength: 1 maxlength: 150

Sample value: Video Games

Localized short name of this channel.

STRING

slug

Slug name of this channel.

public readable minlength: 1 maxlength: 150

Sample value: video-games

Slug name of this channel.

DATE

updated_time

Date and time when this channel was last updated.

public readable

Sample value: 1404129540

Date and time when this channel was last updated.

Channel filters

Here is the list of filters you can use to limit a result set of channel objects. You can use these by passing them as query-string parameters with your request.

sort

Change the default result set ordering.

STRING allowed values: popular or alpha

Sample value: popular

Change the default result set ordering.

Channel deprecated filters

These deprecated filters were once part of the API reference but are no longer maintained. Support is still available until the end of life date specified for each filter. Do not use any of these for a new project as they may disappear without warning.

language

Language in which you want this channel name and description fields to be.

This filter was deprecated on December 28th, 2011.

Use the localization global parameter instead.

End of support: December 28th, 2014.

STRING

Sample value: it

Language in which you want this channel name and description fields to be.

Channel connections

Connections through the data API are used to link objects with each others. Some objects can only be accessed and/or created through connections since they have no point in existing on their own. Here is the list of connections available through the channel object.

[User]

users

List of the top users of this channel.
This connection joins an object of type channel with a list of user objects.

public readable

List of the top users of this channel.
This connection joins an object of type channel with a list of user objects.

Read the channel's users connection

You can retrieve the list of users connected to a channel object by issuing a GET request to /channel/<CHANNEL_ID>/users. You can specify the list of fields from the user objects to be returned using the fields parameter.
Test it with the API Explorer.

[Video]

videos

List of videos of this channel.
This connection joins an object of type channel with a list of video objects.

public readable

List of videos of this channel.
This connection joins an object of type channel with a list of video objects.

Read the channel's videos connection

You can retrieve the list of videos connected to a channel object by issuing a GET request to /channel/<CHANNEL_ID>/videos. You can specify the list of fields from the video objects to be returned using the fields parameter.
Test it with the API Explorer.

Player

A player object holds several configuration properties (Picture In Picture settings, aspect ratio…) and is meant to be embedded on a webpage with a script tag.

Manipulating players

To retrieve a specific player object, perform a GET request on /player/<PLAYER_ID>. By default, only a small number of fields marked as default are returned (such as the object identifier), please refer to the complete field list below. For help on requesting specific fields, see the fields selection section.

To create an object of type player, perform a POST request on the connection available through the user graph object. Join all the fields you want to specify and their value as an application/x-www-form-urlencoded payload. Please note that, for creation, some fields and/or specific query-string parameters could be mandatory, please refer to the field list below.

To edit an object of type player, perform a POST request on /player/<PLAYER_ID>. Join all the fields you want to update and their new value as an application/x-www-form-urlencoded payload.

To delete an object of type player, perform a DELETE request on /player/<PLAYER_ID>. If you do not receive any error (empty result set), it means that the deletion was successful.

Sample player API call: /player/xid1
Test it further with the API Explorer.

Player fields

Here is the list of fields you can retrieve on every player object. You can retrieve these using the fields query-string parameter on any graph object request. See the fields selection section for more information.

STRING

ad_pressure_optimization

Optimize ad pressure based on selected model: monetization, balanced, standard

public readable writable minlength: 1 maxlength: 150 allowed values: monetization, balanced or standard

Sample value: standard

Optimize ad pressure based on selected model: monetization, balanced, standard

STRING

aspect_ratio

To specify the aspect ratio of the player

public readable writable minlength: 1 maxlength: 150 allowed values: inherit, 16:9, 4:3, 1:1, 3:4 or 9:16

Sample value: 16:9

To specify the aspect ratio of the player

NUMBER

autoskip_after

After how many seconds the video is skipped (min: 10)

public readable writable minlength: 0

Sample value: 10

After how many seconds the video is skipped (min: 10)

STRING

autostart

To control how the player handles autoplay

public readable writable minlength: 1 maxlength: 150 allowed values: on, off or firstTimeViewable

Sample value: off

To control how the player handles autoplay

STRING

color

Change the default highlight color used in the controls

public readable writable minlength: 1 maxlength: 150

Sample value: 00aaff

Change the default highlight color used in the controls

NUMBER

contextual_content_freshness

Define the freshness of the content (in days) that can be selected by the contextual embed feature

public readable writable minlength: 0

Sample value: 1800

Define the freshness of the content (in days) that can be selected by the contextual embed feature

STRING

contextual_content_source

Define if your contextual content should be taken from your organization, your channel or Dailymotion’s global catalog

public readable writable minlength: 1 maxlength: 150 allowed values: channel, organization or dailymotion

Sample value: channel

Define if your contextual content should be taken from your organization, your channel or Dailymotion’s global catalog

DATE

created_time

Date and time when this player was created

public readable

Sample value: 1287507036

Date and time when this player was created

URL

embed_html_url

URL of the player HTML embed

public readable default

Sample value: https://geo.dailymotion.com/player/x123.html

URL of the player HTML embed

URL

embed_script_url

URL of the player to be used in a script HTML tag

public readable default

Sample value: https://geo.dailymotion.com/player/x123.js

URL of the player to be used in a script HTML tag

BOOLEAN

enable_ads

Whether to enable ads and associated tracking

public readable writable

Sample value: false

Whether to enable ads and associated tracking

BOOLEAN

enable_ads_controls

Whether to display the player controls during an ad

public readable writable

Sample value: false

Whether to display the player controls during an ad

BOOLEAN

enable_attention_peaks

Whether to display attention peaks above seekbar

public readable writable

Sample value: false

Whether to display attention peaks above seekbar

BOOLEAN

enable_automatic_recommendations

Whether to enable automatic recommendations

public readable writable

Sample value: false

Whether to enable automatic recommendations

BOOLEAN

enable_autonext

Whether to automatically play the next video item

public readable writable

Sample value: false

Whether to automatically play the next video item

BOOLEAN

enable_autoskip

Whether to activate the "Auto skip" feature

public readable writable

Sample value: false

Whether to activate the "Auto skip" feature

BOOLEAN

enable_channel_link

Whether to activate the link on the channel owner text

public readable writable

Sample value: false

Whether to activate the link on the channel owner text

BOOLEAN

enable_click_to_unmute

Whether to enable the click to unmute feature

public readable writable

Sample value: false

Whether to enable the click to unmute feature

BOOLEAN

enable_contextual_content

Whether to load relevant content based on contextual information from the embedder page

public readable writable

Sample value: false

Whether to load relevant content based on contextual information from the embedder page

BOOLEAN

enable_contextual_content_fallback

Whether to allow the contextual embed feature to play less relevant videos from your channel or other sources, to avoid displaying an empty player when content with high relevancy is not available

public readable writable

Sample value: false

Whether to allow the contextual embed feature to play less relevant videos from your channel or other sources, to avoid displaying an empty player when content with high relevancy is not available

BOOLEAN

enable_contextual_content_freshness

Whether to activate the "Contextual content freshness" feature

public readable writable

Sample value: false

Whether to activate the "Contextual content freshness" feature

BOOLEAN

enable_custom_recommendations

Whether to enable custom recommendations

public readable writable

Sample value: false

Whether to enable custom recommendations

BOOLEAN

enable_dm_logo

Whether to display the Dailymotion logo

public readable writable

Sample value: false

Whether to display the Dailymotion logo

BOOLEAN

enable_dynamic_thumbnail

Whether to display animated video preview instead of a static thumbnail

public readable writable

Sample value: false

Whether to display animated video preview instead of a static thumbnail

BOOLEAN

enable_eco_mode

Whether to enable Eco Mode to apply a quality limit

public readable writable

Sample value: false

Whether to enable Eco Mode to apply a quality limit

BOOLEAN

enable_google_policy_ui

Whether to activate the UI to be Google policy compliant (e.g.: PIP close button outside Player UI)

public readable writable

Sample value: false

Whether to activate the UI to be Google policy compliant (e.g.: PIP close button outside Player UI)

BOOLEAN

enable_info

Whether to display the video title and owner information

public readable writable

Sample value: false

Whether to display the video title and owner information

BOOLEAN

enable_keyboard_shortcuts

Whether to enable the keyboard shortcuts

public readable writable

Sample value: false

Whether to enable the keyboard shortcuts

BOOLEAN

enable_legacy_pip

When enabled, player displays the legacy PiP version

public readable writable

Sample value: false

When enabled, player displays the legacy PiP version

BOOLEAN

enable_live_offair_screen

Whether to display streaming status before and after live streaming

public readable writable

Sample value: false

Whether to display streaming status before and after live streaming

BOOLEAN

enable_paid_partnership_label

Whether to enable the paid partnership label (if the playing video is flagged as such)

public readable writable

Sample value: false

Whether to enable the paid partnership label (if the playing video is flagged as such)

BOOLEAN

enable_pip_placement

Whether to choose the webpage corner where PiP is initialized. If used, overwrites PiP CSS customization

public readable writable

Sample value: false

Whether to choose the webpage corner where PiP is initialized. If used, overwrites PiP CSS customization

BOOLEAN

enable_playback_controls

Whether to display the player controls during a video

public readable writable

Sample value: false

Whether to display the player controls during a video

BOOLEAN

enable_receive_url_location

Allow player to receive full page URL where player is embedded

public readable writable

Sample value: false

Allow player to receive full page URL where player is embedded

BOOLEAN

enable_sharing

Whether to enable the sharing button

public readable writable

Sample value: false

Whether to enable the sharing button

BOOLEAN

enable_sharing_url_location

Whether to share the location where the video is embedded (video URL by default)

public readable writable

Sample value: false

Whether to share the location where the video is embedded (video URL by default)

BOOLEAN

enable_spinner

Whether to display spinner during video loading

public readable writable

Sample value: false

Whether to display spinner during video loading

BOOLEAN

enable_start_pip_expanded

Whether to start PiP in expanded mode on mobile (if legacy PiP is enabled)

public readable writable

Sample value: false

Whether to start PiP in expanded mode on mobile (if legacy PiP is enabled)

BOOLEAN

enable_startscreen_dm_link

Whether to show the "Watch on Dailymotion" link on the startscreen

public readable writable

Sample value: false

Whether to show the "Watch on Dailymotion" link on the startscreen

BOOLEAN

enable_subtitles

Whether to activate the subtitles in the player

public readable writable

Sample value: false

Whether to activate the subtitles in the player

BOOLEAN

enable_tap_to_unmute

Whether to enable the tap to unmute feature

public readable writable

Sample value: false

Whether to enable the tap to unmute feature

BOOLEAN

enable_titles_in_video_cards

Whether to show the videos titles in the carousel on the endscreen

public readable writable

Sample value: false

Whether to show the videos titles in the carousel on the endscreen

BOOLEAN

enable_video_title_link

Whether to activate the link on the video title text

public readable writable

Sample value: false

Whether to activate the link on the video title text

BOOLEAN

enable_wait_for_custom_config

Whether to configure the player to wait for the custom config object before starting playback

public readable writable

Sample value: false

Whether to configure the player to wait for the custom config object before starting playback

BOOLEAN

enable_watch_now_card

Whether to display one video card after playback

public readable writable

Sample value: false

Whether to display one video card after playback

BOOLEAN

has_reached_playback_limits

Whether the organization that owns the player has reached some limits (bandwidth, plays)

public readable

Sample value: false

Whether the organization that owns the player has reached some limits (bandwidth, plays)

BOOLEAN

has_recommendations_from_org_only

Whether the organization that owns the player includes only videos from this organization in recommendations

public readable

Sample value: false

Whether the organization that owns the player includes only videos from this organization in recommendations

BOOLEAN

has_ssai

Whether the organization that owns the player has SSAI enabled

public readable

Sample value: false

Whether the organization that owns the player has SSAI enabled

IDENTIFIER

id

Unique object identifier (unique among all players)

public readable default

Sample value: xnrx15d

Unique object identifier (unique among all players)

STRING

item_type

Graph type of this object (hopefully player)

public readable minlength: 1 maxlength: 150

Sample value: player

Graph type of this object (hopefully player)

STRING

label

Mandatory player label

public readable writable minlength: 1 maxlength: 255

Sample value: string example

Mandatory player label

URL

lib_script_url

URL of the player embed library to be used in a script HTML tag

public readable default

Sample value: https://geo.dailymotion.com/libs/player/x123.js

URL of the player embed library to be used in a script HTML tag

User

owner

Owner of this player. You can retrieve sub-fields of this user object using the dot-notation (e.g.: owner.id).

public readable

Sample value: xjqkxae

Owner of this player. You can retrieve sub-fields of this user object using the dot-notation (e.g.: owner.id).

STRING

pip

Picture-in-Picture mode

public readable writable minlength: 1 maxlength: 150 allowed values: instant, on or off

Sample value: on

Picture-in-Picture mode

STRING

pip_selected_placement

Define the webpage corner where PiP is initialized

public readable writable minlength: 1 maxlength: 150 allowed values: bottom_right, bottom_left, top_right or top_left

Sample value: bottom_right

Define the webpage corner where PiP is initialized

STRING

recommendations_optimisation

Optimise recommendations based on selected model: monetization, engagement, views

public readable writable minlength: 1 maxlength: 150 allowed values: views, engagement or monetization

Sample value: monetization

Optimise recommendations based on selected model: monetization, engagement, views

DATE

updated_time

Date and time when this player was updated

public readable

Sample value: 1287507036

Date and time when this player was updated

NUMBER

wait_for_custom_config_delay

How long to wait before the ad request is made (min: 1s – max: 10s), when enable_wait_for_custom_config is enabled

public readable writable minlength: 1 maxlength: 10

Sample value: 5

How long to wait before the ad request is made (min: 1s – max: 10s), when enable_wait_for_custom_config is enabled

STRING

watermark_image_type

Image type of the watermark

public readable writable minlength: 1 maxlength: 150 allowed values: none, from_channel or custom

Sample value: from_channel

Image type of the watermark

STRING

watermark_link_type

Type of watermark link

public readable writable minlength: 1 maxlength: 150 allowed values: none, from_channel or custom

Sample value: from_channel

Type of watermark link

URL

watermark_link_url

URL of the watermark link

public readable writable

Sample value: https://www.dailymotion.com

URL of the watermark link

Player deprecated fields

These deprecated fields were once part of the API reference but are no longer maintained. Support is still available until the end of life date specified for each field. Do not use any of these for a new project as they may disappear without warning.

BOOLEAN

enable_controls

Whether to display the player controls

This field was deprecated on October 16th, 2022.

Controls has been renamed Playback Controls.

End of support: January 16th, 2023.

public readable writable

Sample value: false

Whether to display the player controls

BOOLEAN

enable_queue

Whether to enable automatic recommendations

This field was deprecated on September 19th, 2022.

Queue has been renamed Automatic recommendations.

End of support: December 19th, 2022.

public readable writable

Sample value: false

Whether to enable automatic recommendations

Player filters

Here is the list of filters you can use to limit a result set of player objects. You can use these by passing them as query-string parameters with your request.

is_active

Limit the result set to players that are not deleted.

flag

Sample value: n/a

Limit the result set to players that are not deleted.

search

Limit the result set to this full text search.

STRING minlength: 1 maxlength: 150

Sample value: myplayer

Limit the result set to this full text search.

Playlist

A playlist object represents an ordered list of videos created by a user. Videos in a playlist do not necessarily have anything in common.

Manipulating playlists

To retrieve a specific playlist object, perform a GET request on /playlist/<PLAYLIST_ID>. By default, only a small number of fields marked as default are returned (such as the object identifier), please refer to the complete field list below. For help on requesting specific fields, see the fields selection section.

To retrieve a list of playlist objects, perform a GET request on /playlists. You can then use filters (if any) to filter down the result set, see the filtering section for more information.

To create an object of type playlist, perform a POST request on Join all the fields you want to specify and their value as an application/x-www-form-urlencoded payload. Please note that, for creation, some fields and/or specific query-string parameters could be mandatory, please refer to the field list below.

To edit an object of type playlist, perform a POST request on /playlist/<PLAYLIST_ID>. Join all the fields you want to update and their new value as an application/x-www-form-urlencoded payload.

To delete an object of type playlist, perform a DELETE request on /playlist/<PLAYLIST_ID>. If you do not receive any error (empty result set), it means that the deletion was successful.

Sample playlist API call: /playlist/x3ecgj
Test it further with the API Explorer.

Playlist fields

Here is the list of fields you can retrieve on every playlist object. You can retrieve these using the fields query-string parameter on any graph object request. See the fields selection section for more information.

DATE

created_time

Date and time when this playlist was created.

public readable

Sample value: 1287507036

Date and time when this playlist was created.

STRING

description

Comprehensive description of this playlist.

public readable writable minlength: 1 maxlength: 2000

Sample value: Check out the top 10 best goals of this year's championship!

Comprehensive description of this playlist.

IDENTIFIER

id

Unique object identifier (unique among all playlists)

public readable default

Sample value: xeff463

Unique object identifier (unique among all playlists)

STRING

item_type

Graph type of this object (hopefully playlist)

public readable minlength: 1 maxlength: 150

Sample value: playlist

Graph type of this object (hopefully playlist)

STRING

name

Short descriptive name of this playlist.

public readable writable default minlength: 1 maxlength: 50

Sample value: Best goals of the championship

Short descriptive name of this playlist.

User

owner

Author of this playlist. You can retrieve sub-fields of this user object using the dot-notation (e.g.: owner.id).

public readable default

Sample value: xkpgsoa

Author of this playlist. You can retrieve sub-fields of this user object using the dot-notation (e.g.: owner.id).

BOOLEAN

private

True if this playlist is private.

public readable writable

Sample value: true

True if this playlist is private.

URL

thumbnail_60_url

URL of this playlist’s first video thumbnail image (60px height).

public readable

Sample value: https://s2.dmcdn.net/3CQ3/x60-epG.jpg

URL of this playlist’s first video thumbnail image (60px height).

URL

thumbnail_120_url

URL of this playlist’s first video’s thumbnail image (120px height).

public readable

Sample value: https://s2.dmcdn.net/3CQ3/x120-lbT.jpg

URL of this playlist’s first video’s thumbnail image (120px height).

URL

thumbnail_180_url

URL of this playlist’s first video’s thumbnail image (180px height).

public readable

Sample value: https://s2.dmcdn.net/3CQ3/x180-Pe8.jpg

URL of this playlist’s first video’s thumbnail image (180px height).

URL

thumbnail_240_url

URL of this playlist’s first video’s thumbnail image (240px height).

public readable

Sample value: https://s2.dmcdn.net/3CQ3/x240-bP7.jpg

URL of this playlist’s first video’s thumbnail image (240px height).

URL

thumbnail_360_url

URL of this playlist’s first video’s thumbnail image (360px height).

public readable

Sample value: https://s2.dmcdn.net/3CQ3/x360-AdG.jpg

URL of this playlist’s first video’s thumbnail image (360px height).

URL

thumbnail_480_url

URL of this playlist’s first video’s thumbnail image (480px height).

public readable

Sample value: https://s2.dmcdn.net/3CQ3/x480-kEp.jpg

URL of this playlist’s first video’s thumbnail image (480px height).

URL

thumbnail_720_url

URL of this playlist’s first video’s thumbnail image (720px height).

public readable

Sample value: https://s2.dmcdn.net/3CQ3/x720-LZe.jpg

URL of this playlist’s first video’s thumbnail image (720px height).

URL

thumbnail_1080_url

URL of this playlist’s first video’s thumbnail image (1080px height).

public readable

Sample value: https://s2.dmcdn.net/CTrg1/x1080-Ec7.jpg

URL of this playlist’s first video’s thumbnail image (1080px height).

URL

thumbnail_url

URL of the thumbnail of this playlist’s first video (raw, respecting full size ratio).

public readable

Sample value: https://s1.dmcdn.net/3CQ3.jpg

URL of the thumbnail of this playlist’s first video (raw, respecting full size ratio).

DATE

updated_time

Date and time when this playlist was last updated.

public readable

Sample value: 1404129540

Date and time when this playlist was last updated.

NUMBER

videos_total

Total amount of videos in this playlist.

public readable minlength: 0

Sample value: 14

Total amount of videos in this playlist.

Playlist deprecated fields

These deprecated fields were once part of the API reference but are no longer maintained. Support is still available until the end of life date specified for each field. Do not use any of these for a new project as they may disappear without warning.

STRING

relative_updated_time

Localized date and time when this playlist was last updated (formatted).

This field was deprecated on November 23rd, 2014.

Use the updated_time field and format the result client-side instead.

End of support: November 23rd, 2015.

public readable

Sample value: 42 minutes ago

Localized date and time when this playlist was last updated (formatted).

URL

thumbnail_large_url

URL of the thumbnail of this playlist’s first video (320px by 240px).

This field was deprecated on July 30th, 2014.

Use the thumbnail_360_url field instead.

End of support: July 30th, 2015.

public readable

Sample value: https://s2.dmcdn.net/3CQ3/x240-bP7.jpg

URL of the thumbnail of this playlist’s first video (320px by 240px).

URL

thumbnail_medium_url

URL of the thumbnail of this playlist’s first video (160px by 120px).

This field was deprecated on July 30th, 2014.

Use the thumbnail_240_url field instead.

End of support: July 30th, 2015.

public readable

Sample value: https://s2.dmcdn.net/3CQ3/160x120-9HK.jpg

URL of the thumbnail of this playlist’s first video (160px by 120px).

URL

thumbnail_small_url

URL of the thumbnail of this playlist’s first video (80px by 60px).

This field was deprecated on July 30th, 2014.

Use the thumbnail_60_url field instead.

End of support: July 30th, 2015.

public readable

Sample value: https://s2.dmcdn.net/3CQ3/80x60-LKd.jpg

URL of the thumbnail of this playlist’s first video (80px by 60px).

Playlist filters

Here is the list of filters you can use to limit a result set of playlist objects. You can use these by passing them as query-string parameters with your request.

ids

Limit the result set to this list of playlist identifiers (works only with xids).

ARRAY minlength: 1 maxlength: 150

Sample value: xk2k3, x26m1j4, xkeg4

Limit the result set to this list of playlist identifiers (works only with xids).

owner

Limit the result set to playlists of this user.

OBJECT

Sample value: xkpgsoa

Limit the result set to playlists of this user.

private

Limit the result set to private playlists

BOOLEAN

Sample value: true

Limit the result set to private playlists

search

Limit the result set to this full text search.

STRING minlength: 1 maxlength: 150

Sample value: football

Limit the result set to this full text search.

sort

Change the default result set ordering.

STRING allowed values: recent, relevance, alpha, most, least, alphaaz, alphaza or changed

Sample value: relevance

Change the default result set ordering.

verified

Limit the result set to verified partner playlists.

flag

Sample value: n/a

Limit the result set to verified partner playlists.

Playlist connections

Connections through the data API are used to link objects with each others. Some objects can only be accessed and/or created through connections since they have no point in existing on their own. Here is the list of connections available through the playlist object.

[Video]

videos

List of videos contained in this playlist (in the order defined by its owner).
This connection joins an object of type playlist with a list of video objects.

public readable writable

List of videos contained in this playlist (in the order defined by its owner).
This connection joins an object of type playlist with a list of video objects.

Read the playlist's videos connection

You can retrieve the list of videos connected to a playlist object by issuing a GET request to /playlist/<PLAYLIST_ID>/videos. You can specify the list of fields from the video objects to be returned using the fields parameter.
Test it with the API Explorer.

You can also see if any video is connected to an existing playlist object by issuing a GET request to /playlist/<PLAYLIST_ID>/videos/<VIDEO_ID>. This will return a list containing only the connected video object or an empty list if it is not connected.

Create a playlist's videos connection

You can connect videos to an existing playlist object one by one by issuing multiple POST requests to /playlist/<PLAYLIST_ID>/videos/<VIDEO_ID>.

You can connect multiple videos to an existing playlist object at once by issuing one POST request to /playlist/<PLAYLIST_ID>/videos?ids=<VIDEO_ID>,...,<VIDEO_ID>. Note that the order of the identifiers is saved.

Delete a playlist's videos connection

You can disconnect videos from a playlist object by issuing DELETE requests to /playlist/<PLAYLIST_ID>/videos/<VIDEO_ID>. You can also disconnect all videos at once by issuing a POST request to /playlist/<PLAYLIST_ID>/videos with an empty ids query-string parameter.
Test it with the API Explorer.

Subtitle

A subtitle object represents a file resource containing closed captioning for a given video.

Manipulating subtitles

To retrieve a specific subtitle object, perform a GET request on /subtitle/<SUBTITLE_ID>. By default, only a small number of fields marked as default are returned (such as the object identifier), please refer to the complete field list below. For help on requesting specific fields, see the fields selection section.

To create an object of type subtitle, perform a POST request on the connection available through the video graph object. Join all the fields you want to specify and their value as an application/x-www-form-urlencoded payload. Please note that, for creation, some fields and/or specific query-string parameters could be mandatory, please refer to the field list below.

To delete an object of type subtitle, perform a DELETE request on /subtitle/<SUBTITLE_ID>. If you do not receive any error (empty result set), it means that the deletion was successful.

Sample subtitle API call: /video/x26m1j4/subtitles
Test it further with the API Explorer.

Subtitle fields

Here is the list of fields you can retrieve on every subtitle object. You can retrieve these using the fields query-string parameter on any graph object request. See the fields selection section for more information.

STRING

format

Data format SRT only is supported, if you have an other format please convert it to SRT.

private create-only allowed values: SRT

Sample value: SRT

Data format SRT only is supported, if you have an other format please convert it to SRT.

IDENTIFIER

id

Unique object identifier (unique among all subtitles)

public readable default

Sample value: xqf5vs9

Unique object identifier (unique among all subtitles)

STRING

item_type

Graph type of this object (hopefully subtitle)

public readable minlength: 1 maxlength: 150

Sample value: subtitle

Graph type of this object (hopefully subtitle)

STRING

language

Language of these subtitles.

public readable for creation default minlength: 1 maxlength: 150

Sample value: en

Language of these subtitles.

STRING

language_label

Subtitles’s language in its own language.

public readable minlength: 1 maxlength: 150

Sample value: Français

Subtitles’s language in its own language.

URL

url

On GET, the URL pointing to the latest version of the subtitles. On POST, URL pointing to the subtitle data in on of the valid formats. You don’t need to host the file, you can use the GET /file/upload API ressource to create a temporary URL to a file of your own, just like when you upload a video source file. If you host your own file, the file will be fetched and the subtitles URL will point to a local copy.

public readable for creation

Sample value: https://static2.dmcdn.net/static/video/354/170/120453:subtitle_en.srt?22

On GET, the URL pointing to the latest version of the subtitles. On POST, URL pointing to the subtitle data in on of the valid formats. You don’t need to host the file, you can use the GET /file/upload API ressource to create a temporary URL to a file of your own, just like when you upload a video source file. If you host your own file, the file will be fetched and the subtitles URL will point to a local copy.

Subtitle filters

Here is the list of filters you can use to limit a result set of subtitle objects. You can use these by passing them as query-string parameters with your request.

language

Limit the result set to subtitles of this language.

STRING minlength: 1 maxlength: 150

Sample value: en

Limit the result set to subtitles of this language.

User

A user object represents a Dailymotion user account. Users are at the foundation of every other graph objects, since most of them are created through —or owned by— users. Users also represent the main authentication vector to Dailymotion services.

Manipulating users

To retrieve a specific user object, perform a GET request on /user/<USER_ID>. By default, only a small number of fields marked as default are returned (such as the object identifier), please refer to the complete field list below. For help on requesting specific fields, see the fields selection section.

To retrieve a list of user objects, perform a GET request on /users. You can also use one of the several connections available through the channel and user graph objects. You can then use filters (if any) to filter down the result set, see the filtering section for more information.

To edit an object of type user, perform a POST request on /user/<USER_ID>. Join all the fields you want to update and their new value as an application/x-www-form-urlencoded payload.

To delete an object of type user, perform a DELETE request on /user/<USER_ID>. If you do not receive any error (empty result set), it means that the deletion was successful.

Sample user API call: /user/x1fz4ii
Test it further with the API Explorer.

User fields

Here is the list of fields you can retrieve on every user object. You can retrieve these using the fields query-string parameter on any graph object request. See the fields selection section for more information.

STRING

active

Force user account active.

public readable allowed values: y or n

Sample value: y

Force user account active.

STRING

address

Postal address of this user.

private readable read scopes: userinfo writable write scopes: userinfo minlength: 1 maxlength: 150

Sample value: 715 5th Avenue

Postal address of this user.

BOOLEAN

advanced_statistics

advanced-statistics criteria of this user.

Partner

private readable read roles: user-manager writable write roles: user-manager

Sample value: false

advanced-statistics criteria of this user.

URL

avatar_25_url

URL of this user’s avatar image (25px wide square).

public readable

Sample value: https://s1.dmcdn.net/AVM/25x25--w1.png

URL of this user’s avatar image (25px wide square).

URL

avatar_60_url

URL of this user’s avatar image (60px wide square).

public readable

Sample value: https://s1.dmcdn.net/AVM/60x60-As1.png

URL of this user’s avatar image (60px wide square).

URL

avatar_80_url

URL of this user’s avatar image (80px wide square).

public readable

Sample value: https://s1.dmcdn.net/AVM/80x80-Rf1.png

URL of this user’s avatar image (80px wide square).

URL

avatar_120_url

URL of this user’s avatar image (120px wide square).

public readable

Sample value: https://s1.dmcdn.net/AVM/120x120-bn1.png

URL of this user’s avatar image (120px wide square).

URL

avatar_190_url

URL of this user’s avatar image (190px wide square).

public readable

Sample value: https://s1.dmcdn.net/AVM/190x190-ma1.png

URL of this user’s avatar image (190px wide square).

URL

avatar_240_url

URL of this user’s avatar image (240px wide square).

public readable

Sample value: https://s1.dmcdn.net/AVM/240x240-sU1.png

URL of this user’s avatar image (240px wide square).

URL

avatar_360_url

URL of this user’s avatar image (360px wide square).

public readable

Sample value: https://s1.dmcdn.net/AVM/360x360-PM1.png

URL of this user’s avatar image (360px wide square).

URL

avatar_480_url

URL of this user’s avatar image (480px wide square).

public readable

Sample value: https://s1.dmcdn.net/AVM/480x480-CD1.png

URL of this user’s avatar image (480px wide square).

URL

avatar_720_url

URL of this user’s avatar image (720px wide square).

public readable

Sample value: https://s1.dmcdn.net/AVM/720x720-Gr1.png

URL of this user’s avatar image (720px wide square).

URL

avatar_url

URL of an image to change this user’s avatar.

private write-only

Sample value: http://www.example.org

URL of an image to change this user’s avatar.

BOOLEAN

ban_from_partner_program

True if this user has the criteria ban-from-partner-program.

Partner

private readable read roles: user-manager writable write roles: user-manager

Sample value: false

True if this user has the criteria ban-from-partner-program.

DATE

birthday

Birthday date of this user.

private readable read scopes: userinfo writable write scopes: userinfo

Sample value: 532652400

Birthday date of this user.

NUMBER

children_total

Total number of user children.

public readable minlength: 0

Sample value: 10

Total number of user children.

STRING

city

City of residence of this user.

public readable writable write scopes: userinfo minlength: 1 maxlength: 150

Sample value: New York City

City of residence of this user.

STRING

country

Country of residence of this user. Allowed values are ISO 3166-1 alpha-2 country codes.

public readable writable write scopes: userinfo minlength: 1 maxlength: 150

Sample value: US

Country of residence of this user. Allowed values are ISO 3166-1 alpha-2 country codes.

URL

cover_100_url

URL of this user’s cover image (height = 100px).

public readable

Sample value: https://s2.dmcdn.net/GJCWj/x100-qZJ.jpg

URL of this user’s cover image (height = 100px).

URL

cover_150_url

URL of this user’s cover image (height = 150px).

public readable

Sample value: https://s2.dmcdn.net/GJCWj/x150-KrI.jpg

URL of this user’s cover image (height = 150px).

URL

cover_200_url

URL of this user’s cover image (height = 200px).

public readable

Sample value: https://s2.dmcdn.net/GJCWj/x200--y5.jpg

URL of this user’s cover image (height = 200px).

URL

cover_250_url

URL of this user’s cover image (height = 250px).

public readable

Sample value: https://s2.dmcdn.net/GJCWj/x250-u-x.jpg

URL of this user’s cover image (height = 250px).

URL

cover_url

URL of this user’s cover image (original size).

public readable writable

Sample value: http://www.example.org

URL of this user’s cover image (original size).

DATE

created_time

Date and time when this user joined the site.

public readable

Sample value: 1287507036

Date and time when this user joined the site.

STRING

description

Comprehensive description of this user.

public readable writable minlength: 1 maxlength: 2000

Sample value: Hi, I'm <i>John</i> and I'm here to break <b>everything</b>!

Comprehensive description of this user.

EMAIL

email

Email address of this user.

private readable read scopes: email writable write scopes: email

Sample value: john.doe@provider.com

Email address of this user.

STRING

facebook_url

Facebook profile URL of this user.

public readable writable minlength: 1 maxlength: 400

Sample value: https://www.facebook.com/johndoe424

Facebook profile URL of this user.

STRING

first_name

First name of this user.

private readable read scopes: userinfo writable write scopes: userinfo minlength: 1 maxlength: 150

Sample value: John

First name of this user.

NUMBER

followers_total

Total amount of followers of this user.

public readable minlength: 0

Sample value: 42

Total amount of followers of this user.

NUMBER

following_total

Total amount of users this user is following.

public readable minlength: 0

Sample value: 42

Total amount of users this user is following.

STRING

fullname

Full name of this user.

private readable read scopes: userinfo writable write scopes: userinfo minlength: 1 maxlength: 50

Sample value: John Doe

Full name of this user.

STRING

gender

Gender of this user.

public readable writable allowed values: male, female, other or prefer-not-to-answer

Sample value: male

Gender of this user.

STRING

googleplus_url

Googleplus profile URL of this user.

public readable writable minlength: 1 maxlength: 150

Sample value: https://plus.google.com/u/0/johndoe424

Googleplus profile URL of this user.

IDENTIFIER

id

Unique object identifier (unique among all users)

public readable default

Sample value: xna9gn9

Unique object identifier (unique among all users)

STRING

instagram_url

Instagram profile URL of this user.

public readable writable minlength: 1 maxlength: 150

Sample value: https://www.instagram.com/johndoe424

Instagram profile URL of this user.

BOOLEAN

is_following

True if the authenticated user is following this user. If no user is authenticated, it will always return false

public readable

Sample value: false

True if the authenticated user is following this user. If no user is authenticated, it will always return false

STRING

item_type

Graph type of this object (hopefully user)

public readable minlength: 1 maxlength: 150

Sample value: user

Graph type of this object (hopefully user)

STRING

language

Language used by this user. Allowed values are ISO-639-3 alpha-2 and alpha-3 language codes.

public readable writable minlength: 1 maxlength: 150

Sample value: en

Language used by this user. Allowed values are ISO-639-3 alpha-2 and alpha-3 language codes.

STRING

last_name

Last name of this user.

private readable read scopes: userinfo writable write scopes: userinfo minlength: 1 maxlength: 150

Sample value: Doe

Last name of this user.

DICT

limits

Returns the various user limits like the maximum allowed duration and size per uploaded video etc. This property can only be obtained for the currently logged in user.

private readable read scopes: userinfo minlength: 1 maxlength: 150

Sample value: {"video_duration":3600,"video_size":2147483648}

Returns the various user limits like the maximum allowed duration and size per uploaded video etc. This property can only be obtained for the currently logged in user.

STRING

linkedin_url

LinkedIn profile URL of this user.

public readable writable minlength: 1 maxlength: 150

Sample value: https://www.linkedin.com/in/johndoe424

LinkedIn profile URL of this user.

User

parent

Identifier of this user’s parent (use parent.screenname to access its user name). You can retrieve sub-fields of this user object using the dot-notation (e.g.: parent.id).

public readable

Sample value: x9tz791

Identifier of this user’s parent (use parent.screenname to access its user name). You can retrieve sub-fields of this user object using the dot-notation (e.g.: parent.id).

BOOLEAN

partner

When the partner field is set, the user auto-accepts the T&Cs (https://www.dailymotion.com/legal/partner) and becomes a partner. Returns True if this user is a partner.

public readable writable

Sample value: false

When the partner field is set, the user auto-accepts the T&Cs (https://www.dailymotion.com/legal/partner) and becomes a partner. Returns True if this user is a partner.

STRING

pinterest_url

Pinterest profile URL of this user.

public readable writable write scopes: userinfo minlength: 1 maxlength: 150

Sample value: https://pinterest.com/dailymotionusa/

Pinterest profile URL of this user.

NUMBER

playlists_total

Total amount of playlists of this user.

public readable minlength: 0

Sample value: 5

Total amount of playlists of this user.

NUMBER

reposts_total

The number of videos reposted by the user.

public readable minlength: 0

Sample value: 5

The number of videos reposted by the user.

NUMBER

revenues_claim_last_day

Total amount of net revenues in USD generated through claim the last day.

private readable read scopes: read_insights minlength: 0

Sample value: 12

Total amount of net revenues in USD generated through claim the last day.

NUMBER

revenues_claim_last_month

Total amount of net revenues in USD generated through claim the last month.

private readable read scopes: read_insights minlength: 0

Sample value: 310.2

Total amount of net revenues in USD generated through claim the last month.

NUMBER

revenues_claim_last_week

Total amount of net revenues in USD generated through claim in the last 7 sliding days.

private readable read scopes: read_insights minlength: 0

Sample value: 80.7

Total amount of net revenues in USD generated through claim in the last 7 sliding days.

NUMBER

revenues_claim_total

Total amount of net revenues in USD generated through claim since the beginning.

private readable read scopes: read_insights minlength: 0

Sample value: 2502.37

Total amount of net revenues in USD generated through claim since the beginning.

NUMBER

revenues_paidcontent_last_day

Total amount of net revenues in USD generated through the paid content the last day.

private readable read scopes: read_insights minlength: 0

Sample value: 12

Total amount of net revenues in USD generated through the paid content the last day.

NUMBER

revenues_paidcontent_last_month

Total amount of net revenues in USD generated through the paid content the last month.

private readable read scopes: read_insights minlength: 0

Sample value: 310.2

Total amount of net revenues in USD generated through the paid content the last month.

NUMBER

revenues_paidcontent_last_week

Total amount of net revenues in USD generated through the paid content in the last 7 sliding days.

private readable read scopes: read_insights minlength: 0

Sample value: 80.7

Total amount of net revenues in USD generated through the paid content in the last 7 sliding days.

NUMBER

revenues_paidcontent_total

Total amount of net revenues in USD generated through the paid content since the beginning.

private readable read scopes: read_insights minlength: 0

Sample value: 2502.37

Total amount of net revenues in USD generated through the paid content since the beginning.

NUMBER

revenues_video_last_day

Total amount of net revenues in USD generated through the video monetization the last day.

private readable read scopes: read_insights minlength: 0

Sample value: 12

Total amount of net revenues in USD generated through the video monetization the last day.

NUMBER

revenues_video_last_month

Total amount of net revenues in USD generated through the video monetization the last month.

private readable read scopes: read_insights minlength: 0

Sample value: 310.2

Total amount of net revenues in USD generated through the video monetization the last month.

NUMBER

revenues_video_last_week

Total amount of net revenues in USD generated through the video monetization in the last 7 sliding days.

private readable read scopes: read_insights minlength: 0

Sample value: 80.7

Total amount of net revenues in USD generated through the video monetization in the last 7 sliding days.

NUMBER

revenues_video_total

Total amount of net revenues in USD generated through the video monetization since the beginning.

private readable read scopes: read_insights minlength: 0

Sample value: 2502.37

Total amount of net revenues in USD generated through the video monetization since the beginning.

NUMBER

revenues_website_last_day

Total amount of net revenues in USD generated through the website monetization the last day.

private readable read scopes: read_insights minlength: 0

Sample value: 12

Total amount of net revenues in USD generated through the website monetization the last day.

NUMBER

revenues_website_last_month

Total amount of net revenues in USD generated through the website monetization the last month.

private readable read scopes: read_insights minlength: 0

Sample value: 310.2

Total amount of net revenues in USD generated through the website monetization the last month.

NUMBER

revenues_website_last_week

Total amount of net revenues in USD generated through the website monetization in the last 7 sliding days.

private readable read scopes: read_insights minlength: 0

Sample value: 80.7

Total amount of net revenues in USD generated through the website monetization in the last 7 sliding days.

NUMBER

revenues_website_total

Total amount of net revenues in USD generated through the website monetization since the beginning.

private readable read scopes: read_insights minlength: 0

Sample value: 2502.37

Total amount of net revenues in USD generated through the website monetization since the beginning.

STRING

screenname

Returns this user’s full name or login depending on the user’s preferences.

public readable writable write scopes: userinfo default minlength: 1 maxlength: 50

Sample value: johndoe424

Returns this user’s full name or login depending on the user’s preferences.

STRING

status

Current user account status.

public readable allowed values: pending-activation, disabled, active or unknown

Sample value: active

Current user account status.

STRING

twitter_url

Twitter profile URL of this user.

public readable writable minlength: 1 maxlength: 150

Sample value: https://twitter.com/johndoe424

Twitter profile URL of this user.

URL

url

URL of this user’s profile on Dailymotion.

public readable

Sample value: https://www.dailymotion.com/johndoe424

URL of this user’s profile on Dailymotion.

STRING

username

User account credentials login.

public readable writable write scopes: userinfo minlength: 1 maxlength: 150

Sample value: johndoe424

User account credentials login.

BOOLEAN

username_update_required

True if this user needs to update his username, False otherwise.

public readable

Sample value: false

True if this user needs to update his username, False otherwise.

BOOLEAN

verified

True if this user is a verified partner.

public readable writable

Sample value: false

True if this user is a verified partner.

NUMBER

videos_total

Total amount of public videos of this user.

public readable minlength: 0

Sample value: 27

Total amount of public videos of this user.

NUMBER

views_total

Total aggregated number of views on all of this user’s videos.

public readable minlength: 0

Sample value: 1239873

Total aggregated number of views on all of this user’s videos.

STRING

website_url

Personal website URL of this user.

public readable writable minlength: 1 maxlength: 150

Sample value: https://www.johndoe424.net

Personal website URL of this user.

User deprecated fields

These deprecated fields were once part of the API reference but are no longer maintained. Support is still available until the end of life date specified for each field. Do not use any of these for a new project as they may disappear without warning.

COMPLEX

analytics_services

Analytics service of this user.

This field was deprecated on July 17th, 2016.

Use the corresponding analytics service analytics_service_estat, analytics_service_xiti, or analytics_service_google field instead.

End of support: January 17th, 2017.

Partner

private readable

Sample value: { "xiti": { "website_id": 1567829778, "subdomain": "www.mysite.com", "second_level_id": 68965678, "internal_domain": "test.com" }, "google": "UA-12345-1", "estat":"123456789" }

Analytics service of this user.

URL

avatar_large_url

URL of this user’s avatar image (160px wide square).

This field was deprecated on September 02nd, 2013.

Use the `avatar_480_url“ field instead.

End of support: September 02nd, 2014.

public readable

Sample value: http://www.example.org

URL of this user’s avatar image (160px wide square).

URL

avatar_medium_url

URL of this user’s avatar image (80px wide square).

This field was deprecated on September 02nd, 2013.

Use the avatar_240_url field instead.

End of support: September 02nd, 2014.

public readable

Sample value: http://www.example.org

URL of this user’s avatar image (80px wide square).

URL

avatar_small_url

URL of this user’s avatar image (40px wide square).

This field was deprecated on September 02nd, 2013.

Use the avatar_60_url field instead.

End of support: September 02nd, 2014.

public readable

Sample value: http://www.example.org

URL of this user’s avatar image (40px wide square).

URL

background_url

URL of this user’s background image (Max 1680px by 2000px).

This field was deprecated on July 20th, 2014.

The custom skin feature has been discontinued.

End of support: July 20th, 2015.

public readable writable

Sample value: http://www.example.org

URL of this user’s background image (Max 1680px by 2000px).

URL

banner_url

URL of this user’s banner image (Max 970px by 120px).

This field was deprecated on July 20th, 2014.

The custom skin feature has been discontinued.

End of support: July 20th, 2015.

public readable writable

Sample value: http://www.example.org

URL of this user’s banner image (Max 970px by 120px).

NUMBER

fans_total

Total amount of fans of this user.

This field was deprecated on February 22nd, 2016.

Use the followers_total field instead.

End of support: August 22nd, 2016.

public readable

Sample value: 42

Total amount of fans of this user.

BOOLEAN

live_notification_followed_onair

True if this user has authorized live notifications, false otherwise.

This field was deprecated on September 27th, 2016.

Use the notification_live_start_streaming field instead.

End of support: September 27th, 2017.

public readable writable

Sample value: false

True if this user has authorized live notifications, false otherwise.

STRING

type

Type of user account.

This field was deprecated on December 04th, 2014.

Use the partner and verified fields instead.

End of support: December 04th, 2015.

public readable writable

Sample value: ugc

Type of user account.

Video

videostar

Showcased video of this user. You can retrieve sub-fields of this video object using the dot-notation (e.g.: videostar.id).

This field was deprecated on November 01st, 2017.

video star feature is discontinued, please use the features connection instead.

End of support: November 01st, 2018.

public readable writable

Sample value: x9tz791

Showcased video of this user. You can retrieve sub-fields of this video object using the dot-notation (e.g.: videostar.id).

User filters

Here is the list of filters you can use to limit a result set of user objects. You can use these by passing them as query-string parameters with your request.

country

Country of residence of this user. Allowed values are ISO 3166-1 alpha-2 country codes.

STRING minlength: 1 maxlength: 150

Sample value: US

Country of residence of this user. Allowed values are ISO 3166-1 alpha-2 country codes.

exclude_ids

List of user ids to exclude from the result set.

ARRAY minlength: 1 maxlength: 150

Sample value: xk2k3, x26m1j4, xkeg4

List of user ids to exclude from the result set.

flags

List of simple boolean flags available to reduce the result set.

ARRAY minlength: 1 maxlength: 150 allowed values: mostpopular, recommended, partner or verified

Sample value: mostpopular, partner

List of simple boolean flags available to reduce the result set.

ids

Limit the result set to this list of user channels identifiers.

ARRAY minlength: 1 maxlength: 150

Sample value: xk2k3, x1fz4ii, xw83x45

Limit the result set to this list of user channels identifiers.

language

Limit the result set to users using this language.

STRING minlength: 1 maxlength: 150

Sample value: en

Limit the result set to users using this language.

mostpopular

Limit the result set to the most popular users.

flag

Sample value: n/a

Limit the result set to the most popular users.

parent

Limit the result set to children of this user.

OBJECT

Sample value: x9tz791

Limit the result set to children of this user.

partner

Limit the result set to partner users.

flag

Sample value: n/a

Limit the result set to partner users.

recommended

Limit the result set to recommended users.

flag

Sample value: n/a

Limit the result set to recommended users.

recommendedforchannel

Limit the result set to this channel’s top users.

STRING minlength: 1 maxlength: 150

Sample value: news

Limit the result set to this channel’s top users.

sort

Change the default result set ordering. Notes:

• Deprecated sorts (recent, daily, weekly, monthly, rated, random, alpha, alphaZA, alphaZAFullname)

STRING allowed values: relevance, popular, activity or recent

Sample value: popular

Change the default result set ordering. Notes:

• Deprecated sorts (recent, daily, weekly, monthly, rated, random, alpha, alphaZA, alphaZAFullname)

usernames

Limit the results set to users with a list of usernames

ARRAY minlength: 1 maxlength: 150

Sample value: rs, spi0n

Limit the results set to users with a list of usernames

verified

Limit the result set to verified partner users.

flag

Sample value: n/a

Limit the result set to verified partner users.

User deprecated filters

These deprecated filters were once part of the API reference but are no longer maintained. Support is still available until the end of life date specified for each filter. Do not use any of these for a new project as they may disappear without warning.

filters

List of simple boolean filters available to reduce the result set.

This filter was deprecated on January 04th, 2015.

The filters shortcut has been deprecated. From now on, if you need to use a simple boolean filter, either use the new flags system or look for an equivalent in the filters list (e.g.: ?filters=featured,creative becomes ?flags=featured,creative or simply ?featured&creative).

End of support: January 04th, 2017.

ARRAY

Sample value: mostpopular

List of simple boolean filters available to reduce the result set.

list

Limit the result set to this user list.

This filter was deprecated on November 01st, 2017.

List filter is deprecated.

End of support: November 01st, 2018.

STRING

Sample value: recommended

Limit the result set to this user list.

search

Limit the result set to this full text search.

This filter was deprecated on November 01st, 2017.

User channel Search feature is deprecated.

End of support: November 01st, 2018.

STRING

Sample value: john

Limit the result set to this full text search.

User connections

Connections through the data API are used to link objects with each others. Some objects can only be accessed and/or created through connections since they have no point in existing on their own. Here is the list of connections available through the user object.

[User]

children

List of this user’s children.
This connection joins an object of type user with a list of user objects.

public readable writable

List of this user’s children.
This connection joins an object of type user with a list of user objects.

Read the user's children connection

You can retrieve the list of children connected to a user object by issuing a GET request to /me/children. You can specify the list of fields from the user objects to be returned using the fields parameter.
Test it with the API Explorer.

You can also see if any user is connected to an existing user object by issuing a GET request to /me/children/<USER_ID>. This will return a list containing only the connected user object or an empty list if it is not connected.

Create a user's children connection

You can connect children to an existing user object one by one by issuing multiple POST requests to /me/children/<USER_ID>.

Delete a user's children connection

You can disconnect children from a user object by issuing DELETE requests to /me/children/<USER_ID>. You can also disconnect all children at once by issuing a POST request to /me/children with an empty ids query-string parameter.
Test it with the API Explorer.

[Video]

features

List of videos featured by this user.
This connection joins an object of type user with a list of video objects.

public readable writable write scopes: manage_features

List of videos featured by this user.
This connection joins an object of type user with a list of video objects.

Read the user's features connection

You can retrieve the list of features connected to a user object by issuing a GET request to /me/features. You can specify the list of fields from the video objects to be returned using the fields parameter.
Test it with the API Explorer.

You can also see if any video is connected to an existing user object by issuing a GET request to /me/features/<VIDEO_ID>. This will return a list containing only the connected video object or an empty list if it is not connected.

Create a user's features connection

You can connect features to an existing user object one by one by issuing multiple POST requests to /me/features/<VIDEO_ID>.

Delete a user's features connection

You can disconnect features from a user object by issuing DELETE requests to /me/features/<VIDEO_ID>. You can also disconnect all features at once by issuing a POST request to /me/features with an empty ids query-string parameter.
Test it with the API Explorer.

[User]

followers

List of this user’s followers.
This connection joins an object of type user with a list of user objects.

public readable

List of this user’s followers.
This connection joins an object of type user with a list of user objects.

Read the user's followers connection

You can retrieve the list of followers connected to a user object by issuing a GET request to /me/followers. You can specify the list of fields from the user objects to be returned using the fields parameter.
Test it with the API Explorer.

[User]

following

List of users followed by this user.
This connection joins an object of type user with a list of user objects.

public readable writable write scopes: manage_subscriptions

List of users followed by this user.
This connection joins an object of type user with a list of user objects.

Read the user's following connection

You can retrieve the list of following connected to a user object by issuing a GET request to /me/following. You can specify the list of fields from the user objects to be returned using the fields parameter.
Test it with the API Explorer.

You can also see if any user is connected to an existing user object by issuing a GET request to /me/following/<USER_ID>. This will return a list containing only the connected user object or an empty list if it is not connected.

Create a user's following connection

You can connect following to an existing user object one by one by issuing multiple POST requests to /me/following/<USER_ID>.

Delete a user's following connection

You can disconnect following from a user object by issuing DELETE requests to /me/following/<USER_ID>. You can also disconnect all following at once by issuing a POST request to /me/following with an empty ids query-string parameter.
Test it with the API Explorer.

[Video]

likes

List of videos liked by the user.
This connection joins an object of type user with a list of video objects.

public readable writable write scopes: manage_likes

List of videos liked by the user.
This connection joins an object of type user with a list of video objects.

Read the user's likes connection

You can retrieve the list of likes connected to a user object by issuing a GET request to /me/likes. You can specify the list of fields from the video objects to be returned using the fields parameter.
Test it with the API Explorer.

You can also see if any video is connected to an existing user object by issuing a GET request to /me/likes/<VIDEO_ID>. This will return a list containing only the connected video object or an empty list if it is not connected.

Create a user's likes connection

You can connect likes to an existing user object one by one by issuing multiple POST requests to /me/likes/<VIDEO_ID>.

Delete a user's likes connection

You can disconnect likes from a user object by issuing DELETE requests to /me/likes/<VIDEO_ID>. You can also disconnect all likes at once by issuing a POST request to /me/likes with an empty ids query-string parameter.
Test it with the API Explorer.

[User]

parents

List of this user’s parents.
This connection joins an object of type user with a list of user objects.

public readable writable

List of this user’s parents.
This connection joins an object of type user with a list of user objects.

Read the user's parents connection

You can retrieve the list of parents connected to a user object by issuing a GET request to /me/parents. You can specify the list of fields from the user objects to be returned using the fields parameter.
Test it with the API Explorer.

You can also see if any user is connected to an existing user object by issuing a GET request to /me/parents/<USER_ID>. This will return a list containing only the connected user object or an empty list if it is not connected.

Create a user's parents connection

You can connect parents to an existing user object one by one by issuing multiple POST requests to /me/parents/<USER_ID>.

Delete a user's parents connection

You can disconnect parents from a user object by issuing DELETE requests to /me/parents/<USER_ID>. You can also disconnect all parents at once by issuing a POST request to /me/parents with an empty ids query-string parameter.
Test it with the API Explorer.

[Player]

players

List of players created by this user
This connection joins an object of type user with a list of player objects.

private readable read scopes: manage_players writable write scopes: manage_players

List of players created by this user
This connection joins an object of type user with a list of player objects.

Read the user's players connection

You can retrieve the list of players connected to a user object by issuing a GET request to /me/players. You can specify the list of fields from the player objects to be returned using the fields parameter.
Test it with the API Explorer.

Create a user's players connection

You can create a new player object and automatically connect it to an existing user object by issuing a POST request to /me/players.

In return, you will receive a dict value containing the newly created object, including its identifier.
Test it with the API Explorer.

Delete a user's players connection

You can delete a player object connected to a user object the same way you would if it wasn't attached, that is by issuing a DELETE request to /player/<PLAYER_ID>.
Test it with the API Explorer.

[User]

relations

List of user accounts related to this user through their parents.
This connection joins an object of type user with a list of user objects.

public readable

List of user accounts related to this user through their parents.
This connection joins an object of type user with a list of user objects.

Read the user's relations connection

You can retrieve the list of relations connected to a user object by issuing a GET request to /me/relations. You can specify the list of fields from the user objects to be returned using the fields parameter.
Test it with the API Explorer.

[Video]

subscriptions

List of videos from the channels the user follow.
This connection joins an object of type user with a list of video objects.

public readable

List of videos from the channels the user follow.
This connection joins an object of type user with a list of video objects.

Read the user's subscriptions connection

You can retrieve the list of subscriptions connected to a user object by issuing a GET request to /me/subscriptions. You can specify the list of fields from the video objects to be returned using the fields parameter.
Test it with the API Explorer.

[Video]

videos

List of videos uploaded by this user.
This connection joins an object of type user with a list of video objects.

public readable writable write scopes: manage_videos

List of videos uploaded by this user.
This connection joins an object of type user with a list of video objects.

Read the user's videos connection

You can retrieve the list of videos connected to a user object by issuing a GET request to /me/videos. You can specify the list of fields from the video objects to be returned using the fields parameter.
Test it with the API Explorer.

Create a user's videos connection

You can create a new video object and automatically connect it to an existing user object by issuing a POST request to /me/videos with the following parameters.

Type	Parameter	Required	Description
STRING	content_provider	No	Content provider name.

In return, you will receive a dict value containing the newly created object, including its identifier.
Test it with the API Explorer.

Delete a user's videos connection

You can delete a video object connected to a user object the same way you would if it wasn't attached, that is by issuing a DELETE request to /video/<VIDEO_ID>.
Test it with the API Explorer.

[Video]

watchlater

List of watch later videos.
This connection joins an object of type user with a list of video objects.

public readable writable write scopes: manage_videos

List of watch later videos.
This connection joins an object of type user with a list of video objects.

Read the user's watchlater connection

You can retrieve the list of watchlater connected to a user object by issuing a GET request to /me/watchlater. You can specify the list of fields from the video objects to be returned using the fields parameter.
Test it with the API Explorer.

You can also see if any video is connected to an existing user object by issuing a GET request to /me/watchlater/<VIDEO_ID>. This will return a list containing only the connected video object or an empty list if it is not connected.

Create a user's watchlater connection

You can connect watchlater to an existing user object one by one by issuing multiple POST requests to /me/watchlater/<VIDEO_ID>.

Delete a user's watchlater connection

You can disconnect watchlater from a user object by issuing DELETE requests to /me/watchlater/<VIDEO_ID>. You can also disconnect all watchlater at once by issuing a POST request to /me/watchlater with an empty ids query-string parameter.
Test it with the API Explorer.

User deprecated connections

These deprecated connections were once part of the API reference but are no longer maintained. Support is still available until the end of life date specified for each filter. Do not use any of these for a new project as they may disappear without warning.

[Video]

favorites

List of videos favorited by this user.
This connection joins an object of type user with a list of video objects.

This connection was deprecated on June 27th, 2016.

Use the likes endpoint instead.

End of support: June 27th, 2017.

public readable writable

List of videos favorited by this user.
This connection joins an object of type user with a list of video objects.

Read the user's favorites connection

You can retrieve the list of favorites connected to a user object by issuing a GET request to /me/favorites. You can specify the list of fields from the video objects to be returned using the fields parameter.
Test it with the API Explorer.

You can also see if any video is connected to an existing user object by issuing a GET request to /me/favorites/<VIDEO_ID>. This will return a list containing only the connected video object or an empty list if it is not connected.

Create a user's favorites connection

You can connect favorites to an existing user object one by one by issuing multiple POST requests to /me/favorites/<VIDEO_ID>.

Delete a user's favorites connection

You can disconnect favorites from a user object by issuing DELETE requests to /me/favorites/<VIDEO_ID>. You can also disconnect all favorites at once by issuing a POST request to /me/favorites with an empty ids query-string parameter.
Test it with the API Explorer.

[User]

recommended

List of users recommended to this user.
This connection joins an object of type user with a list of user objects.

This connection was deprecated on October 30th, 2017.

Recommended feature has been discontinued.

End of support: January 30th, 2018.

public readable

List of users recommended to this user.
This connection joins an object of type user with a list of user objects.

Read the user's recommended connection

You can retrieve the list of recommended connected to a user object by issuing a GET request to /me/recommended. You can specify the list of fields from the user objects to be returned using the fields parameter.
Test it with the API Explorer.

Video

The video object is the foundation of Dailymotion’ service. Videos are metadata containers wrapped around media streams and can be accessed either directly or through several connections through the Data API.

Manipulating videos

To retrieve a specific video object, perform a GET request on /video/<VIDEO_ID>. By default, only a small number of fields marked as default are returned (such as the object identifier), please refer to the complete field list below. For help on requesting specific fields, see the fields selection section.

To retrieve a list of video objects, perform a GET request on /videos. You can also use one of the several connections available through the channel, playlist, user and video graph objects. You can then use filters (if any) to filter down the result set, see the filtering section for more information.

To create an object of type video, perform a POST request on the connection available through the user graph object. Join all the fields you want to specify and their value as an application/x-www-form-urlencoded payload. Please note that, for creation, some fields and/or specific query-string parameters could be mandatory, please refer to the field list below.