List of fields to return for requests in the user object. Retrieve them using the fields query-string parameter on any user object request.
API v2 now availableVisit the API v2 documentation or follow the migration guide to upgrade.
| Fields | Description |
|---|---|
active | Force user account active. |
address | Postal address of this user. |
avatar_25_url | URL of this user’s avatar image (25px wide square) |
avatar_60_url | URL of this user’s avatar image (60px wide square) |
avatar_80_url | URL of this user’s avatar image (80px wide square) |
avatar_120_url | URL of this user’s avatar image (120px wide square) |
avatar_190_url | URL of this user’s avatar image (190px wide square) |
avatar_240_url | URL of this user’s avatar image (240px wide square) |
avatar_360_url | URL of this user’s avatar image (360px wide square) |
avatar_480_url | URL of this user’s avatar image (480px wide square) |
avatar_720_url | URL of this user’s avatar image (720px wide square) |
avatar_url | URL of an image to change this user’s avatar. |
ban_from_partner_program | True if this user has the criteria ban-from-partner-program. |
birthday | Birthday date of this user. |
children_total | Total number of associated children profiles. |
city | City of residence of this user. |
country | Country of residence of this user. |
cover_100_url | URL of this user’s cover image (height = 100px) |
cover_150_url | URL of this user’s cover image (height = 150px). |
cover_200_url | URL of this user’s cover image (height = 200px). |
cover_250_url | URL of this user’s cover image (height = 250px). |
cover_url | URL of this user’s cover image (original size). |
created_time | Date and time when this user joined the site. |
description | Comprehensive description of this user. |
email | Email address of this user. |
facebook_url | Facebook profile URL of this user. |
first_name | First name of this user. |
followers_total | Total amount of followers of this user. |
following_total | Total amount of users this user is following. |
fullname | Full name of this user. |
gender | Gender of this user. |
id | Unique object identifier (unique among all users). |
instagram_url | Instagram profile URL of this user. |
is_following | True if the authenticated user is following this user. If no user is authenticated, it will always return false. |
item_type | Graph type of this object (hopefully user). |
language | Language used by this user. |
last_name | Last name of this user. |
limits | Returns the various user limits like the maximum allowed duration and size per uploaded video etc. |
linkedin_url | Linkedin profile URL of this user. |
parent | Identifier of this user’s parent profile. |
partner | When the partner field is set. |
pinterest_url | Pinterest profile URL of this user. |
playlists_total | Total amount of playlists of this user. |
revenues_claim_last_day | Total amount of net revenues in USD generated through claim the last day. |
revenues_claim_last_month | Total amount of net revenues in USD generated through claim the last month. |
revenues_claim_last_week | Total amount of net revenues in USD generated through claim in the last 7 days. |
revenues_claim_total | Total amount of net revenues in USD generated through claim since the beginning. |
revenues_paidcontent_last_day | Total amount of net revenues in USD generated through the paid content the last day. |
revenues_paidcontent_last_month | Total amount of net revenues in USD generated through the paid content the last month. |
revenues_paidcontent_last_week | Total amount of net revenues in USD generated through the paid content in the last 7 days. |
revenues_paidcontent_total | Total amount of net revenues in USD generated through the paid content since the beginning. |
revenues_video_last_day | Total amount of net revenues in USD generated through the video monetization the last day. |
revenues_video_last_month | Total amount of net revenues in USD generated through the video monetization the last month. |
revenues_video_last_week | Total amount of net revenues in USD generated through the video monetization in the last 7 days. |
revenues_video_total | Total amount of net revenues in USD generated through the video monetization since the beginning. |
revenues_website_last_day | Total amount of net revenues in USD generated through the website monetization the last day. |
revenues_website_last_month | Total amount of net revenues in USD generated through the website monetization the last month. |
revenues_website_last_week | Total amount of net revenues in USD generated through the website monetization in the last 7 days. |
revenues_website_total | Total amount of net revenues in USD generated through the website monetization since the beginning |
screenname | Returns this user’s full name or login depending on the user’s preferences. |
status | Current user account status. |
twitter_url | X profile URL of this user. |
url | Dailymotion profile URL of this user. |
username | User account credentials login. |
username_update_required | True if this user needs to update his username, False otherwise. |
verified | True if this user is a verified partner. |
videos_total | Total amount of public videos of this user. |
views_total | Total aggregated number of views on all of this user’s videos. |
website_url | Personal website URL of this user. |
active
activeVerify if the user account is active.
| Type | Sample value | Read access | Write access |
|---|---|---|---|
| string | y | Public | N/A |
address
addressPostal address of this user.
minimum lenght: 1 characters / max lenght: 150 characters
| Type | Sample value | Read access | Write access |
|---|---|---|---|
| string | 715 5th Avenue | Private, can be accessed when userinfo scope | Private, can be accessed when userinfo scope |
avatar_25_url
avatar_25_urlURL of this user’s avatar image (25px wide square)
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s1.dmcdn.net/AVM/25x25--w1.png | Public | N/A |
avatar_60_url
avatar_60_urlURL of this user’s avatar image (60px wide square)
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s1.dmcdn.net/AVM/60x60-As1.png | Public | N/A |
avatar_80_url
avatar_80_urlURL of this user’s avatar image (80px wide square).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s1.dmcdn.net/AVM/80x80-Rf1.png | Public | N/A |
avatar_120_url
avatar_120_urlURL of this user’s avatar image (120px wide square).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s1.dmcdn.net/AVM/120x120-bn1.png | Public | N/A |
avatar_190_url
avatar_190_urlURL of this user’s avatar image (190px wide square).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s1.dmcdn.net/AVM/190x190-ma1.png | Public | N/A |
avatar_240_url
avatar_240_urlURL of this user’s avatar image (240px wide square).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s1.dmcdn.net/AVM/240x240-sU1.png | Public | N/A |
avatar_360_url
avatar_360_urlURL of this user’s avatar image (360px wide square).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s1.dmcdn.net/AVM/360x360-PM1.png | Public | N/A |
avatar_480_url
avatar_480_urlURL of this user’s avatar image (480px wide square).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s1.dmcdn.net/AVM/480x480-CD1.png | Public | N/A |
avatar_720_url
avatar_720_urlURL of this user’s avatar image (720px wide square).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s1.dmcdn.net/AVM/720x720-Gr1.png | Public | N/A |
avatar_url
avatar_urlURL of an image to change this user’s avatar (write-only)
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | http://www.example.org | N/A | Requires authentication to be accessed |
ban_from_partner_program
ban_from_partner_programTrue if this user has the criteria ban-from-partner-program.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| boolean | false | Private, requires user-manager role | Private, requires user-manager role |
birthday
birthdayBirthday date of this user.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| date | 532652400 | Private, requires userinfo scope | Private, requires userinfo scope |
children_total
children_totalTotal number of user children.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| number | 10 | Public | N/A |
city
cityCity of residence of this user.
Min length: 1 / Max length: 150
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| string | New York City | Public | Private, requires userinfo scope |
country
countryCountry of residence of this user. Allowed values are ISO 3166-1 alpha-2 country codes.
Min length: 1 / Max length: 150
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| string | US | Public | Private, requires userinfo scope |
cover_100_url
cover_100_urlURL of this user’s cover image (height = 100px).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s2.dmcdn.net/GJCWj/x100-qZJ.jpg | Public | N/A |
cover_150_url
cover_150_urlURL of this user’s cover image (height = 150px).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s2.dmcdn.net/GJCWj/x150-KrI.jpg | Public | N/A |
cover_200_url
cover_200_urlURL of this user’s cover image (height = 200px).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s2.dmcdn.net/GJCWj/x200--y5.jpg | Public | N/A |
cover_250_url
cover_250_urlURL of this user’s cover image (height = 250px).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s2.dmcdn.net/GJCWj/x250-u-x.jpg | Public | N/A |
cover_url
cover_urlURL of this user’s cover image (original size).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | http://www.example.org | Public | Private, can be written by the owner of the object |
created_time
created_timeDate and time when this user joined the site.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| date | 1287507036 | Public | N/A |
description
descriptionComprehensive description of this user.
Min length: 1 / Max length: 2000
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| string | Hi, I'm <i>John</i> and I'm here to break <b>everything</b>! | Public | Private, can be written by the owner of the object |
email
emailEmail address of this user..
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
[email protected] | Private, requires email scope | Private, requires email scope |
facebook_url
facebook_urlFacebook profile URL of this user.
Min length: 1 / Max length: 400
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| string | https://www.facebook.com/johndoe424 | Public | Private, can be written by the owner of the object |
first_name
first_nameFirst name of this user.
Min length: 1 / Max length: 150
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| string | John | Private, requires userinfo scope | Private, requires userinfo scope |
followers_total
followers_totalTotal amount of followers of this user.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| number | 42 | Public | N/A |
following_total
following_totalTotal amount of users this user is following.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| number | 42 | Public | N/A |
fullname
fullnameFull name of this user.
Min length: 1 / Max length: 50
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| string | John Doe | Private, requires userinfo scope | Private, requires userinfo scope |
gender
genderGender of this user.
allowed values: male female other prefer-not-to-answer
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| string | male | Public | Private, can be written by the owner of the object |
id
idUnique object identifier (unique among all users)
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| string | xna9gn9 | Public | N/A |
instagram_url
instagram_urlInstagram profile URL of this user.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| string | https://www.instagram.com/johndoe424 | Public | Private, can be written by the owner of the object |
is_following
is_followingTrue if the authenticated user is following this user. If no user is authenticated, it will always return false
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| boolean | false | Public | N/A |
item_type
item_typeGraph type of this object (hopefully user)
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| string | user | Public | N/A |
language
languageLanguage used by this user. Allowed values are ISO-639-3 alpha-2 and alpha-3 language codes.
Min length: 1 / Max length: 150
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| string | en | Public | Private, can be written by the owner of the object |
last_name
last_nameLast name of this user.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| string | Doe | Private, requires userinfo scope | Private, requires userinfo scope |
limits
limitsReturns 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.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| dict | {"video_duration":3600,"video_size":2147483648} | Private, requires userinfo scope | N/A |
linkedin_url
linkedin_urlLinkedIn profile URL of this user.
Min length: 1 / Max length: 150
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| string | https://www.linkedin.com/in/johndoe424 | Public | Private, can be written by the owner of the object |
parent
parentIdentifier 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).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| user | x9tz791 | Public | N/A |
partner
partnerWhen the partner field is set, the user auto-accepts the T&Cs (https://www.dailymotion.com/legal/partner) and becomes a partner. Returns True if this user is a partner.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| boolean | false | Public | N/A |
pinterest_url
pinterest_urlPinterest profile URL of this user.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| string | https://pinterest.com/dailymotionusa/ | Public | Private, requires userinfo scope |
playlists_total
playlists_totalTotal amount of playlists of this user.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | 14 | Public | N/A |
reposts_total
reposts_totalThe number of videos reposted by the user.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | 14 | Public | N/A |
revenues_claim_last_day
revenues_claim_last_dayTotal amount of net revenues in USD generated through claim the last day.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| number | 12 | Private, requires read_insights scope | N/A |
revenues_claim_last_month
revenues_claim_last_monthTotal amount of net revenues in USD generated through claim the last month.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| number | 310.2 | Private, requires read_insights scope | N/A |
revenues_claim_last_week
revenues_claim_last_weekTotal amount of net revenues in USD generated through claim in the last 7 sliding days..
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| number | 80.7 | Private, requires read_insights scope | N/A |
revenues_claim_total
revenues_claim_totalTotal amount of net revenues in USD generated through claim since the beginning
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| number | 2502.37 | Private, requires read_insights scope | N/A |
revenues_paidcontent_last_day
revenues_paidcontent_last_dayTotal amount of net revenues in USD generated through the paid content the last day..
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| number | 12 | Private, requires read_insights scope | N/A |
revenues_paidcontent_last_month
revenues_paidcontent_last_monthTotal amount of net revenues in USD generated through the paid content the last month.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| number | 310.2 | Private, requires read_insights scope | N/A |
revenues_paidcontent_last_week
revenues_paidcontent_last_weekTotal amount of net revenues in USD generated through the paid content in the last 7 sliding days.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| number | 80.7 | Private, requires read_insights scope | N/A |
revenues_paidcontent_total
revenues_paidcontent_totalTotal amount of net revenues in USD generated through the paid content since the beginning.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| number | 2502.37 | Private, requires read_insights scope | N/A |
revenues_video_last_day
revenues_video_last_dayTotal amount of net revenues in USD generated through the video monetization the last day.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| number | 12 | Private, requires read_insights scope | N/A |
revenues_video_last_month
revenues_video_last_monthTotal amount of net revenues in USD generated through the video monetization the last month.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| number | 310.2 | Private, requires read_insights scope | N/A |
revenues_video_last_week
revenues_video_last_weekTotal amount of net revenues in USD generated through the video monetization in the last 7 sliding days.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| number | 80.7 | Private, requires read_insights scope | N/A |
revenues_video_total
revenues_video_totalTotal amount of net revenues in USD generated through the video monetization since the beginning.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| number | 2502.37 | Private, requires read_insights scope | N/A |
revenues_website_last_day
revenues_website_last_dayTotal amount of net revenues in USD generated through the website monetization the last day.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| number | 12 | Private, requires read_insights scope | N/A |
revenues_website_last_month
revenues_website_last_monthTotal amount of net revenues in USD generated through the website monetization the last month.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| number | 310.2 | Private, requires read_insights scope | N/A |
revenues_website_last_week
revenues_website_last_weekTotal amount of net revenues in USD generated through the website monetization in the last 7 sliding days.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| number | 80.7 | Private, requires read_insights scope | N/A |
revenues_website_total
revenues_website_totalTotal amount of net revenues in USD generated through the website monetization since the beginning.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| number | 2502.37 | Private, requires read_insights scope | N/A |
screenname
screennameReturns this user’s full name or login depending on the user’s preferences.
Min length: 1 / Max length: 50
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| string | johndoe424 | Public | Private, requires userinfo scope |
status
statusCurrent user account status.
allowed values:
pending-activation
,
disabled
,
active
or
unknown
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| string | active | Public | N/A |
twitter_url
twitter_urlTwitter profile URL of this user.
Min length: 1 / Max length: 150
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| string | https://twitter.com/johndoe424 | Public | Private, can be written by the owner of the object |
url
urlURL of this user’s profile on Dailymotion.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://www.dailymotion.com/johndoe424 | Public | N/A |
username
usernameUser account credentials login.
Min length: 1 / Max length: 150
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| string | johndoe424 | Public | Private, requires userinfo scope |
username_update_required
username_update_requiredTrue if this user needs to update his username, False otherwise.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| boolean | false | Public | N/A |
verified
verifiedTrue if this user is a verified partner.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | false | Public | Private, can be written by the owner of the object |
videos_total
videos_totalTotal amount of public videos of this user.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | 27 | Public | N/A |
views_total
views_totalTotal amount of public videos of this user.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | 27 | Public | N/A |
webhook_events
webhook_eventsURL of the thumbnail of this playlist’s first video (raw, respecting full size ratio).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s1.dmcdn.net/3CQ3.jpg | Public | N/A |
webhook_url
webhook_urlDate and time when this playlist was last updated.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | 1404129540 | Public | N/A |
website_url
website_urlTotal amount of videos in this playlist.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| string | https://www.johndoe424.net | Public | Private, can be written by the owner of the object |