Actor object

The actor object contains Twitter User account metadata that describes the Twitter User which created the activity.

 

Data Dictionary

Attribute Type Description
objectType string "objectType": "person"
id string The string representation of the unique identifier for this author. Example:
"id:twitter.com:2244994945"
link   "http://www.twitter.com/TwitterDev
displayName String The name of the user, as they’ve defined it. Not necessarily a person’s name. Typically capped at 50 characters, but subject to change. Example:

"displayName": "Twitter Dev"
preferredUsername string The screen name, handle, or alias that this user identifies themselves with. Unique but subject to change. Use id as a user identifier whenever possible. Typically a maximum of 15 characters long, but some historical accounts may exist with longer names. Example:

"preferredUsername": "TwitterDev"
location object "location": {
"objectType": "place",
"displayName": "127.0.0.1"
}
links array Nullable . A URL provided by the user in association with their profile. Example:

"links": [
{
"href": "https://developer.twitter.com/en/community",
"rel": "me"
}
]
summary string Nullable . The user-defined UTF-8 string describing their account. Example:

"summary": "The voice of the #TwitterDev team..."
protected Boolean When true, indicates that this user has chosen to protect their Tweets. See About Public and Protected Tweets . Example:
"protected": true
verified Boolean When true, indicates that the user has a verified account. See Verified Accounts . Example:
"verified": false
followersCount Int The number of followers this account currently has. Under certain conditions of duress, this field will temporarily indicate “0”. Example:
"followers_count": 21
friendsCount Int The number of users this account is following (AKA their “followings”). Under certain conditions of duress, this field will temporarily indicate “0”. Example:
"friends_count": 32
listedCount Int The number of public lists that this user is a member of. Example:
"listed_count": 9274
favoritesCount Int The number of Tweets this user has liked in the account’s lifetime. British spelling used in the field name for historical reasons. Example:
"favourites_count": 13
statusesCount Int The number of Tweets (including retweets) issued by the user. Example:
"statuses_count": 42
postedTime date The UTC datetime that the user account was created on Twitter. Example:

"postedTime": "2013-12-14T04:35:55.036Z"
image string A HTTPS-based URL pointing to the user’s profile image. Example:

"image": "https://pbs.twimg.com/profile_images/1283786620521652229/lEODkLTh_normal.jpg"


No longer supported (deprecated) attributes

Field Type Description
utcOffset null Value will be set to null. Still available via GET account/settings
twitterTimeZone null Value will be set to null. Still available via GET account/settings as tzinfo_name
languages null Value will be set to null. Still available via GET account/settings as language


Examples:

            "actor": {
        "objectType": "person",
        "id": "id:twitter.com:2244994945",
        "link": "http://www.twitter.com/TwitterDev",
        "displayName": "Twitter Dev",
        "postedTime": "2013-12-14T04:35:55.036Z",
        "image": "https://pbs.twimg.com/profile_images/1283786620521652229/lEODkLTh_normal.jpg",
        "summary": "The voice of the #TwitterDev team and your official source for updates, news, and events, related to the #TwitterAPI.",
        "friendsCount": 2039,
        "followersCount": 512197,
        "listedCount": 1662,
        "statusesCount": 3632,
        "twitterTimeZone": null,
        "verified": true,
        "utcOffset": null,
        "preferredUsername": "TwitterDev",
        "languages": [],
        "links": [
          {
            "href": "https://developer.twitter.com/en/community",
            "rel": "me"
          }
        ],
        "location": {
          "objectType": "place",
          "displayName": "127.0.0.1"
        },
        "favoritesCount": 2147
      }
    
      "actor": {
    "objectType": "person",
    "id": "id:twitter.com:6253282",
    "link": "http://www.twitter.com/TwitterAPI",
    "displayName": "Twitter API",
    "postedTime": "2007-05-23T06:01:13.000Z",
    "image": "https://pbs.twimg.com/profile_images/942858479592554497/BbazLO9L_normal.jpg",
    "summary": "Tweets about changes and service issues. Follow @TwitterDev for more.",
    "friendsCount": 39,
    "followersCount": 6054164,
    "listedCount": 12285,
    "statusesCount": 3689,
    "twitterTimeZone": null,
    "verified": true,
    "utcOffset": null,
    "preferredUsername": "TwitterAPI",
    "languages": [
      
    ],
    "links": [
      {
        "href": "https://developer.twitter.com",
        "rel": "me"
      }
    ],
    "favoritesCount": 4
  }
    
Was this document helpful?
Thank you

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?
Thank you for the feedback. Your comments will help us improve our documents in the future.