Get a public X profile by username, with optional raw provider data.
Endpoint
- Path:
/api/v1/x/user - Cost: 1 credit per successful request
Query parameters
| Name | Required | Description | Example |
|---|---|---|---|
username | Yes | The X username without the @ symbol. | elonmusk |
raw | No | Include the unchanged provider response in the raw field. Defaults to false. | true |
curl --get 'https://api.sociallisteningapi.com/api/v1/x/user' \
--data-urlencode 'username=elonmusk' \
--data-urlencode 'raw=true' \
--header 'x-api-key: YOUR_API_KEY'Responses
{
"success": true,
"platform": "x",
"endpoint": "/api/v1/x/user",
"data": {
"id": "44196397",
"platform": "x",
"username": "alex",
"display_name": "Alex Morgan",
"avatar_url": "https://example.com/avatar.jpg",
"bio": "Building useful software.",
"verified": true,
"followers": 25000,
"following": 420,
"posts_count": 3200,
"likes_count": 8500,
"url": "https://x.com/alex",
"location": "Melbourne",
"external_url": "https://example.com",
"private": false,
"joined_at": "2009-06-02T20:12:29.000Z",
"ext": {
"cover_picture": "https://example.com/cover.jpg",
"media_count": 240,
"can_dm": false,
"pinned_tweet_ids": [
"1890000000000000000"
]
}
},
"pagination": {
"next_cursor": null,
"has_more": false,
"page_size": 1
},
"raw": {
"status": "success",
"data": {}
},
"request_id": "req_example123",
"credits_used": 1,
"credits_remaining": 99
}