POST

Followers

/v1/twitter/user/followers

Fetch up to 5,000 followers for any Twitter user. Returns full profile data for each follower.

Request Parameters

Parameter	Type	Required	Description
username	string	Yes	Twitter username (without @)
limit	int	No	Max results (1-5000) (default: 100)

Example

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

Response Schema

All responses include success, data, and usage fields.

Field	Type	Description
metadata.username	string	Username queried
metadata.type	string	Request type (followers)
metadata.url	string	Profile followers URL
metadata.requested_limit	int	Limit requested
metadata.total_found	int	Total followers returned
metadata.graphql_responses	int	Number of GraphQL responses fetched
metadata.scrolls	int	Number of pagination scrolls
metadata.elapsed_ms	int	Request duration in milliseconds
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	Relationship status (following, followed_by, blocking, muting)

Example Response

{
  "success": true,
  "metadata": {
    "username": "elonmusk",
    "type": "followers",
    "url": "https://x.com/elonmusk/followers",
    "requested_limit": 100,
    "total_found": 1,
    "graphql_responses": 1,
    "scrolls": 0,
    "elapsed_ms": 3603
  },
  "data": [
    {
      "user_id": "95092020",
      "username": "jordanbpeterson",
      "name": "Dr Jordan B Peterson",
      "bio": "Best-Selling Author | Clinical Psychologist...",
      "followers_count": 6186978,
      "following_count": 1657,
      "tweets_count": 51538,
      "verified": true,
      "profile_image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
      "created_at": "Sun Dec 06 23:33:02 +0000 2009",
      "relationship": {
        "following": false,
        "followed_by": false,
        "blocking": false,
        "muting": false
      }
    }
  ],
  "usage": {
    "unique_posts": 82,
    "limit": 6000,
    "remaining": 5918
  }
}

Try this endpoint live

Create Free Account