Understand the different data types

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:

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](https://dailymotion.readme.io/reference/user#/)
  • [video](https://dailymotion.readme.io/reference/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