Reference
Release NoteHelpcenterStatus PageContact Us
Start typing to search…

User fields

List of fields to return for requests in the user object. Retrieve them using the fields query-string parameter on any user object request.

FieldsDescription
activeForce user account active.
addressPostal address of this user.
avatar_25_urlURL of this user’s avatar image (25px wide square)
avatar_60_urlURL of this user’s avatar image (60px wide square)
avatar_80_urlURL of this user’s avatar image (80px wide square)
avatar_120_urlURL of this user’s avatar image (120px wide square)
avatar_190_urlURL of this user’s avatar image (190px wide square)
avatar_240_urlURL of this user’s avatar image (240px wide square)
avatar_360_urlURL of this user’s avatar image (360px wide square)
avatar_480_urlURL of this user’s avatar image (480px wide square)
avatar_720_urlURL of this user’s avatar image (720px wide square)
avatar_urlURL of an image to change this user’s avatar.
ban_from_partner_programTrue if this user has the criteria ban-from-partner-program.
birthdayBirthday date of this user.
children_totalTotal number of associated children profiles.
cityCity of residence of this user.
countryCountry of residence of this user.
cover_100_urlURL of this user’s cover image (height = 100px)
cover_150_urlURL of this user’s cover image (height = 150px).
cover_200_urlURL of this user’s cover image (height = 200px).
cover_250_urlURL of this user’s cover image (height = 250px).
cover_urlURL of this user’s cover image (original size).
created_timeDate and time when this user joined the site.
descriptionComprehensive description of this user.
emailEmail address of this user.
facebook_urlFacebook profile URL of this user.
first_nameFirst name of this user.
followers_totalTotal amount of followers of this user.
following_totalTotal amount of users this user is following.
fullnameFull name of this user.
genderGender of this user.
idUnique object identifier (unique among all users).
instagram_urlInstagram profile URL of this user.
is_followingTrue if the authenticated user is following this user. If no user is authenticated, it will always return false.
item_typeGraph type of this object (hopefully user).
languageLanguage used by this user.
last_nameLast name of this user.
limitsReturns the various user limits like the maximum allowed duration and size per uploaded video etc.
linkedin_urlLinkedin profile URL of this user.
parentIdentifier of this user’s parent profile.
partnerWhen the partner field is set.
pinterest_urlPinterest profile URL of this user.
playlists_totalTotal amount of playlists of this user.
revenues_claim_last_dayTotal amount of net revenues in USD generated through claim the last day.
revenues_claim_last_monthTotal amount of net revenues in USD generated through claim the last month.
revenues_claim_last_weekTotal amount of net revenues in USD generated through claim in the last 7 days.
revenues_claim_totalTotal amount of net revenues in USD generated through claim since the beginning.
revenues_paidcontent_last_dayTotal amount of net revenues in USD generated through the paid content the last day.
revenues_paidcontent_last_monthTotal amount of net revenues in USD generated through the paid content the last month.
revenues_paidcontent_last_weekTotal amount of net revenues in USD generated through the paid content in the last 7 days.
revenues_paidcontent_totalTotal amount of net revenues in USD generated through the paid content since the beginning.
revenues_video_last_dayTotal amount of net revenues in USD generated through the video monetization the last day.
revenues_video_last_monthTotal amount of net revenues in USD generated through the video monetization the last month.
revenues_video_last_weekTotal amount of net revenues in USD generated through the video monetization in the last 7 days.
revenues_video_totalTotal amount of net revenues in USD generated through the video monetization since the beginning.
revenues_website_last_dayTotal amount of net revenues in USD generated through the website monetization the last day.
revenues_website_last_monthTotal amount of net revenues in USD generated through the website monetization the last month.
revenues_website_last_weekTotal amount of net revenues in USD generated through the website monetization in the last 7 days.
revenues_website_totalTotal amount of net revenues in USD generated through the website monetization since the beginning
screennameReturns this user’s full name or login depending on the user’s preferences.
statusCurrent user account status.
twitter_urlX profile URL of this user.
urlDailymotion profile URL of this user.
usernameUser account credentials login.
username_update_requiredTrue if this user needs to update his username, False otherwise.
verifiedTrue if this user is a verified partner.
videos_totalTotal amount of public videos of this user.
views_totalTotal aggregated number of views on all of this user’s videos.
website_urlPersonal website URL of this user.




active

Verify if the user account is active.

TypeSample valueRead accessWrite access
stringyPublicN/A

address

Postal 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

URL of this user’s avatar image (25px wide square)

TypeSample valueRead access (scope)Write access (scope)
urlhttps://s1.dmcdn.net/AVM/25x25--w1.pngPublicN/A

avatar_60_url

URL of this user’s avatar image (60px wide square)

TypeSample valueRead access (scope)Write access (scope)
urlhttps://s1.dmcdn.net/AVM/60x60-As1.pngPublicN/A

avatar_80_url

URL of this user’s avatar image (80px wide square).

TypeSample valueRead access (scope)Write access (scope)
urlhttps://s1.dmcdn.net/AVM/80x80-Rf1.pngPublicN/A

avatar_120_url

URL of this user’s avatar image (120px wide square).

TypeSample valueRead access (scope)Write access (scope)
urlhttps://s1.dmcdn.net/AVM/120x120-bn1.pngPublicN/A

avatar_190_url

URL of this user’s avatar image (190px wide square).

TypeSample valueRead access (scope)Write access (scope)
urlhttps://s1.dmcdn.net/AVM/190x190-ma1.pngPublicN/A

avatar_240_url

URL of this user’s avatar image (240px wide square).

TypeSample valueRead access (scope)Write access (scope)
urlhttps://s1.dmcdn.net/AVM/240x240-sU1.pngPublicN/A

avatar_360_url

URL of this user’s avatar image (360px wide square).

TypeSample valueRead access (scope)Write access (scope)
urlhttps://s1.dmcdn.net/AVM/360x360-PM1.pngPublicN/A

avatar_480_url

URL of this user’s avatar image (480px wide square).

TypeSample valueRead access (scope)Write access (scope)
urlhttps://s1.dmcdn.net/AVM/480x480-CD1.pngPublicN/A

avatar_720_url

URL of this user’s avatar image (720px wide square).

TypeSample valueRead access (scope)Write access (scope)
urlhttps://s1.dmcdn.net/AVM/720x720-Gr1.pngPublicN/A

avatar_url

URL of an image to change this user’s avatar (write-only)

TypeSample valueRead access (scope)Write access (scope)
urlhttp://www.example.orgN/ARequires authentication to be accessed


ban_from_partner_program

True 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

Birthday 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

Total number of user children.

TypeSample valueRead access (scope)Write access (scope)
number10PublicN/A

city

City 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

Country 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

URL of this user’s cover image (height = 100px).

TypeSample valueRead access (scope)Write access (scope)
urlhttps://s2.dmcdn.net/GJCWj/x100-qZJ.jpgPublicN/A

cover_150_url

URL of this user’s cover image (height = 150px).

TypeSample valueRead access (scope)Write access (scope)
urlhttps://s2.dmcdn.net/GJCWj/x150-KrI.jpgPublicN/A

cover_200_url

URL of this user’s cover image (height = 200px).

TypeSample valueRead access (scope)Write access (scope)
urlhttps://s2.dmcdn.net/GJCWj/x200--y5.jpgPublicN/A

cover_250_url

URL of this user’s cover image (height = 250px).

TypeSample valueRead access (scope)Write access (scope)
urlhttps://s2.dmcdn.net/GJCWj/x250-u-x.jpgPublicN/A

cover_url

URL 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

Date and time when this user joined the site.

TypeSample valueRead access (scope)Write access (scope)
date1287507036PublicN/A

description

Comprehensive 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

Email address of this user..

Type

Sample value

Read access (scope)

Write access (scope)

email

[email protected]

Private,
requires email scope

Private,
requires email scope


facebook_url

Facebook 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 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

Total amount of followers of this user.

TypeSample valueRead access (scope)Write access (scope)
number42PublicN/A

following_total

Total amount of users this user is following.

TypeSample valueRead access (scope)Write access (scope)
number42PublicN/A

fullname

Full 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

Gender 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

Unique object identifier (unique among all users)

TypeSample valueRead access (scope)Write access (scope)
stringxna9gn9PublicN/A

instagram_url

Instagram 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

True if the authenticated user is following this user. If no user is authenticated, it will always return false

TypeSample valueRead access (scope)Write access (scope)
booleanfalsePublicN/A

item_type

Graph type of this object (hopefully user)

TypeSample valueRead access (scope)Write access (scope)
stringuserPublicN/A

language

Language 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 name of this user.

Type

Sample value

Read access (scope)

Write access (scope)

string

Doe

Private,
requires userinfo scope

Private,
requires userinfo scope


limits

Returns 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 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

Identifier 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).

TypeSample valueRead access (scope)Write access (scope)
userx9tz791PublicN/A

partner

When 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.

TypeSample valueRead access (scope)Write access (scope)
booleanfalsePublicN/A

pinterest_url

Pinterest 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

Total amount of playlists of this user.

TypeSample valueRead access (scope)Write access (scope)
url14PublicN/A

reposts_total

The number of videos reposted by the user.

TypeSample valueRead access (scope)Write access (scope)
url14PublicN/A

revenues_claim_last_day

Total 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

Total 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

Total 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

Total 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

Total 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

Total 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

Total 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

Total 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

Total 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

Total 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

Total 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

Total 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

Total 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

Total 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

Total 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

Total 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

Returns 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

Current user account status.

allowed values: pending-activation , disabled , active or unknown

TypeSample valueRead access (scope)Write access (scope)
stringactivePublicN/A

twitter_url

Twitter 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

URL of this user’s profile on Dailymotion.

TypeSample valueRead access (scope)Write access (scope)
urlhttps://www.dailymotion.com/johndoe424PublicN/A

username

User 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

True if this user needs to update his username, False otherwise.

TypeSample valueRead access (scope)Write access (scope)
booleanfalsePublicN/A

verified

True 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

Total amount of public videos of this user.

TypeSample valueRead access (scope)Write access (scope)
url27PublicN/A

views_total

Total amount of public videos of this user.

TypeSample valueRead access (scope)Write access (scope)
url27PublicN/A


webhook_events

URL of the thumbnail of this playlist’s first video (raw, respecting full size ratio).

TypeSample valueRead access (scope)Write access (scope)
urlhttps://s1.dmcdn.net/3CQ3.jpgPublicN/A

webhook_url

Date and time when this playlist was last updated.

TypeSample valueRead access (scope)Write access (scope)
url1404129540PublicN/A

website_url

Total 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