Understand the different data types

📘

You are reading API v2 documentation

Still using the Legacy API? Access the Legacy API documentation.



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"]
  • /videos/x84sh87?hashtags=elements,separated,with,commas
  • /videos/x84sh87?hashtags=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
  • /videos/x84sh87?published=1
  • /videos/x84sh87?published=false
Date

A date expressed is ISO 8601 format.

Examples:

  • 2026-01-01T00:00:00Z
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:

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://developers.dailymotion.com/reference/user-fields#id)
  • [video](https://developers.dailymotion.com/reference/video-fields#id)
  • /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