POST

User Profile

/v1/twitter/user

Get a complete Twitter user profile including follower counts, bio, verification status, profile image, and more.

Request Parameters

Parameter	Type	Required	Description
username	string	Yes	Twitter username (without @)

Example

curl -X POST https://query-data-api.notpeople.ai/v1/twitter/user \
  -H "X-API-Key: tw_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"username": "elonmusk"}'

Response Schema

All responses include success, data, and usage fields.

Field	Type	Description
user_id	string	Unique Twitter user ID
username	string	Twitter handle
name	string	Display name
bio	string	Profile biography
followers_count	int	Number of followers
following_count	int	Number of accounts followed
tweets_count	int	Total number of tweets
verified	bool	Whether the user is verified
profile_image_url	string	URL to the profile picture
created_at	string	Account creation date string
relationship	object \| null	Relationship status (following, followed_by, blocking, muting)

Example Response

{
  "success": true,
  "data": {
    "user_id": "44196397",
    "username": "elonmusk",
    "name": "Elon Musk",
    "bio": "https://t.co/dDtDyVssfm",
    "followers_count": 237483553,
    "following_count": 1304,
    "tweets_count": 100088,
    "verified": true,
    "profile_image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
    "created_at": "Tue Jun 02 20:12:29 +0000 2009",
    "relationship": null
  },
  "usage": {
    "unique_posts": 81,
    "limit": 6000,
    "remaining": 5919
  }
}

Try this endpoint live

Create Free Account