Data API documentation

Getting started

Dailymotion is one of the biggest video platforms in the world, and as such, we offer video storage and viewing capability to our users. We would like to make it easy for you developers to integrate video creation and delivery across many platforms (desktop, mobile, consoles, set-top boxes and more). Our powerful and flexible video APIs are here to help us help you!

Our APIs, what for?

Our developer tools enable you to access both data regarding videos, users, comments, etc. (via the Data API) and to interact with the video player and embed it on your own website or application (via the Player API). At a high level, the range of available API calls covers virtually all facets of Dailymotion. Public data is available with no specific authentication while various parts of the API are available depending on the authenticated status and the permissions the user has granted your application.

Registering

While some basic features are available without authentication, you will need to register yourself as a developer in order to perform more elaborate API calls, authenticate users and act on their behalf.

To start developing with us, it is therefore recommended to register your application and retrieve an API key and secret:

1. Create a new account or login using your own account on Dailymotion.
2. Register your application on your developer profile. You will retrieve an API key and an API secret.
3. You can now start developing your application!

Follow this documentation, try making some calls, read the examples and code samples and make the best out of dailymotion-hosted content!

Tip: use one API key per application/project to separate usages.

Data API overview

Introduction

The Dailymotion Data API is a simple way to access, publish and modify data on Dailymotion. It presents a simple, consistent view of the Dailymotion objects (e.g., users, videos, playlists, etc.) and connections between them (e.g., friend relationship, user's videos, videos in playlists, etc.).

Our API is served over HTTPS, on the following endpoint:

https://api.dailymotion.com

Graph object

Every object in the Dailymotion Data API has a unique identifier (within its class of object). You can access fields of every object by requesting /<OBJECT_CLASS>/<OBJECT_ID>, where <OBJECT_CLASS> can be video, user, playlist, etc. Here are some examples of object URLs:

• A user: https://api.dailymotion.com/user/x1fz4ii
• A video: https://api.dailymotion.com/video/x26ezrb
• A playlist: https://api.dailymotion.com/playlist/x3ecgj

Connection

All of the objects in the Dailymotion Data API are connected to each other via relationships: users own playlists, playlists own videos, videos own comments, etc. In a Graph API, these relationships are called connections. You can explore the connections between objects using the URL structure /<OBJECT_CLASS>/<OBJECT_ID>/<CONNECTED_OBJECT>. Here are some examples of supported connections:

• A video's comments: https://api.dailymotion.com/video/x26ezrb/comments
• A list of videos in the music channel: https://api.dailymotion.com/channel/music/videos
• A user's videos: https://api.dailymotion.com/user/x1fz4ii/videos

The complete Data API reference lists all the different objects and connections we support.

Response types

All responses are sent back to you in JSON, which is a lightweight data-interchange format. We return two kinds of structure: item and list.

Items

Items are JSON objects consisting of unordered attribute–value pairs, with a single level of pairs. They are delimited by curly brackets. This kind of response is used when a single object is requested. The properties are the requested field names and their corresponding values. By default, only a certain number of fields are returned, but you can define which fields you want to be returned. See the fields selection section for more details.

{
    "id": "x26ezrb",
    "title": "Hackathon BeMyApp/Dailymotion",
    "channel": "creation",
    "owner": "x1fz4ii"
}

Lists

The list response type is a JSON object containing a list property. The associated value is a JSON array of items. Some other properties are also returned such as:

{
    "page": 1,
    "limit": 10,
    "has_more": true,
    "list": [
        {"id": "xf2pow", "title": "Tony Bennett plans Winehouse"},
        {"id": "xf2v32", "title": "Escape From City 17"},
        {"id": "xemyk2", "title": "Portal : No Escape"},
        {"id": "xf35xa", "title": "Earthquake Ignites Social Media Frenzy"},
        {"id": "xf02xp", "title": "Triple Kiss! - The Worst Generation #3"},
        {"id": "xf38x0", "title": "Billion Points Finalists"},
        {"id": "xettt9", "title": "The Best of Gamescom 11"},
        {"id": "xf3cxr", "title": "Review: If Only It Was \"30 Minutes or Less\""},
        {"id": "xf3ix6", "title": "Cold War Kids - Cold Toes On The Cold Floor"},
        {"id": "xf3jaa", "title": "Matthew Morrison Tour Rehearsal"}
    ]
}

Performing a call

You can perform different requests on https://api.dailymotion.com in order to interact with data on our platform. Some requests are public (accessing a public video's title and description), some others will require a specific permission (accessing private videos, adding a comment on a video, etc.).

For a full list of writable fields and connections and their supported parameters, please refer to the Data API reference.

GET

A GET request allows you to retrieve data about an object. For instance, getting information about a user is done using a GET request such as https://api.dailymotion.com/user/x1fz4ii.

POST

Some fields are writable. You can edit these via the Dailymotion Data API by issuing an HTTP POST request to the appropriate URL (see the Data API Reference). For example, you can edit the title of a video by posting to /video/<VIDEO_ID>:

curl -H 'Authorization: Bearer <ACCESS_TOKEN>' \
     -F 'title=My New Title' \
     https://api.dailymotion.com/video/<VIDEO_ID>

You can add a comment on the video by posting to /video/<VIDEO_ID>/comments:

curl -H 'Authorization: Bearer <ACCESS_TOKEN>' \
     -F 'message=My comment text' \
     https://api.dailymotion.com/video/<VIDEO_ID>/comments

Since only the owner of an object can write fields and some fields may require extended permissions or scopes granted by the user, write operations require to pass an access token. See the authentication guide for details on how you can request a token and extended permissions from the user during the authentication step.

DELETE

You can delete an object by issuing an HTTP DELETE request to the object URLs, for example:

curl -X DELETE \
     -H 'Authorization: Bearer <ACCESS_TOKEN>' \
     https://api.dailymotion.com/video/<VIDEO_ID>

To work with clients that do not support all of the HTTP methods (like JavaScript clients), you can alternatively issue a GET request to an object URL with the additional parameter method=delete to override the HTTP method. For example, you can delete a comment by issuing a GET request to /comment/<COMMENT_ID>?method=delete.

Fields selection

All objects are composed of fields. They all have an identifier id (unique in the given class of objects) plus some other fields defined in the Data API Reference. Some fields are publicly readable, some other are not and need the user to be authenticated and may require extended permissions granted by the user.

By default, a few fields are returned. To request more specific fields, use the fields parameter with the list of fields you need in the response. We are urging you to always use fields to only request the fields you will use in your application. For instance, to select the id and the title fields of a video object, perform a GET request to /video/<VIDEO_ID>?fields=id,title.

Let's call https://api.dailymotion.com/video/x26ezj5?fields=id,title. The response will be like this:

{
    "id": "x26ezj5",
    "title": "Greetings"
}

If a field is supposed to return a connected object, selecting the field will return the connected object id. In such case you can request any sub-field of this connected object by concatenating the sub-field name to the field, separated by a dot. For instance, the owner field of the video object returns a user object. If you need the screenname and the url of the video owner, you can perform the following request: https://api.dailymotion.com/video/x26ezj5?fields=id,title,owner,owner.screenname,owner.url. The response will look like this:

{
    "id": "x26ezj5",
    "title": "Greetings",
    "owner": "x1fz4ii",
    "owner.screenname": "Dailymotion API",
    "owner.url": "http://www.dailymotion.com/DailymotionAPI"
}

Note: This also works for lists of objects and connections.

Filtering

When searching for a list of objects, some fields can be used for filtering. Those filters are listed in the API reference, under the filters section of every object (see the filters available for the video object for example). To filter, perform a GET request and put your filters as parameters of the query string. For instance, the following request /videos?channel=tech&language=en will list all English-speaking videos in the 'technology' channel.

Just like a field, a filter declares a data type and only takes specific values in input. When a filter is marked as a flag though, it means that it doesn't take any specific value, its presence in the query string is the only thing that matters. Please see the flag type description for more information.

When the response to your call is a list of objects, you can also sort the list by using the sort filter with any of the available values listed in the API reference.

Caching

The REST API uses HTTP cache control mechanisms. If you want to benefit from caching, you have to make sure URLs don't change between requests. To that end, you should always sort query string parameters by alphabetic order and send the access token using the Authorization HTTP header as follow:

curl -H 'Authorization: OAuth <ACCESS_TOKEN>' \
     https://api.dailymotion.com/videos

Since requests are sent over SSL, your requests' responses cannot be stored on public intermediate proxy cache servers. However, if your application can potentially share the cache between different users, you have to be sure you only share responses marked as public in the Cache-Control HTTP header. This should be done automatically by your HTTP library if it respects the Vary HTTP header sent with private cacheable responses though.

More about requests!

You will find call examples and scenarios in the use-cases section. Our API Explorer will also let you test possible calls through its simple interface.

Learn how to authenticate in the authentication section, so you can perform elaborate calls and interact with your user's videos.

If you want to test the availablility of the API, the /echo endpoint is just want you're looking for! Check the documentation on the /echo endpoint.

Error codes

Receiving error codes

The following is an an example of a common error response, resulting from a failed API Call. Errors contains a status code, a message and an error type.

curl "https://api.dailymotion.com/video/xnotfound"

HTTP/1.1 404 Not Found
{
    "error": {
        "code": 404, 
        "message": "This video does not exist or has been deleted.", 
        "type": "not_found"
    }
}

HTTP Status Code

The Dailymotion Data API uses conventional HTTP response codes to indicate success or failure of an API request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error resulting from invalid provided information (e.g. a required parameter is missing, invalid access token, etc.), and codes in the 5xx range indicate an error with the Dailymotion servers. Hence, we are using the following match for error codes:

Error types

Here's a list of error types you may encounter in errors returned by the API:

Note: This is not an exhaustive list, only the most common ones are listed here.

Video access error

When requesting access to a video, the API may return a message explaining why the access can't be granted inside the specific access_error field. Here is a list of the different access error codes you may encounter and their descriptions:

Guidelines

API rate limits

We enforce some quotas on the Data API calls. For the time being, all stream_*_url fields are rate-limited to 50 calls per day per API key.

Video upload through the API is also limited to:

• 4 videos per hour
• 2 hours of videos (total) per day
• 60 minutes per video
• 2 GB per video

These limits may change on a case-by-case basis. To check your limits at the video level, you can request the limits field on your own user using the API, like this: /me?fields=limits (you will need to be authenticated).

Input/output types

Each graph object field and filter has its own data type, here are the different types available in the API. Please note that any of these can return either their advertised type or a null value if they have no associated data.

string

A simple sequence of UTF-8 characters. Please URL encode all input strings (RFCs 3986 and 1738).

• "123"
• "aerft438j"
• "Simple sequence of UTF-8 characters."
• /video/x26ezrb?title=A+string+for+a+new+title
• /video/x26ezrb?title=A%20string%20for%20a%20new%20title

number

Any number, can be integer or floating point. Please use the international notation with a dot between the integer and decimal parts.

• 0
• 4
• 2.95
• /video/x26ezrb?rental_start_time=3.5

boolean

A truth value. For input values, 0, "false" and "no" all resolve to false and 1, "true" and "yes" all resolve to true.

• true
• false
• /user/x1fz4ii?email_notification=1
• /user/x1fz4ii?email_notification=false

date

A date expressed as a UNIX timestamp (number of seconds since the UNIX Epoch).

• 0
• 1287507036
• 2147483647
• /user/x1fz4ii?birthday=532701000

array

An unordered collection of any other scalar data type (most likely strings or numbers). Elements are listed between square brackets and separated by commas. For inputting arrays, simply separate every element with commas.

• []
• [1,2,3]
• ["ld","sd","hq","hd720"]
• /video/x26ezrb?tags=elements,separated,with,commas
• /video/x26ezrb?tags=elements%2Cseparated%2Cwith%2Ccommas

dict

A dict is a flat single level deep map that associates various type of values to keys.

• {}
• {1:"January",2:"February",3:"March"}
• {"video_duration":3600,"video_size":2147483648}

url

Any URL, it isn't implied that the URL actually resolves to any resource.

• http://www.dailymotion.com/videos
• https://www.dailymotion.com/video/x26ezrb_hackathon-bemyapp-dailymotion_creation
• /video/x26ezrb?url=http%3A%2F%2Fwww.dailymotion.com%2Fvideo%2Fx26ezrb

email

An email address, it isn't implied that the address actually resolves to any inbox.

• [email protected]
• [email protected]
• /user/x1fz4ii?email=user%40example.org

object

Any other Data API object, which means that the returned value will be an identifier and that you can retrieve sub-fields of the corresponding object using the dot-notation. For inputting object values, simply provide the identifier of the object.

• user
• video
• /user/x1fz4ii?videostar=x26ezrb

flag

Flag is a special type reserved for simple boolean filters. When a filter is marked as a flag, it means that it doesn't take any specific value, its presence in the query string is the only thing that matters. You can still attach a value to them in your query string, but it won't have any effect and will be discarded. Here are the three different ways of using them:

• /videos?flags=featured,hd,no_live (recommended)
• /videos?featured&hd&no_live
• /videos?featured=true&hd=true&no_live=true (not recommended)

Encoding

We strongly recommend the use of UTF-8 encoding for all interactions with the API.

Authentication

By default, your application can only access public API data like public video title, description, etc. In order to interact with someone's Dailymotion account, this user has to authorize your application. The Dailymotion Data API uses the OAuth 2.0 protocol for managing authentication and authorization flows between the API and third-party applications.

OAuth 2.0

For accessing and/or manipulating protected resources (such as private user data), the client application (your application) needs to be granted permission to do so. The OAuth 2.0 standard defines a protocol that allows such third-party authorization through the use of access tokens. Access tokens are central in the protocol: those tokens, in the form of strings, are delivered by an authorization server (at Dailymotion) and they enable the client application to securely access protected data on behalf of the resource owner (the end-user).

Hence, there is a series of back-and-forth exchanges between the client application, the resource owner and the authorization server in order to create an access token, which will be forwarded every time you perform requests to the resource server. The typical exchange is as follows:

1. The client application asks the resource owner for authorization and receives an authorization grant.
2. The client application then authenticate itself to the authorization server (by forwarding this authorization grant) in order to obtain an access token. These two steps are described in the retrieving an access token section.
3. Lastly, the client application uses this access token to request resources to the resource server. Read the using an access token section for more details on how to use the access token when performing an API request.

With no scope provided, your application will only be able to interact with public data such as searching for a public video or requesting comments on a video. If your application needs to read private data or change some user's associated data (post a comment on behalf of someone, modify someone else's video title, etc), your application can request a larger permission scope. How to request extended permissions is described in the Extended Permissions section.

For more in depth information about the OAuth 2.0 protocol and specifications, please refer to the Request For Comments (RFC) #6749.

Retrieving an access token

A typical scenario when using the Dailymotion API is that of an application managing someone's videos and acting on his/her behalf.

For this, three canonical types of grant types exist (given by resource owner to client application, depending on the scenario and technology used):

1. Authorization code: the authorization server acts as intermediary between the resource owner and the client application. The resource owner is directly authenticated and asked for authorization by the authorization server, before the authorization code is returned to the client application. For this usage, use the authorization_code grant type.
2. Resource owner password credentials: the client application asks the user for his/her credentials (login and password) and pass them directly to the authorization server to retrieve an access token. The credentials should only be used when there is a high degree of trust between the resource owner and the client application (e.g., the client application is part of the device operating system or a highly privileged application), and when other authorization grant types are not available (such as an authorization code). Because the application has the responsibility to ask the user for his/her credentials, you have to make sure your API secret remains a secret. For this usage, use the password grant type.
3. Client credentials: authorization is managed using client credentials (application credendials, no authenticated user), for example for publicly available resources in Dailymotion (seldom used). This is enough if you don't need to access the Dailymotion API on behalf of another user. For this usage, use the client_credentials grant type.

Client profiles

For this purpose, there are three main profiles:

• Web applications
• User-agent-based applications
• Native applications

Web application profile

The web application profile is suitable for client applications capable of interacting with the end-user's user-agent (typically a web browser) and capable of receiving incoming requests from the authorization server (capable of acting as an HTTP server).

The steps to obtain an access token are:

1. Once your application has been registered, you get an API key, which we will call your client_id and an API secret, which is your client_secret.

2. Redirect the user to https://www.dailymotion.com/oauth/authorize with your client_id and the URL the user should be redirected back to after the authorization process (the redirect_uri). For security reason, only redirect_uri starting with the callback URL provided when you created your API key will be accepted (line breaks are for display purposes only):

   https://www.dailymotion.com/oauth/authorize
     ?response_type=code
     &client_id=<API_KEY>
     &redirect_uri=http://www.example.org/callback

   If your redirect_uri has to contain a dynamic part, you can use a slug this way when you specify your application callback URL: http://www.example.org/callback/[<SLUGNAME>]. The <SLUGNAME> part becomes the dynamic part.

3. If the user authorizes your application, Dailymotion redirects the user back to the redirect_uri you specified with a verification string in the code query parameter. This authorization code can then be exchanged for an OAuth access token by POST-ing to the token server at https://api.dailymotion.com/oauth/token. Pass the exact same redirect_uri as in the previous step (line breaks are for display purposes only):

   POST /oauth/token HTTP/1.1
   Host: api.dailymotion.com
   Content-Type: application/x-www-form-urlencoded
   
   grant_type=authorization_code
     &client_id=<API_KEY>
     &client_secret=<API_SECRET>
     &redirect_uri=http://www.example.org/callback
     &code=<AUTHORIZATION_CODE>

   In return, you will retrieve the following JSON response:

   {
     "access_token": "<ACCESS_TOKEN>",
     "expires_in": 36000,
     "refresh_token": "<REFRESH_TOKEN>"
   }

4. You can then use the access_token from the response to make requests on behalf of this user. Read the using an access token section for more details.

Note: If the user does not authorize your application, Dailymotion redirects the user to the redirect_uri you specified, and adds both error and error_description parameters to the query.

Note: The access token is valid for the given number of seconds defined by the expires_in parameter of the token server response. You can use the obtained refresh_token to request another access token without the need to ask anything to the user again. See the requesting an access token from a refresh token section for more details.

Note: We strongly advise you to use one of the official Dailymotion SDKs that abstract all of these exchanges for you and make this process easier.

User-Agent profile

The user-agent profile is suitable for client applications residing in a user-agent, typically implemented in a browser using a scripting language such as JavaScript. There, client applications cannot keep secrets confidential and the authentication of the client application is based on the user-agent's same-origin policy.

Unlike the web application profile (in which the client application makes separate requests for end-user authorization and access token), the client application receives the access token as a result of the end-user authorization request in the form of an HTTP redirection. The client application requests the authorization server to redirect the user-agent to another web server or local resource accessible to the user-agent which is capable of extracting the access token from the response and passing it to the client application.

This user-agent profile does not use the client application's API secret since the code resides on the end-user's computer or device which makes the API secret accessible and exploitable. Because the access token is encoded into the redirection URI, it may be exposed to the end-user and other applications residing on the computer or device.

The steps to obtain an access token are:

1. Once your application has been registered, you get an API key, which we will call your client_id and an API secret (which is not used with this profile).

2. Redirect the user to https://www.dailymotion.com/oauth/authorize with your client_id, redirect_uri and response_type set to token. If your application is popping up a window, you can trigger the compatibility pop-up version of the authorization window by setting display to popup. For example (line breaks are for display purposes only):

   https://www.dailymotion.com/oauth/authorize
     ?response_type=token
     &client_id=<API_KEY>
     &redirect_uri=http://www.example.org/callback
     &display=popup

   After the user authorizes your application, Dailymotion redirects the user to the redirect_uri you specified with the access token in the URI fragment (line breaks are for display purposes only):

   http://www.example.org/callback
     ?access_token=<ACCESS_TOKEN>
     &expires_in=<EXPIRES_IN_SECONDS>

3. Use the access token returned above to fetch data from the Dailymotion API on behalf of the user. Read the using an access token section for more details.

Note: If the user does not authorize your application, Dailymotion redirects him to the redirect_uri you specified, and adds both error and error_description parameters to the query.

Note: We strongly advise you to use one of the official Dailymotion SDKs that abstract all of these exchanges for you and make this process easier.

Native application profile

Native client applications are running as native code on the end-user's computer or device (i.e. executing outside a user-agent or as a desktop program). These client applications are often capable of interacting with (or embedding) the end-user's user-agent but are limited in how such interaction affects their end-user experience. In many cases, native applications are incapable of receiving direct callback requests from the server (e.g. firewall, operating system restrictions, etc.).

Native client applications can be implemented in different ways based on their requirements and desired end-user experience. Native client applications can:

• Use the end-user authorization endpoint as described in the User-Agent section by launching an external user-agent. The client application can capture the response by providing a redirection URI with a custom URI scheme (registered with the operating system to invoke the native client application), or by providing a redirection URI pointing to a server-hosted resource under the client application's control which makes the response available to the client application (e.g. using the window title or other locations accessible from outside the user-agent).

• Use the end-user authorization endpoint as described in the User-Agent section by using an embedded user-agent. The client application obtains the response by directly communicating with the embedded user-agent.

• Prompt the end-user for their password credentials and use them directly to obtain an access token. This method is discouraged since users will have to communicate their credentials directly to your client application. Additionally, users who created their account using their Facebook, Google or other third-party accounts won't be able to log-in into your application using this authentication method. Please note that if you have no other choice but to use this method, you are not allowed to store the end-user credentials you obtained.

The steps to obtain an access token using the end-user credentials are:

1. Once your application has been registered, you get an API key, which we will call your client_id and an API secret, which is your client_secret.

2. Ask the end-user for his credentials which consist of a username and a password.

3. Retrieve an OAuth access token by POST-ing to the token server at https://api.dailymotion.com/oauth/token. Set the grant_type to password, pass the client_id and client_secret(related to your application) and the user credentials in username and password(line breaks are for display purposes only):

   POST /oauth/token HTTP/1.1
   Host: api.dailymotion.com
   Content-Type: application/x-www-form-urlencoded
   
   grant_type=password
     &client_id=<API_KEY>
     &client_secret=<API_SECRET>
     &username=<USER_USERNAME>
     &password=<USER_PASSWORD>

   In return, you will get the following JSON response:

   {
     "access_token": "<ACCESS_TOKEN>",
     "expires_in": 36000,
     "refresh_token": "<REFRESH_TOKEN>"
   }

4. Use the access token returned by the request above to make requests on behalf of the user. Read the using an access token section for more details.

Note: The access token is valid for a given number of seconds defined by the expires_in parameter of the token server response. You can use the obtained refresh_token to request another access token without the need to ask anything to the user again. See the (requesting an access token from a refresh token)[#using-refresh-tokens] section for more details.

Note: We strongly advise you to use one of the official Dailymotion SDKs that abstract all of these exchanges for you and make this process easier.

Refreshing a token

Some authorization methods provide you with a refresh token in addition to the access token. The access token validity is always limited in time indicated by the expires_in property of the token server response or by a 401 HTTP status code error when used with the API (see the Request For Comments (RFC) #6749 for more in depth information).

Once an access token has expired, you can request another access token without the need to repeatedly ask anything to the end-user, but only if you are in possession of a refresh token. To do that, send the following request to the token server at https://api.dailymotion.com/oauth/token(line breaks are for display purposes only):

POST /oauth/token HTTP/1.1
Host: api.dailymotion.com
Content-Type: application/x-www-form-urlencoded

grant_type=refresh_token
    &client_id=<API_KEY>
    &client_secret=<API_SECRET>
    &refresh_token=<REFRESH_TOKEN>

In return you will get the following JSON response:

{
    "access_token": "<ACCESS_TOKEN>",
    "expires_in": 36000,
    "refresh_token": "<REFRESH_TOKEN>"
}

In case of error, the JSON object will contain both an error and error_description properties. See the Request For Comments (RFC) #6749 for more details.

Note: We strongly advise you to use one of the official Dailymotion SDKs that abstract all of these exchanges for you and make this process easier.

Note: One of the problems with OAuth 2 is that the specification doesn't offer any mechanism to upgrade the scope of an existing session on refresh. See the extended permissions section for more information.

Extended permissions

In the above examples, the OAuth process will authenticate your application with the Dailymotion user, which will allow you to fetch general information about the user's profile via the Dailymotion API /me endpoint. As mentioned above, if you need to fetch private data associated to the user or you want to request permission to publish content on a user's behalf, you will need to request extended permissions.

To request extended permissions via OAuth 2.0, use the scope parameter in your authorization request, and include a white-space-separated list of all the permissions you want to request. For example this authorization request asks for personal information and full video control (line breaks are for display purposes only):

https://www.dailymotion.com/oauth/authorize
    ?response_type=code
    &client_id=<API_KEY>
    &redirect_uri=http://www.example.org/callback
    &scope=userinfo+manage_videos

Note: One of the problems with OAuth 2 is that the specification doesn't offer any mechanism to upgrade the scope of an existing session. To add new scopes to an already existing session, you first need to call the /logout endpoint and start a new session with your new list of scopes.

Here are a few of the extended permissions available:

There is more to it. Refer yourself to the full Data API reference for a complete list of the information your can access and the permissions needed to request them.

Revoking authorization

Your application should always allow users to revoke authorization granted to your API key. The user can also revoke your application from his profile on Dailymotion, but it's far less user-friendly than having a simple Logout from Dailymotion button in your interface.

To revoke authorization, perform a GET request to the /logout URI with the Authorization header (or access_token query parameter). Read the using an access token section for more details. Once done, your current session (access token and/or refresh token) are no longer valid and you can forget about them in your application.

Form factors

Dailymotion supports a non-standard display parameter to trigger different form factors for the authorization dialog that may be more appropriate for your application:

For example, to trigger the dialog in a pop-up window, you would redirect the user to (line breaks are for display purposes only):

https://www.dailymotion.com/oauth/authorize
    ?response_type=code
    &client_id=<API_KEY>
    &redirect_uri=http://www.example.org/callback
    &display=popup

Note: Even if you chose page or popup from a known mobile device, the mobile display will be chosen automatically.

Using an access token

At high level, using OAuth 2.0 entails getting an access token for a Dailymotion user via a redirect to Dailymotion. After you obtain the access token, you can perform authorized requests on behalf of this user by including it in all of your API requests using the Authorization HTTP header:

GET /videos HTTP/1.1
Host: api.dailymotion.com
Authorization: Bearer <ACCESS_TOKEN>

You can also provide the access token directly as a query parameter, but this method is not recommended because it's unsafe and incompatible with some other API entry points (like the Advanced API):

https://api.dailymotion.com/videos?access_token=<ACCESS_TOKEN>

Once authenticated on the API, you can use the special identifier /me which refers to the currently authenticated user (alias of /user/<USER_ID>). So the URL https://api.dailymotion.com/me/videos returns the same thing as https://api.dailymotion.com/user/<USER_ID>/videos.

Checking an access token

If you want to retrieve information on your access token, you can perform a GET request of /auth. This request returns diverse information on the user authentified in your application: id, username, screename, extended permissions accepted, roles granted the application through which the token was created.

{
  "id": "x1fz4ii",
  "scope": [
    "manage_comments",
    "manage_videos",
    "userinfo"
  ],
  "roles": [],
  "username": "DailymotionAPI",
  "screenname": "Dailymotion API"
}

Data API reference

Here is a list of the various graph objects available through the Dailymotion Data API. Some of them will only be available for reading, and some others for creation and edition too.

Global API Parameters

The following query-string parameters are valid on the whole API and can be provided along with any type of request. Some of them are strongly recommended if you want to enhance your end-user experience. To use a global parameter, simply add it to any request's query-string like so:
/video/x26m1j4/comments?family_filter=false&localization=it

Auth

This endpoint enables to access information about the current authenticated user. This relates to the user authenticated using an access token (provided with the appropriate header or as a query-string parameter).

Retrieving current auth information

To retrieve information about the current authenticated user, perform a GET request on /auth. By default, only a small number of default fields are returned, please refer to the complete field list below. For help on requesting more specific fields, see the fields selection section.

Sample auth API call: /auth

Current auth information response

Here is the list of fields you can retrieve when performing a call on /auth.

Channel

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

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 also use 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.

datecreated_time

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: 1287507036

Date and time when this channel was created.

stringdescription

publicPublicly documented and available for allreadableCan be accessed without authenticationdefaultThis field is returned by default when not asking for specific fieldsmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "Everything about video-games!"

Comprehensive localized description of this channel.

stringid

publicPublicly documented and available for allreadableCan be accessed without authenticationdefaultThis field is returned by default when not asking for specific fields

Sample value: "x9wughn"

Unique object identifier (unique among all channels)

stringitem_type

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "channel"

Graph type of this object (hopefully channel)

stringname

publicPublicly documented and available for allreadableCan be accessed without authenticationdefaultThis field is returned by default when not asking for specific fieldsmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "Video Games"

Localized short name of this channel.

stringslug

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "video-games"

Slug name of this channel.

dateupdated_time

publicPublicly documented and available for allreadableCan be accessed without authentication

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

stringFormat of the expected valueallowed values: popular, alphaCorresponding values have to respect this format

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. Follow our API ChangeLog regularly to stay informed about deprecations and upcoming end of life dates.

language

This filter was deprecated on December 29, 2011.Use the localization global parameter instead.End of support: December 29, 2014.

stringFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

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

publicPublicly documented and available for allreadableCan be accessed without authentication

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

publicPublicly documented and available for allreadableCan be accessed without authentication

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.

Echo

This endpoint returns the same exact message which was given as a parameter. It can be used to test the availability and reactivity of the API.

Using echo

To send an /echo request, perform a GET request on /echo. The table below lists all the parameters that can be provided when performing this request:

Sample echo API call: /echo?message=this+is+a+test

Echo response

Here is the list of fields you can retrieve when performing a call on /echo.

File

This endpoint allows anyone to retrieve a video upload URL, when you need to upload a video on Dailymotion's servers and don't want to upload it on your own server.

File upload

To retrieve an upload URL, perform a GET request on /file/upload. The table below lists the parameters that can be provided when performing this request.

Sample file upload API call: /file/upload

File upload response

Here is the list of fields you can retrieve when performing a call on /file/upload.

Languages

The languages endpoint is used to retrieve the list of ISO-639-3 2 or 3 letter codes associated with the language name, native name, localized name, and name as it could be displayed on Dailymotion.

Retrieving languages

To retrieve the list of ISO-639-3 languages, perform a GET request on /languages.

The list of fields returned is fixed and defined as followed. This call do not support the fields parameter.

Sample locale API call: /languages

Languages response

Here is the list of fields you will retrieve when performing a call on /languages.

Locale

A locale is a set of parameters that defines a user's language, country, currency, etc.

Detecting and retrieving locales

To detect the locale of the current requestor, perform a GET request on /locale.

To retrieve the list of locales supported by Dailymotion, perform a GET request on /locales.

In both cases, the list of fields returned is fixed and defined as follow since these calls do not support the fields parameter. You can also return informations on a specific locale by changing your request locale using the localization global parameter.

Sample locale API call: /locale

Locale detection response

Here is the list of fields you will retrieve when performing a call on /locale or /locales.

Logout

This endpoint removes the right for the current API key to access the current user account (the user authenticated by the current access token). Once this method is called, all further requests with the same access token will fail and any previously obtained refresh token for this session will be invalidated.

Logging out

To logout a user, perform a GET request on /logout. This call returns an empty JSON object in case of success: {}

Sample logout API call: /logout

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 also use 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.

datecreated_time

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: 1287507036

Date and time when this playlist was created.

stringdescription

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the objectmin length: 1Corresponding values have to respect this formatmax length: 2000Corresponding values have to respect this format

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

Comprehensive description of this playlist.

stringid

publicPublicly documented and available for allreadableCan be accessed without authenticationdefaultThis field is returned by default when not asking for specific fields

Sample value: "x7mbe14"

Unique object identifier (unique among all playlists)

stringitem_type

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "playlist"

Graph type of this object (hopefully playlist)

stringname

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the objectdefaultThis field is returned by default when not asking for specific fieldsmin length: 1Corresponding values have to respect this formatmax length: 50Corresponding values have to respect this format

Sample value: "Best goals of the championship"

Short descriptive name of this playlist.

userowner

publicPublicly documented and available for allreadableCan be accessed without authenticationdefaultThis field is returned by default when not asking for specific fields

Sample value: "xgnk1un"

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

urlthumbnail_60_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s2.dmcdn.net\/3CQ3\/x60-epG.jpg"

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

urlthumbnail_120_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s2.dmcdn.net\/3CQ3\/x120-lbT.jpg"

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

urlthumbnail_180_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s2.dmcdn.net\/3CQ3\/x180-Pe8.jpg"

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

urlthumbnail_240_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s2.dmcdn.net\/3CQ3\/x240-bP7.jpg"

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

urlthumbnail_360_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s2.dmcdn.net\/3CQ3\/x360-AdG.jpg"

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

urlthumbnail_480_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s2.dmcdn.net\/3CQ3\/x480-kEp.jpg"

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

urlthumbnail_720_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s2.dmcdn.net\/3CQ3\/x720-LZe.jpg"

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

urlthumbnail_1080_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s2.dmcdn.net\/CTrg1\/x1080-Ec7.jpg"

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

urlthumbnail_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "https:\/\/s1-ssl.dmcdn.net\/3CQ3.jpg"

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

dateupdated_time

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: 1404129540

Date and time when this playlist was last updated.

numbervideos_total

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

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. Follow our API ChangeLog regularly to stay informed about deprecations and upcoming end of life dates.

stringevent_playlist_add

This field was deprecated on April 30, 2017.This feature is deprecatedEnd of support: April 30, 2018.

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "playlist.videoAdd.x3ecgj"

Name of the Pushd event sent when a video is added to this playlist.

stringrelative_updated_time

This field was deprecated on November 24, 2014.Use the updated_time field and format the result client-side instead.End of support: November 24, 2015.

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "42 minutes ago"

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

urlthumbnail_large_url

This field was deprecated on July 31, 2014.Use the thumbnail_360_url field instead.End of support: July 31, 2015.

publicPublicly documented and available for allreadableCan be accessed without authentication

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

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

urlthumbnail_medium_url

This field was deprecated on July 31, 2014.Use the thumbnail_240_url field instead.End of support: July 31, 2015.

publicPublicly documented and available for allreadableCan be accessed without authentication

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

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

urlthumbnail_small_url

This field was deprecated on July 31, 2014.Use the thumbnail_60_url field instead.End of support: July 31, 2015.

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "https:\/\/s2-ssl.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

arrayFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: xk2k3,x26m1j4,xkeg4

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

owner

objectFormat of the expected value

Sample value: xgnk1un

Limit the result set to playlists of this user.

search

stringFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: football

Limit the result set to this full text search.

sort

stringFormat of the expected valueallowed values: recent, relevance, alpha, most, least, alphaaz, alphaza, changedCorresponding values have to respect this format

Sample value: relevance

Change the default result set ordering.

verified

flagThis filter is a simple boolean 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

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the object

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_1>,...,<VIDEO_ID_N>. 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.

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.

stringid

publicPublicly documented and available for allreadableCan be accessed without authenticationdefaultThis field is returned by default when not asking for specific fields

Sample value: "xsiig89"

Unique object identifier (unique among all subtitles)

stringitem_type

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "subtitle"

Graph type of this object (hopefully subtitle)

stringlanguage

publicPublicly documented and available for allreadableCan be accessed without authenticationfor creationCan be used for object creation if authenticated and owner of the objectdefaultThis field is returned by default when not asking for specific fieldsmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "en"

Language of these subtitles.

stringlanguage_label

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "Fran\u00e7ais"

Subtitles's language in its own language.

urlurl

publicPublicly documented and available for allreadableCan be accessed without authenticationfor creationCan be used for object creation if authenticated and owner of the object

Sample value: "http:\/\/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

stringFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

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.

stringactive

publicPublicly documented and available for allreadableCan be accessed without authenticationallowed values: y, nCorresponding values have to respect this format

Sample value: "y"

Force user account active.

stringaddress

privateRequires authentication to be accessedread scope: userinfoCan be read when authenticated with the specified scopewrite scope: userinfoCan be written when authenticated with the specified scopemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "715 5th Avenue"

Postal address of this user.

urlavatar_25_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s1.dmcdn.net\/AVM\/25x25--w1.png"

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

urlavatar_60_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s1.dmcdn.net\/AVM\/60x60-As1.png"

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

urlavatar_80_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s1.dmcdn.net\/AVM\/80x80-Rf1.png"

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

urlavatar_120_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s1.dmcdn.net\/AVM\/120x120-bn1.png"

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

urlavatar_190_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s1.dmcdn.net\/AVM\/190x190-ma1.png"

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

urlavatar_240_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s1.dmcdn.net\/AVM\/240x240-sU1.png"

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

urlavatar_360_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s1.dmcdn.net\/AVM\/360x360-PM1.png"

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

urlavatar_480_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s1.dmcdn.net\/AVM\/480x480-CD1.png"

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

urlavatar_720_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s1.dmcdn.net\/AVM\/720x720-Gr1.png"

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

urlavatar_url

privateRequires authentication to be accessedwrite-onlyCan't be read, only writtenwritableCan be written if authenticated and owner of the object

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

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

datebirthday

privateRequires authentication to be accessedread scope: userinfoCan be read when authenticated with the specified scopewrite scope: userinfoCan be written when authenticated with the specified scope

Sample value: 532652400

Birthday date of this user.

numberchildren_total

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 10

Total number of user children.

stringcity

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: userinfoCan be written when authenticated with the specified scopemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "New York City"

City of residence of this user.

stringcountry

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: userinfoCan be written when authenticated with the specified scopemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "US"

Country of residence of this user.

urlcover_100_url

publicPublicly documented and available for allreadableCan be accessed without authentication

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

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

urlcover_150_url

publicPublicly documented and available for allreadableCan be accessed without authentication

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

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

urlcover_200_url

publicPublicly documented and available for allreadableCan be accessed without authentication

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

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

urlcover_250_url

publicPublicly documented and available for allreadableCan be accessed without authentication

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

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

urlcover_url

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the object

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

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

datecreated_time

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: 1287507036

Date and time when this user joined the site.

stringdescription

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the objectmin length: 1Corresponding values have to respect this formatmax length: 2000Corresponding values have to respect this format

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

Comprehensive description of this user.

emailemail

privateRequires authentication to be accessedread scope: emailCan be read when authenticated with the specified scopewrite scope: emailCan be written when authenticated with the specified scope

Sample value: "[email protected]"

Email address of this user.

stringfacebook_url

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the objectmin length: 1Corresponding values have to respect this formatmax length: 400Corresponding values have to respect this format

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

Facebook profile URL of this user.

stringfirst_name

privateRequires authentication to be accessedread scope: userinfoCan be read when authenticated with the specified scopewrite scope: userinfoCan be written when authenticated with the specified scopemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "John"

First name of this user.

numberfollowers_total

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 42

Total amount of followers of this user.

numberfollowing_total

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 42

Total amount of users this user is following.

stringfullname

privateRequires authentication to be accessedread scope: userinfoCan be read when authenticated with the specified scopewrite scope: userinfoCan be written when authenticated with the specified scopemin length: 1Corresponding values have to respect this formatmax length: 50Corresponding values have to respect this format

Sample value: "John Doe"

Full name of this user.

stringgender

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the objectallowed values: male, femaleCorresponding values have to respect this format

Sample value: "male"

Gender of this user.

stringgoogleplus_url

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the objectmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

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

Googleplus profile URL of this user.

stringid

publicPublicly documented and available for allreadableCan be accessed without authenticationdefaultThis field is returned by default when not asking for specific fields

Sample value: "xw0a62m"

Unique object identifier (unique among all users)

stringinstagram_url

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the objectmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

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

Instagram profile URL of this user.

booleanis_following

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: true

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

stringitem_type

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "user"

Graph type of this object (hopefully user)

stringlanguage

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the objectmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "en"

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

stringlast_name

privateRequires authentication to be accessedread scope: userinfoCan be read when authenticated with the specified scopewrite scope: userinfoCan be written when authenticated with the specified scopemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "Doe"

Last name of this user.

dictlimits

privateRequires authentication to be accessedread scope: userinfoCan be read when authenticated with the specified scopemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

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.

stringlinkedin_url

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the objectmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

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

LinkedIn profile URL of this user.

userparent

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "xfpdiqb"

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).

booleanpartner

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the object

Sample value: true

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

stringpinterest_url

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: userinfoCan be written when authenticated with the specified scopemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

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

Pinterest profile URL of this user.

numberplaylists_total

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 5

Total amount of playlists of this user.

numberreposts_total

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 5

The number of videos reposted by the user.

numberrevenues_claim_last_day

privateRequires authentication to be accessedread scope: read_insightsCan be read when authenticated with the specified scopemin value: 0Corresponding values have to respect this format

Sample value: 12

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

numberrevenues_claim_last_month

privateRequires authentication to be accessedread scope: read_insightsCan be read when authenticated with the specified scopemin value: 0Corresponding values have to respect this format

Sample value: 310.2

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

numberrevenues_claim_last_week

privateRequires authentication to be accessedread scope: read_insightsCan be read when authenticated with the specified scopemin value: 0Corresponding values have to respect this format

Sample value: 80.7

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

numberrevenues_claim_total

privateRequires authentication to be accessedread scope: read_insightsCan be read when authenticated with the specified scopemin value: 0Corresponding values have to respect this format

Sample value: 2502.37

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

numberrevenues_paidcontent_last_day

privateRequires authentication to be accessedread scope: read_insightsCan be read when authenticated with the specified scopemin value: 0Corresponding values have to respect this format

Sample value: 12

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

numberrevenues_paidcontent_last_month

privateRequires authentication to be accessedread scope: read_insightsCan be read when authenticated with the specified scopemin value: 0Corresponding values have to respect this format

Sample value: 310.2

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

numberrevenues_paidcontent_last_week

privateRequires authentication to be accessedread scope: read_insightsCan be read when authenticated with the specified scopemin value: 0Corresponding values have to respect this format

Sample value: 80.7

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

numberrevenues_paidcontent_total

privateRequires authentication to be accessedread scope: read_insightsCan be read when authenticated with the specified scopemin value: 0Corresponding values have to respect this format

Sample value: 2502.37

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

numberrevenues_video_last_day

privateRequires authentication to be accessedread scope: read_insightsCan be read when authenticated with the specified scopemin value: 0Corresponding values have to respect this format

Sample value: 12

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

numberrevenues_video_last_month

privateRequires authentication to be accessedread scope: read_insightsCan be read when authenticated with the specified scopemin value: 0Corresponding values have to respect this format

Sample value: 310.2

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

numberrevenues_video_last_week

privateRequires authentication to be accessedread scope: read_insightsCan be read when authenticated with the specified scopemin value: 0Corresponding values have to respect this format

Sample value: 80.7

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

numberrevenues_video_total

privateRequires authentication to be accessedread scope: read_insightsCan be read when authenticated with the specified scopemin value: 0Corresponding values have to respect this format

Sample value: 2502.37

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

numberrevenues_website_last_day

privateRequires authentication to be accessedread scope: read_insightsCan be read when authenticated with the specified scopemin value: 0Corresponding values have to respect this format

Sample value: 12

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

numberrevenues_website_last_month

privateRequires authentication to be accessedread scope: read_insightsCan be read when authenticated with the specified scopemin value: 0Corresponding values have to respect this format

Sample value: 310.2

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

numberrevenues_website_last_week

privateRequires authentication to be accessedread scope: read_insightsCan be read when authenticated with the specified scopemin value: 0Corresponding values have to respect this format

Sample value: 80.7

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

numberrevenues_website_total

privateRequires authentication to be accessedread scope: read_insightsCan be read when authenticated with the specified scopemin value: 0Corresponding values have to respect this format

Sample value: 2502.37

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

stringscreenname

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: userinfoCan be written when authenticated with the specified scopedefaultThis field is returned by default when not asking for specific fieldsmin length: 1Corresponding values have to respect this formatmax length: 50Corresponding values have to respect this format

Sample value: "johndoe424"

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

stringstatus

publicPublicly documented and available for allreadableCan be accessed without authenticationallowed values: pending-activation, disabled, active, unknownCorresponding values have to respect this format

Sample value: "active"

Current user account status.

stringtwitter_url

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the objectmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

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

Twitter profile URL of this user.

urlurl

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/www.dailymotion.com\/johndoe424"

URL of this user's profile on Dailymotion.

stringusername

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: userinfoCan be written when authenticated with the specified scopemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "johndoe424"

User account credentials login.

booleanverified

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the object

Sample value: true

True if this user is a verified partner.

numbervideos_total

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 27

Total amount of public videos of this user.

numberviews_total

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 1239873

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

stringwebsite_url

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the objectmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "http:\/\/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. Follow our API ChangeLog regularly to stay informed about deprecations and upcoming end of life dates.

urlavatar_large_url

This field was deprecated on September 3, 2013.Use the `avatar_480_url`` field instead.End of support: September 3, 2014.

publicPublicly documented and available for allreadableCan be accessed without authentication

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

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

urlavatar_medium_url

This field was deprecated on September 3, 2013.Use the avatar_240_url field instead.End of support: September 3, 2014.

publicPublicly documented and available for allreadableCan be accessed without authentication

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

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

urlavatar_small_url

This field was deprecated on September 3, 2013.Use the avatar_60_url field instead.End of support: September 3, 2014.

publicPublicly documented and available for allreadableCan be accessed without authentication

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

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

urlbackground_url

This field was deprecated on July 21, 2014.The custom skin feature has been discontinued.End of support: July 21, 2015.

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the object

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

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

urlbanner_url

This field was deprecated on July 21, 2014.The custom skin feature has been discontinued.End of support: July 21, 2015.

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the object

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

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

numberfans_total

This field was deprecated on February 23, 2016.Use the followers_total field instead.End of support: August 23, 2016.

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 42

Total amount of fans of this user.

booleanlive_notification_followed_onair

This field was deprecated on September 28, 2016.Use the notification_live_start_streaming field instead.End of support: September 28, 2017.

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the object

Sample value: true

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

stringtype

This field was deprecated on December 5, 2014.Use the partner and verified fields instead.End of support: December 5, 2015.

publicPublicly documented and available for allreadableCan be accessed without authenticationallowed values: ugc, creative, officialCorresponding values have to respect this format

Sample value: "ugc"

Type of user account.

videovideostar

This field was deprecated on November 2, 2017.video star feature is discontinued, please use the features connection instead.End of support: November 2, 2018.

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: manage_videosCan be written when authenticated with the specified scope

Sample value: "xfpdiqb"

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

stringFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: US

Country of residence of this user.

flags

arrayFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this formatallowed values: mostpopular, recommended, partner, verifiedCorresponding values have to respect this format

Sample value: mostpopular,partner

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

ids

arrayFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: xk2k3,x1fz4ii,xw83x45

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

language

stringFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: en

Limit the result set to users using this language.

mostpopular

flagThis filter is a simple boolean flag

Sample value: n/a

Limit the result set to the most popular users.

parent

objectFormat of the expected value

Sample value: xfpdiqb

Limit the result set to children of this user.

partner

flagThis filter is a simple boolean flag

Sample value: n/a

Limit the result set to partner users.

recommended

flagThis filter is a simple boolean flag

Sample value: n/a

Limit the result set to recommended users.

recommendedforchannel

stringFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: news

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

sort

stringFormat of the expected valueallowed values: relevance, popular, activity, recentCorresponding values have to respect this format

Sample value: popular

Change the default result set ordering. Notes:

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

usernames

arrayFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: rs,spi0n

Limit the results set to users with a list of usernames

verified

flagThis filter is a simple boolean 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. Follow our API ChangeLog regularly to stay informed about deprecations and upcoming end of life dates.

filters

This filter was deprecated on January 5, 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 5, 2017.

arrayFormat of the expected valueallowed values: mostpopular, recommended, official, creative, premium, promoted-on-gamesCorresponding values have to respect this format

Sample value: mostpopular

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

list

This filter was deprecated on November 2, 2017.List filter is deprecated.End of support: November 2, 2018.

stringFormat of the expected valueallowed values: recommendedCorresponding values have to respect this format

Sample value: recommended

Limit the result set to this user list.

search

This filter was deprecated on November 2, 2017.User channel Search feature is deprecated.End of support: November 2, 2018.

stringFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

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

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the object

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 /user/<USER_ID>/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 children is connected to an existing user object by issuing a GET request to /user/<USER_ID>/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

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: manage_featuresCan be written when authenticated with the specified scope

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 /user/<USER_ID>/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 feature is connected to an existing user object by issuing a GET request to /user/<USER_ID>/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

publicPublicly documented and available for allreadableCan be accessed without authentication

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 /user/<USER_ID>/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

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: manage_subscriptionsCan be written when authenticated with the specified scope

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 /user/<USER_ID>/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 following is connected to an existing user object by issuing a GET request to /user/<USER_ID>/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

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: manage_likesCan be written when authenticated with the specified scope

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 /user/<USER_ID>/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 like is connected to an existing user object by issuing a GET request to /user/<USER_ID>/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

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the object

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 /user/<USER_ID>/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 parent is connected to an existing user object by issuing a GET request to /user/<USER_ID>/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.

[user]relations

publicPublicly documented and available for allreadableCan be accessed without authentication

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 /user/<USER_ID>/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

publicPublicly documented and available for allreadableCan be accessed without authentication

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 /user/<USER_ID>/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

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: manage_videosCan be written when authenticated with the specified scope

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 /user/<USER_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.

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.

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

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: manage_videosCan be written when authenticated with the specified scope

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 /user/<USER_ID>/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 watchlater is connected to an existing user object by issuing a GET request to /user/<USER_ID>/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. Follow our API ChangeLog regularly to stay informed about deprecations and upcoming end of life dates.

[video]favorites

This filter was deprecated on June 28, 2016.Use the likes endpoint instead.End of support: June 28, 2017.

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: manage_favoritesCan be written when authenticated with the specified scope

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 /user/<USER_ID>/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 favorite is connected to an existing user object by issuing a GET request to /user/<USER_ID>/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.

[video]history

This filter was deprecated on October 31, 2017.Use the watched connection instead.End of support: October 31, 2018.

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: manage_historyCan be written when authenticated with the specified scope

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

Read the user's history connection

You can retrieve the list of history connected to a user object by issuing a GET request to /user/<USER_ID>/history. 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 history is connected to an existing user object by issuing a GET request to /user/<USER_ID>/history/<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 history connection

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

Delete a user's history connection

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

[user]recommended

This filter was deprecated on October 31, 2017.Recommended feature has been discontinued.End of support: January 31, 2018.

publicPublicly documented and available for allreadableCan be accessed without authentication

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 /user/<USER_ID>/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 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 video, perform a POST request on /video/<VIDEO_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 video, perform a DELETE request on /video/<VIDEO_ID>. If you do not receive any error (empty result set), it means that the deletion was successful.

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

Video fields

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

booleanadvertising_instream_blocked

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: false

True if the owner blocked instream ads on this video.

booleanallow_embed

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: manage_videosCan be written when authenticated with the specified scope

Sample value: false

True if this video can be embedded outside of Dailymotion.

booleanallowed_in_playlists

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the object

Sample value: false

True if this video can be added to playlists.

numberaspect_ratio

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 1.7777777

Aspect ratio of this video (i.e.: 1.33333 for 4/3, 1.77777 for 16/9...).

numberaudience

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 450

Current live stream audience. null if the audience shouldn't be taken into consideration.

numberaudience_total

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 2457

Total live stream audience since stream creation. null if the audience shouldn't be taken into account.

arrayavailable_formats

publicPublicly documented and available for allreadableCan be accessed without authenticationallowed values: l1, l2, ld, sd, hq, hd720, hd1080, uhd1440, uhd2160Corresponding values have to respect this format

Sample value: ["ld","sd","hq","hd720","hd1080"]

List of available stream formats for this video.

channelchannel

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the objectdefaultThis field is returned by default when not asking for specific fields

Sample value: "news"

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

stringchecksum

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "\"64f771f2fccff6cef46f2f34112a67ff8e940103\""

Video file hash.

stringcountry

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the objectmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "US"

Country of this video (declarative, may be null).

datecreated_time

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: 1287507036

Date and time when this video was uploaded.

arraycustom_classification

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: manage_videosCan be written when authenticated with the specified scopemin length: 1Corresponding values have to respect this formatmax length: 100Corresponding values have to respect this format

Sample value: ["ref1","ref2","ref3"]

List of customizable values (maximum of 3 values)

stringdescription

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the objectmin length: 1Corresponding values have to respect this formatmax length: 10000Corresponding values have to respect this format

Sample value: "This is a sample description for my video."

Comprehensive description of this video. Maximumm length is set to 3000 (5000 for partners).

numberduration

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 423

Duration of this video in seconds.

stringembed_html

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "<iframe frameborder=\"0\" src=\"http:\/\/www.dailymotion.com\/embed\/video\/x26m1j4\" width=\"480\" height=\"270\""

HTML embedding code.

urlembed_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/www.dailymotion.com\/embed\/video\/x26m1j4"

URL to embed this video.

numberencoding_progress

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: -1Corresponding values have to respect this formatmax value: 100Corresponding values have to respect this format

Sample value: 22

When this video status field is set to processing, this parameter indicates a number between 0 and 100 corresponding to the percentage of encoding already completed. When this value reaches 100, it's possible for the owner to play his video. For other statuses this parameter returns -1. See also publishing_progress.

dateend_time

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the object

Sample value: 1404129540

End date and time of this live stream.

dateexpiry_date

privateRequires authentication to be accessedread scope: manage_videosCan be read when authenticated with the specified scopewrite scope: manage_videosCan be written when authenticated with the specified scope

Sample value: 1287507036

Date and time after which this video will be made private. Beware: if the video was originally defined as private, setting this value will automatically make it public between its publish_date and expiry_date. This setting only affects the visibility of the video, it will still be available to anyone who knows how to access the video's private URL even after this date. Omitting this value while setting a past publish_date never expires the video. Set to null (recommended) or a date after Jan 19th 2038 to reset this parameter.

Note : Only verified partners are allowed to manage video availability and expiration dates.

booleanexpiry_date_deletion

privateRequires authentication to be accessedread scope: manage_videosCan be read when authenticated with the specified scopewrite scope: manage_videosCan be written when authenticated with the specified scope

Sample value: false

By default, videos are deleted (after a grace period) when their expiry_date is reached. Set this to false to disable this behavior.

Note : Only verified partners are allowed to manage video availability and expiration dates.

booleanexplicit

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the object

Sample value: false

True if this video is explicit. Warning: It's not possible to remove this flag once set.

urlfilmstrip_60_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/static2.dmcdn.net\/static\/video\/184\/210\/46012481:jpeg_preview_contact.jpg?20120608161743"

URL of the filmstrip sprite of this video. 100 images arranged in a 10x10 grid. Not available for short videos.

arraygenres

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: manage_videosCan be written when authenticated with the specified scopemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: ["cuban","jazz","roots-reggae"]

List of genres of a given video.

arraygeoblocking

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: manage_videosCan be written when authenticated with the specified scopemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: ["allow","fr","us","it"]

List of countries where this video is or isn't accessible. A list of country codes (ISO 3166-1 alpha-2) starting with the deny or allow (default) keyword to define if this is a black or a whitelist, e.g.: both ["allow", "fr", "us", "it"] and ["fr", "us", "it"] will allow this video to be accessed in France, US and Italy and deny all other countries. On the other hand, ["deny", "us", "fr"] will deny access to this video in the US and France and allow it everywhere else. An empty list [] or simply ["allow"] (the default) will revert the behavior to allow from everywhere. To set geoblocking on your videos, you have to be a Dailymotion partner.

arraygeoloc

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the objectmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: [-122.40061283112,37.782112059896]

Geolocalization for this video. Result is an array with the longitude and latitude using point notation. Longitude range is from -180.0 (West) to 180.0 (East). Latitude range is from -90.0 (South) to 90.0 (North).

numberheight

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 240

Height of this video from the source (px).

stringid

publicPublicly documented and available for allreadableCan be accessed without authenticationdefaultThis field is returned by default when not asking for specific fields

Sample value: "xolzire"

Unique object identifier (unique among all videos)

stringitem_type

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "video"

Graph type of this object (hopefully video)

stringlanguage

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the objectmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "en"

Language of this video. This value is declarative and corresponds to the user-declared spoken language of the video. Allowed values are ISO-639-3 alpha-2 and alpha-3 language codes.

dateliked_at

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: 1287507036

Date and time when this video was liked by the user.

numberlikes_total

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 102

Total amount of times this video has been liked.

datelive_airing_time

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: 1287507036

Date and time when this live stream went on-air for the last time

numberlive_audio_bitrate

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 125928

Live stream information: audio bitrate (b/s)

dictlive_ingests

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: {"Default":"publish.dailymotion.com"}

List of available live ingests.

urllive_publish_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "rtmp:\/\/publish.dailymotion.com\/publish-dm\/x26m1j4?auth=..."

URL to publish the live source stream on. The current logged in user need to own this video in order to retrieve this field.

Reading and/or editing this field requires some contextual information. Please refer to the API global parameters list for more information about context.

Context	Description	Required	For reading	For writing
refresh	Pass this context value (refresh=true) if you need to refresh the stream key for the publish URL.	No	Yes	No

stringmedia_type

publicPublicly documented and available for allreadableCan be accessed without authenticationallowed values: audio, videoCorresponding values have to respect this format

Sample value: "video"

Media type of this content.

stringmode

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the objectallowed values: vod, liveCorresponding values have to respect this format

Sample value: "vod"

Stream mode.

arraymoods

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: manage_videosCan be written when authenticated with the specified scopemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: ["energizing","party-fun","upbeat"]

List of moods of a given video.

booleanonair

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: false

True if this live stream is broadcasting and watchable in the player.

userowner

publicPublicly documented and available for allreadableCan be accessed without authenticationdefaultThis field is returned by default when not asking for specific fields

Sample value: "xdgky1x"

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

booleanpartner

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: false

True if the video is owned by a partner.

stringpassword

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the objectmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "hdI76FGhwo3n"

If a video is protected by a password, this field contains the password. When setting a value on this field, the video visibility changes to "password protected". Setting it to NULL removes the password protection: the visibility is changed to "public".

booleanpassword_protected

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: true

True if this video is password-protected.

videoplayer_next_video

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: manage_videosCan be written when authenticated with the specified scope

Sample value: "xdgky1x"

A unique video picked by the owner, displayed when video's playback ends. You can retrieve sub-fields of this video object using the dot-notation (e.g.: player_next_video.id).

arrayplayer_next_videos

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: ["x1234","x1234"]

An array of video picked by the owner, displayed when video's playback ends.

booleanprivate

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the object

Sample value: true

True if this video is private.

stringprivate_id

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "k1KqUqDdmllgej374a2"

The private video id. Null if the authentificated user is not the owner of this video. Although successive calls will generate different ids, a private id generated for a given video will always be valid. Beware that if the video is private and you disclose this private id, your video is no longer private.

datepublish_date

privateRequires authentication to be accessedread scope: manage_videosCan be read when authenticated with the specified scopewrite scope: manage_videosCan be written when authenticated with the specified scope

Sample value: 1287507036

Date and time after which this video will be made publicly available. Beware: if the video was originally defined as private, setting this value will automatically make it public after the publish_date. This setting only affects the visibility of the video, it will still be available to anyone who knows how to access the video's private URL even before this date. Omitting this value while setting a future expiry_date immediately publishes the video. Set to null (recommended) or a date before Jan 1st 1990 to reset this parameter.

Note : Only verified partners are allowed to manage video availability and expiration dates.

booleanpublished

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the object

Sample value: false

True if this video is published (may still be waiting for encoding, see the status field for more information).

numberpublishing_progress

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this formatmax value: 100Corresponding values have to respect this format

Sample value: 22

When this video status field is set to processing, this parameter indicates a number between 0 and 100 corresponding to the percentage of progress from the status waiting to ready. Unlike encoding_progress that can reach 100 well before the switch from processing to ready, this value will not.

daterecord_end_time

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: 1287507036

Date and time when the video record was stopped.

daterecord_start_time

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: 1287507036

Date and time when the video record started.

stringrecord_status

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: manage_recordsCan be written when authenticated with the specified scopeallowed values: starting, started, stopping, stoppedCorresponding values have to respect this format

Sample value: "started"

Current state of the recording process of this video.

• starting: Recording video is going to start
  
• started: Recording video is in progress
  
• stopping: Recording video is going to stop
  
• stopped: Recording video is stopped

stringrecurrence

publicPublicly documented and available for allreadableCan be accessed without authenticationallowed values: once, daily, weeklyCorresponding values have to respect this format

Sample value: "daily"

Recurrence of this live stream.

stringsoundtrack_isrc

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: manage_videosCan be written when authenticated with the specified scopemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "FR-6V8-21-83311"

The International Standard Recording Code of the soundtrack associated to this video.

numbersoundtrack_popularity

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: manage_videosCan be written when authenticated with the specified scopemin value: 0Corresponding values have to respect this format

Sample value: 100

Soundtrack popularity.

urlsprite_320x_url

publicPublicly documented and available for allreadableCan be accessed without authentication

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

URL of the sprite of this video, width:320px

urlsprite_url

publicPublicly documented and available for allreadableCan be accessed without authentication

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

URL of the sprite of this video.

datestart_time

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the object

Sample value: 1287507036

Start date and time of this live stream.

stringstatus

publicPublicly documented and available for allreadableCan be accessed without authenticationallowed values: waiting, processing, ready, published, rejected, deleted, encoding_errorCorresponding values have to respect this format

Sample value: "processing"

Status of this video. A video requires the published status to be set to true to be watchable.

arraytags

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the objectmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: ["party","John Doe"]

List of tags attached to this video.

urlthumbnail_60_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s2.dmcdn.net\/F83Oh\/x60-sjB.jpg"

URL of this video's thumbnail image (60px height).

urlthumbnail_120_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s2.dmcdn.net\/CTrg1\/x120-Zfs.jpg"

URL of this video's thumbnail image (120px height).

urlthumbnail_180_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s2.dmcdn.net\/CTrg1\/x180-o-x.jpg"

URL of this video's thumbnail image (180px height).

urlthumbnail_240_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s2.dmcdn.net\/CTrg1\/x240-tGY.jpg"

URL of this video's thumbnail image (240px height).

urlthumbnail_360_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s2.dmcdn.net\/CTrg1\/x360-KuJ.jpg"

URL of this video's thumbnail image (360px height).

urlthumbnail_480_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s2.dmcdn.net\/CTrg1\/x480-hw4.jpg"

URL of this video's thumbnail image (480px height).

urlthumbnail_720_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s2.dmcdn.net\/CTrg1\/x720-Ec7.jpg"

URL of this video's thumbnail image (720px height).

urlthumbnail_1080_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s2.dmcdn.net\/CTrg1\/x1080-Ec7.jpg"

URL of this video's thumbnail image (1080px height).

urlthumbnail_url

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the object

Sample value: "http:\/\/s2.dmcdn.net\/CTrg1.jpg"

URL of this video's raw thumbnail (full size respecting ratio). Some users have the permission to change this value by providing an URL to a custom thumbnail. Note: for live streams, the thumbnail is automatically generated every 5 mn by default; it is not possible anymore to manually refresh the preview.

urltiny_url

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/dai.ly\/sk2k3jd"

Tiny URL of this video.

stringtitle

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the objectdefaultThis field is returned by default when not asking for specific fieldsmin length: 1Corresponding values have to respect this formatmax length: 255Corresponding values have to respect this format

Sample value: "My video title"

Title of this video.

dateupdated_time

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: 1404129540

Date and time when this video was last updated.

urlurl

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the object

Sample value: "http:\/\/www.dailymotion.com\/video\/x26m1j4_wildlife_animals"

URL of this video on Dailymotion. Writing this parameter defines where to download the video source. You may either use this parameter at video creation time or change this parameter later if you want to change this video source afterward. To change an existing video, the authenticated user may need some additional permissions. When replacing an existing source, the video will put offline for a few minutes during the re-encoding. You may use the GET /file/upload API resource to upload a video file and create a URL to provide to this method or use an existing URL pointing to your own video file. Writing to this parameter is subject to rate limiting.

booleanverified

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: false

True if the video is owned by a verified partner.

numberviews_last_day

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 203

Total number of views on this video in the last 24 sliding hours.

numberviews_last_hour

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 102

Total number of views on this video in the last sliding hour.

numberviews_last_month

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 4023

Total number of views on this video in the last 30 sliding days.

numberviews_last_week

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 1030

Total number of views on this video in the last 7 sliding days.

numberviews_total

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 10203

Total amount of views on this video since its publication.

numberwidth

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 320

Width of this video from the source (px).

Video 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. Follow our API ChangeLog regularly to stay informed about deprecations and upcoming end of life dates.

boolean3d

This field was deprecated on August 14, 2015.This feature is now deprecatedEnd of support: February 14, 2016.

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: false

True if this video is in 3D format.

booleanallowed_in_groups

This field was deprecated on June 18, 2015.The group feature have been discontinued, please use playlists.End of support: August 18, 2015.

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the object

Sample value: false

True if this video can be added to groups.

numberbookmarks_total

This field was deprecated on June 28, 2016.Use the likes_total endpoint instead.End of support: June 28, 2017.

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 102

Total amount of times this video has been added to a user's favorites.

booleanbroadcasting

This field was deprecated on January 5, 2016.Use live_is_visible instead of broadcastingEnd of support: January 5, 2017.

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: false

True if this live stream is ready for delivery.

stringduration_formatted

This field was deprecated on January 20, 2016.Use the duration field instead.End of support: July 20, 2016.

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "07:03"

Duration of this video (human readable).

datefavorited_at

This field was deprecated on June 28, 2016.Use the liked_at endpoint instead.End of support: June 28, 2017.

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: 1287507036

Date and time when this video was bookmarked by the current user.

urlfilmstrip_small_url

This field was deprecated on August 26, 2014.This field returns the sprite URL, please use the filmstrip_60_url field to retrieve the real filmstrip URL.End of support: August 26, 2015.

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/static2.dmcdn.net\/static\/video\/265\/246\/128642562:jpeg_preview_sprite.jpg?20140826113227"

Sprite URL of snapshots of this video if it exists.

stringisrc

This field was deprecated on July 14, 2015.Use the soundtrack_isrc field instead.End of support: July 14, 2016.

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "FR-6V8-21-83311"

Detected ISRC (International Standard Recording Code) of the soundtrack.

booleanlive_broadcasting

This field was deprecated on July 1, 2016.Use live_is_visible instead of live_broadcastingEnd of support: July 1, 2017.

publicPublicly documented and available for allreadableCan be accessed without authenticationwrite scope: manage_videosCan be written when authenticated with the specified scope

Sample value: false

False if this live stream is only visible by his owner.

datemodified_time

This field was deprecated on July 2, 2014.Use the updated_time field instead.End of support: July 2, 2015.

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: 1287507036

Date and time when this video was last modified.

stringmuyap

This field was deprecated on July 14, 2015.Use the soundtrack_muyap field instead.End of support: July 14, 2016.

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "BXjVm33LBNCIGfS6GBNw4A=="

Detected MUYAP (Turkish Phonographic Industry Society Identifier) of the soundtrack.

urlowner_avatar_large_url

This field was deprecated on June 4, 2013.Use the owner.avatar_large_url syntax instead.End of support: June 4, 2015.

publicPublicly documented and available for allreadableCan be accessed without authentication

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

URL of the avatar image of the owner of this video (160px by 160px).

urlowner_avatar_medium_url

This field was deprecated on June 4, 2013.Use the owner.avatar_medium_url syntax instead.End of support: June 4, 2015.

publicPublicly documented and available for allreadableCan be accessed without authentication

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

URL of the avatar image of the owner of this video (80px by 80px).

urlowner_avatar_small_url

This field was deprecated on June 4, 2013.Use the owner.avatar_small_url syntax instead.End of support: June 4, 2015.

publicPublicly documented and available for allreadableCan be accessed without authentication

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

URL of the avatar image of the owner of this video (40px by 40px).

stringowner_fullname

This field was deprecated on June 4, 2013.Use the owner.fullname field instead.End of support: June 4, 2015.

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "John Doe"

Full name of the owner of this video.

stringowner_screenname

This field was deprecated on June 4, 2013.Use the owner.screenname field instead.End of support: June 4, 2015.

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "johndoe424"

Username or fullname of the owner of this video, depending on user preference.

urlowner_url

This field was deprecated on June 4, 2013.Use the owner.url field instead.End of support: June 4, 2015.

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/www.dailymotion.com\/johndoe424"

URL of the owner of this video.

stringowner_username

This field was deprecated on June 4, 2013.Use the owner.username field instead.End of support: June 4, 2015.

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "johndoe424"

Username of the owner of this video.

numberrating

This field was deprecated on November 26, 2014.The rating feature has been discontinued.End of support: November 26, 2015.

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this formatmax value: 5Corresponding values have to respect this format

Sample value: 3.4

Average number of stars this video has received as a float.

numberratings_total

This field was deprecated on November 26, 2014.The rating feature has been discontinued.End of support: November 26, 2015.

publicPublicly documented and available for allreadableCan be accessed without authenticationmin value: 0Corresponding values have to respect this format

Sample value: 124

Total amount of users who voted for this video.

stringrental_price

This field was deprecated on March 13, 2018.Svod/Tvod features are discontinued.End of support: September 13, 2018.

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the objectmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "1.95"

Price of renting this video as a float in the current currency or null if this video is not behind a paywall. See the currency field of the /locale endpoint to retrieve the current currency.

stringrental_price_formatted

This field was deprecated on January 20, 2016.Use the rental_price field instead.End of support: July 20, 2016.

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "$1.95"

Price of renting this video, formatted with currency according to the request localization. Will be null if this video is not behind a paywall.

arraystrongtags

This field was deprecated on July 24, 2014.Use the strongtags connection instead.End of support: July 24, 2015.

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: ["John Doe","United States of America"]

List of strong tags attached to this video.

urlswf_url

This field was deprecated on November 30, 2015.Used by the legacy player v4, not supported by the new video player.End of support: November 30, 2016.

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/www.dailymotion.com\/swf\/video\/x26m1j4"

URL of the legacy SWF embed player (only use this to embed the player into a flash movie, otherwise use embed_url).

urlthumbnail_large_url

This field was deprecated on June 11, 2013.Use the thumbnail_240_url field instead.End of support: June 11, 2015.

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/ak.dailymotion.com\/thumbnail\/x26m1j4\/large.jpg"

URL of this video thumbnail image (320px by 240px).

urlthumbnail_medium_url

This field was deprecated on June 11, 2013.Use the thumbnail_120_url field instead.End of support: June 11, 2015.

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/ak.dailymotion.com\/thumbnail\/x26m1j4\/medium.jpg"

URL of this video thumbnail image (160px by 120px).

urlthumbnail_small_url

This field was deprecated on June 11, 2013.Use the thumbnail_60_url field instead.End of support: June 11, 2015.

publicPublicly documented and available for allreadableCan be accessed without authentication

Sample value: "http:\/\/s2.dmcdn.net\/CTrg1\/small.jpg"

URL of this video thumbnail image (80px by 60px).

stringtype

This field was deprecated on February 20, 2015.Use the partner or verified fields insteadEnd of support: February 20, 2016.

publicPublicly documented and available for allreadableCan be accessed without authenticationwritableCan be written if authenticated and owner of the objectallowed values: ugc, creative, officialCorresponding values have to respect this format

Sample value: "ugc"

Content type of this video (can be official, creative or null).

stringupc

This field was deprecated on July 14, 2015.Use the soundtrack_upc field instead.End of support: July 14, 2016.

publicPublicly documented and available for allreadableCan be accessed without authenticationmin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: "3610154759952"

Detected UPC (Universal Product Code) of the soundtrack.

Video filters

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

360_degree

flagThis filter is a simple boolean flag

Sample value: n/a

Limit the result set to 360 videos.

availability

booleanFormat of the expected value

Sample value: false

Limit the result set to available videos.

channel

objectFormat of the expected value

Sample value: news

Limit the result set to this channel.

country

stringFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: US

Limit the result set to this country (declarative).

created_after

dateFormat of the expected value

Sample value: 1287507036

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

created_before

dateFormat of the expected value

Sample value: 1287507036

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

exclude_ids

arrayFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: xk2k3,x26m1j4,xkeg4

List of video ids to exclude from the result set.

exportable

flagThis filter is a simple boolean flag

Sample value: n/a

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

featured

flagThis filter is a simple boolean flag

Sample value: n/a

Limit the result set to featured videos.

flags

arrayFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this formatallowed values: featured, hd, ugc, live, no_live, live_onair, live_offair, live_upcoming, has_game, premium, no_premium, in_history, 360_degree, availability, private, unpublished, exportable, partner, verified, password_protectedCorresponding values have to respect this format

Sample value: featured,hd

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

has_game

flagThis filter is a simple boolean flag

Sample value: n/a

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

hd

flagThis filter is a simple boolean flag

Sample value: n/a

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

ids

arrayFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: xk2k3,x26m1j4,xkeg4

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

in_history

flagThis filter is a simple boolean flag

Sample value: n/a

Limit the result set to videos in your watch history.

languages

arrayFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: fr,en,it

Limit the result set to this list of languages. Language is declarative and corresponds to the user-declared spoken language of the video. If you wish to retrieve content currated for a specific locale, use the localization global parameter instead.

list

stringFormat of the expected valueallowed values: what-to-watch, recommendedCorresponding values have to respect this format

Sample value: what-to-watch

Limit the result set to this video list.

live

flagThis filter is a simple boolean flag

Sample value: n/a

Limit the result set to live streaming videos.

live_offair

flagThis filter is a simple boolean flag

Sample value: n/a

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

live_onair

flagThis filter is a simple boolean flag

Sample value: n/a

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

live_upcoming

flagThis filter is a simple boolean flag

Sample value: n/a

Limit the result set to upcoming live streaming videos.

longer_than

numberFormat of the expected valuemin value: 0Corresponding values have to respect this format

Sample value: 3600

Limit the results to videos with a duration longer than or equal to the specified number of minutes.

no_live

flagThis filter is a simple boolean flag

Sample value: n/a

Limit the result set to non-live streaming videos.

no_premium

flagThis filter is a simple boolean flag

Sample value: n/a

Limit the result set to free video content.

nogenre

stringFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: Comedy

Limit the result set by excluding this genre.

owners

arrayFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: user1,user2,user3

Limit the result set to this list of user identifiers or logins.

partner

flagThis filter is a simple boolean flag

Sample value: n/a

Limit the result set to partner videos.

password_protected

flagThis filter is a simple boolean flag

Sample value: n/a

Limit the result set to password protected partner videos.

premium

flagThis filter is a simple boolean flag

Sample value: n/a

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

private

booleanFormat of the expected value

Sample value: true

Limit the result set to private videos.

related_videos_algorithm

stringFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this formatallowed values: uploader-only, uploader-with-siblings, uploader-with-parent, uploader-with-childrenCorresponding values have to respect this format

Sample value: "uploader-only"

Forces the recommendation result to use a specifc algorithm

search

stringFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: football

Limit the result set to this full text search.

shorter_than

numberFormat of the expected valuemin value: 0Corresponding values have to respect this format

Sample value: 60

Limit the results to videos with a duration shorter than or equal to the specified number of minutes.

sort

stringFormat of the expected valueallowed values: recent, visited, visited-hour, visited-today, visited-week, visited-month, relevance, random, trending, old, live-audience, least-visited, live-airing-timeCorresponding values have to respect this format

Sample value: visited

Change the default result set ordering. Notes:

• the relevance filter can only be used in conjunction with the search filter.
• Deprecated sorts (ranking, rated, rated-hour, rated-today, rated-week, rated-month, commented, commented-hour, commented-today, commented-week, commented-month)

strongtags

arrayFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: John Doe,United States of America

Limit the result set to this strong tag.

tags

arrayFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: party,John Doe

Limit the result set to this full text search of video tags. By default perform 'AND' operation between terms. Use enclosing parenthesis '()' on the query to perform 'OR' operation.

ugc

flagThis filter is a simple boolean flag

Sample value: n/a

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

unpublished

booleanFormat of the expected value

Sample value: false

Limit the result set to unpublished videos.

verified

flagThis filter is a simple boolean flag

Sample value: n/a

Limit the result set to verified partner videos.

Video 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. Follow our API ChangeLog regularly to stay informed about deprecations and upcoming end of life dates.

3d

This filter was deprecated on August 14, 2015.This feature is now deprecatedEnd of support: February 14, 2016.

flagThis filter is a simple boolean flag

Sample value: n/a

Limit the result set to 3D videos.

filters

This filter was deprecated on January 5, 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,hd becomes ?flags=featured,hd or simply ?featured&hd).End of support: January 5, 2017.

arrayFormat of the expected valueallowed values: featured, hd, official, creative, creative-official, ugc, 3d, live, live-offair, game, all-live, live-upcoming, no-live, premium, premium-paidvideos, premium-offers, no-premium, history, with-poster, without-poster, promoted-on-gamesCorresponding values have to respect this format

Sample value: featured,hd

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

language

This filter was deprecated on July 2, 2014.Use the languages filter instead (supports multiple languages).End of support: July 2, 2015.

stringFormat of the expected valuemin length: 1Corresponding values have to respect this formatmax length: 150Corresponding values have to respect this format

Sample value: en

Limit the result set to this language. This value is declarative and corresponds to the user-declared spoken language of the video. If you wish to retrieve content currated for a specific locale, use the localization global parameter instead.

modified_after

This filter was deprecated on January 22, 2015.The modified_after feature has been discontinued. See the created_after field for a workaround.End of support: January 22, 2016.

dateFormat of the expected value

Sample value: 1287507036

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

modified_before

This filter was deprecated on January 22, 2015.The modified_before feature has been discontinued. See the created_before field for a workaround.End of support: January 22, 2016.

dateFormat of the expected value

Sample value: 1287507036

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

owner

This filter was deprecated on July 3, 2014.Use the owners filter instead (supports multiple owners).End of support: July 3, 2015.

objectFormat of the expected value

Sample value: xdgky1x

Limit the result set to videos of this user.