Get User Profile
Get detailed information about a Twitter user by their username.
Endpoint
Query Parameters
Twitter username (without @ symbol)
Example Request
curl -X GET "https://rocks.rive.wtf/api/twitter/user?username=elonmusk" \
-H "Authorization: Bearer YOUR_API_KEY"
Response Example
{
"data": {
"description": "",
"id": "44196397",
"name": "Elon Musk",
"profile_image_url": "https://pbs.twimg.com/profile_images/2008546467615580160/57KcqsTA_normal.jpg",
"public_metrics": {
"followers_count": 233388876,
"following_count": 1279,
"like_count": 204057,
"listed_count": 166699,
"media_count": 4335,
"tweet_count": 95649
},
"username": "elonmusk",
"verified": false
}
}
Response Fields
User profile data object
Twitter handle (without @ symbol)
Display name on the profile
User’s bio/description text
URL to the user’s profile picture
Whether the account has verification status
Public engagement and activity metrics
followers_count - Number of followersfollowing_count - Number of accounts followingtweet_count - Total number of tweets postedlisted_count - Number of public lists the user is onlike_count - Total number of likes the user has givenmedia_count - Number of media items posted
This endpoint returns public profile information only. Protected or private accounts may return limited data.
Profile image URLs can be modified by changing the size suffix. Replace _normal with _bigger, _mini, or remove it entirely for the original size.
Use Cases
Social Analytics
Track follower growth and engagement metrics
Profile Verification
Verify Twitter accounts in your application
User Discovery
Build Twitter user search and discovery tools
Bot Integration
Display Twitter profiles in Discord/Slack bots
Profile Image Sizes
The API returns profile images with _normal suffix by default (48x48). You can modify the URL to get different sizes:
| Size | Suffix | Dimensions |
|---|
| Mini | _mini | 24x24 |
| Normal | _normal | 48x48 |
| Bigger | _bigger | 73x73 |
| Original | _400x400 | 400x400 |
profile_image_url to get your desired size.