Actor object
The actor object contains X User account metadata that describes the X 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:x.com:2244994945"
|
link | "http://www.x.com/XDeveloeprs | |
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": "XDevelopers"
|
preferredUsername | string | The screen name, handle, or alias that this user identifies themselves with. Unique but subject to change. Use
"preferredUsername": "XDevelopers"
|
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 #XDevelopers team..."
|
protected | Boolean | When true, indicates that this user has chosen to protect their Posts. See About Public and Protected Posts. 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 Posts 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 Posts (including retweets) issued by the user. Example:
"statuses_count": 42
|
postedTime | date | The UTC datetime that the user account was created on X. 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
}
Next Steps
Explore the other sub-objects that a Post contains: