Docs/X Profile
Docs / API reference
POST/v1/data/twitter/profile
X Profile
Get an X user profile with bio, follower, following, post, like and list counts, verification flags, and profile images.
Execution model
Live request
Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.
Credit weight
Live catalog
Current weights are managed from the Data API Weights admin table and shown on pricing before use.
Parameters
| Name | Type | Requirement | Description |
|---|---|---|---|
| username | string | Required | X username without @. 1-50 characters. |
Response fields
| Field | Type | Description |
|---|---|---|
| user | object | id, username, name, description, verified, blue_verified, created_at, profile_image_url, profile_banner_url, location, url (the profile URL on x.com). |
| user.followers_count / following_count / tweet_count / like_count / listed_count | number | Each count has a *_status field: present, not_exposed, or parser_miss. Optional: a count X hides is omitted, never zero. |
| user.verified / blue_verified | boolean | Optional: omitted when X does not expose the flag. |
| error / error_code | string | Present when success is false, for example error_code not_found. |
Request and response
curl -X POST "https://api.datablue.dev/v1/data/twitter/profile" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "nasa"
}'Example response
{
"success": true,
"time_taken": 1.82,
"user": {
"id": "11348282",
"username": "NASA",
"name": "NASA",
"description": "Exploring the universe and our home planet.",
"followers_count": 89000000,
"followers_count_status": "present",
"following_count": 180,
"following_count_status": "present",
"tweet_count": 74000,
"tweet_count_status": "present",
"like_count": 16000,
"like_count_status": "present",
"listed_count": 98000,
"listed_count_status": "present",
"verified": false,
"blue_verified": true,
"created_at": "Wed Dec 19 20:20:32 +0000 2007",
"profile_image_url": "https://pbs.twimg.com/profile_images/example_400x400.jpg",
"profile_banner_url": "https://pbs.twimg.com/profile_banners/11348282/example",
"location": "Pale Blue Dot",
"url": "https://x.com/NASA"
}
}