| Field | Type | Required | Description | Example |
|---|---|---|---|---|
user_id |
str | ✔️ | Twitter user ID | 44196397 |
avatar |
str | ✔️ | Profile avatar image URL | https://pbs.twimg.com/profile_images/1983681414370619392/oTT3nm5Z_normal.jpg |
name |
str | ✔️ | User display name | Elon Musk |
screen_name |
str | ✔️ | Twitter username (handle) | elonmusk |
created_at |
str | ✔️ | Account creation date in Twitter format | Tue Jun 02 20:12:29 +0000 2009 |
profile_image_shape |
str | ✔️ | Profile image shape (e.g., Circle, Square) | Circle |
verification |
bool | ✔️ | Whether the user account is verified | false |
user_label_display_type |
str | ✔️ | User label display type (e.g., Badge) | Badge |
user_label_type |
str | ✔️ | User label type (e.g., BusinessLabel) | BusinessLabel |
is_blue_verified |
bool | ✔️ | Whether the user has blue verification badge (Twitter Blue/X Premium) | true |
privacy_policy_url |
str | ✔️ | Privacy policy or learn more URL | https://help.twitter.com/managing-your-account/about-twitter-verified-accounts |
account_based_in |
str | ✔️ | Country or region where the account is based | United States |
location_accurate |
bool | ✔️ | Whether the location information is accurate | true |
affiliate_username |
str | ✔️ | Affiliated username (e.g., business account username) | X |
source |
str | ✔️ | Source of account creation (e.g., 'United States App Store') | United States App Store |
username_changes_count |
int | ✔️ | Number of times the username has been changed | 0 |
override_verified_year |
int | ✔️ | Override verified year (if applicable, negative values indicate special cases) | -3000 |
verified_since_msec |
int | ✔️ | Timestamp in milliseconds when the account was verified (negative values indicate special cases) | -156836000000000 |
