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

NameTypeRequirementDescription
usernamestringRequiredX username without @. 1-50 characters.

Response fields

FieldTypeDescription
userobjectid, 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_countnumberEach count has a *_status field: present, not_exposed, or parser_miss. Optional: a count X hides is omitted, never zero.
user.verified / blue_verifiedbooleanOptional: omitted when X does not expose the flag.
error / error_codestringPresent 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"
  }
}