Table of content

Understand the different data types


Each field and filter accepts a certain type of data. 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.

Array

An unordered collection of scalar data types (most likely strings or numbers). Elements are listed between square brackets and separated by commas.
To input arrays, simply separate each element with commas.

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

Boolean

A binary value than can only be true or false.
To input booleans:
0false and no all resolve to false
1true and yes all resolve to true

Examples
true
false
/video/x84sh87?published=1
/video/x84sh87?published=false

Date

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

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

Dict

A dict is a map that organizes data by associating values to keys

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

Email

An email address.
It doesn’t imply that the address actually resolves to any inbox.

Examples
user@example.org
example+value@email.com
/user/x1fz4ii?email=user%40example.org

Flag

A 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 will be ignored.

Examples
Here are the two different ways to use it:
/videos?flags=featured,hd,no_live (recommended)
/videos?featured&hd&no_live

Number

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

Examples
0
4
2.95
/player/xbzld?autoskip_after=15

Object

Any Dailymotion API object, which means that the returned value will be a unique identifier.
To input a specific object, simply provide its unique identifier

Examples
user
video
/video/x84sh87

String

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

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

URL

Any URL
It doesn’t imply that the URL actually exists

Examples
http://www.dailymotion.com/videos
https://www.dailymotion.com/video/x84sh87
/video/x84sh87url=https%3A%2F%2Fwww.dailymotion.com%2Fvideo%2Fx26ezrb