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:0
, false
and no
all resolve to false
1
, true
and yes
all resolve to true
Examplestrue
false
/video/x84sh87?published=1
/video/x84sh87?published=false
Date
A date expressed as a UNIX timestamp (number of seconds since the UNIX Epoch)
Examples0
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}
An email address.
It doesn’t imply that the address actually resolves to any inbox.
Examplesuser@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
Examples0
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
Examplesuser
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
Exampleshttp://www.dailymotion.com/videos
https://www.dailymotion.com/video/x84sh87
/video/x84sh87url=https%3A%2F%2Fwww.dailymotion.com%2Fvideo%2Fx26ezrb