User Endpoints

Comprehensive user-related endpoints for fetching mentions, followers, following, replies, media tweets, verified followers, and batch lookups.

GET/v2/users/:username/mentionsFetch tweets that mention a specific user.

Parameter	Type	Required	Default	Description
username	string	required	—	X username (without @)
count	integer	optional	20	Number of mentions to return
sort	string	optional	latest	Sort: latest, popular, engagement. Invalid values return 400
cursor	string	optional	—	Pagination cursor from previous response

BASH

curl https://xcrop.io/api/v2/users/VitalikButerin/mentions?count=10 \
  -H "Authorization: Bearer $XCROP_API_KEY"

ResponseJSON

{
  "data": [
    {
      "id": "1893045621038174208",
      "text": "@VitalikButerin what do you think about the new L2 scaling...",
      "author": { "id": "55001", "username": "eth_dev", "name": "ETH Dev" },
      "metrics": { "likes": 284, "retweets": 42, "replies": 18, "views": 94000, "bookmarks": 12 },
      "is_reply": false,
      "is_quote": false,
      "is_retweet": false,
      "created_at": "Sun Mar 01 08:14:33 +0000 2026"
    }
  ],
  "meta": {
    "total": 10,
    "has_next_page": true,
    "next_cursor": "eyJvZmZzZXQiOjEwfQ==",
    "username": "VitalikButerin",
    "latency_ms": 2480
  }
}

GET/v2/users/:username/followersGet followers of a user with profile details.

Parameter	Type	Required	Default	Description
username	string	required	—	X username (without @)
count	integer	optional	20	Number of followers to return
sort	string	optional	default	Sort: default, followers, name. Invalid values return 400
cursor	string	optional	—	Pagination cursor

BASH

curl https://xcrop.io/api/v2/users/elonmusk/followers?count=20 \
  -H "Authorization: Bearer $XCROP_API_KEY"

ResponseJSON

{
  "data": [
    {
      "id": "95092020",
      "username": "jordanbpeterson",
      "name": "Dr Jordan B Peterson",
      "description": "Best-Selling Author | Clinical Psychologist",
      "followers": 6191677,
      "following": 1659,
      "tweets_count": 51539,
      "listed": 12840,
      "verified": true,
      "verified_type": null,
      "profile_image": "https://pbs.twimg.com/profile_images/.../normal.jpg",
      "created_at": "Sun Dec 06 23:33:02 +0000 2009"
    }
  ],
  "meta": {
    "total": 20,
    "has_next_page": true,
    "next_cursor": "1858928307011993554|2029947584075792380",
    "username": "elonmusk",
    "latency_ms": 2560
  }
}

GET/v2/users/:username/followers-idsBulk fetch follower IDs, up to 5,000 per call. Returns IDs only (no profile metadata), 1 credit per result.

Parameter	Type	Required	Default	Description
username	string	required	—	X username (without @)
count	integer	optional	5000	Number of follower IDs to return (max 5000)
cursor	string	optional	—	Pagination cursor

BASH

curl https://xcrop.io/api/v2/users/elonmusk/followers-ids?count=5000 \
  -H "Authorization: Bearer $XCROP_API_KEY"

GET/v2/users/:username/followingGet accounts that a user follows.

Parameter	Type	Required	Default	Description
username	string	required	—	X username (without @)
count	integer	optional	20	Number of following to return
sort	string	optional	default	Sort: default, followers, name. Invalid values return 400
cursor	string	optional	—	Pagination cursor

BASH

curl https://xcrop.io/api/v2/users/VitalikButerin/following?count=20 \
  -H "Authorization: Bearer $XCROP_API_KEY"

GET/v2/users/:username/repliesFetch the posts and replies a user wrote. Reposts are left out unless you ask for them.

Parameter	Type	Required	Default	Description
username	string	required	—	X username (without @)
count	integer	optional	20	Number of items to return
sort	string	optional	latest	Sort: latest, popular, engagement. Invalid values return 400
cursor	string	optional	—	Pagination cursor
include_retweets	boolean	optional	false	Include reposts of other accounts. X’s own tab is mostly reposts for many accounts, so they are left out by default; meta.removed_retweets counts what was dropped

BASH

curl https://xcrop.io/api/v2/users/elonmusk/replies?count=10 \
  -H "Authorization: Bearer $XCROP_API_KEY"

GET/v2/users/:username/repostsFetch what a user reposted: the profile Reposts tab. Every row is a repost, with retweeted_tweet_id pointing at the original post.

Parameter	Type	Required	Default	Description
username	string	required	—	X username (without @)
count	integer	optional	20	Number of reposts to return
sort	string	optional	latest	Sort: latest, popular, engagement. Invalid values return 400
cursor	string	optional	—	Pagination cursor

BASH

curl https://xcrop.io/api/v2/users/elonmusk/reposts?count=10 \
  -H "Authorization: Bearer $XCROP_API_KEY"

GET/v2/users/:username/highlightsFetch the posts a user pinned to their Highlights tab.

Parameter	Type	Required	Default	Description
username	string	required	—	X username (without @)
count	integer	optional	20	Number of posts to return
sort	string	optional	latest	Sort: latest, popular, engagement. popular asks X for the tab’s own Top order
cursor	string	optional	—	Pagination cursor

BASH

curl https://xcrop.io/api/v2/users/elonmusk/highlights?count=10 \
  -H "Authorization: Bearer $XCROP_API_KEY"

GET/v2/users/:username/mediaFetch posts with an image, video or GIF. Each item carries a media array with the URLs.

Parameter	Type	Required	Default	Description
username	string	required	—	X username (without @)
count	integer	optional	20	Number of media tweets to return (up to 1,000; same on every plan, paginate for more)
sort	string	optional	latest	Sort: latest, popular, engagement. Invalid values return 400
type	string	optional	all	all (default), photo or video. X splits its Media tab into Photos and Videos; all is the combined timeline
cursor	string	optional	—	Pagination cursor from previous response

BASH

curl https://xcrop.io/api/v2/users/elonmusk/media?count=10 \
  -H "Authorization: Bearer $XCROP_API_KEY"

GET/v2/users/:username/verified-followersGet verified (X Premium) followers of a user.

Parameter	Type	Required	Default	Description
username	string	required	—	X username (without @)
count	integer	optional	20	Number of results (up to 1,000; same on every plan, paginate for more)
sort	string	optional	default	Sort: default, followers, name. Invalid values return 400
cursor	string	optional	—	Pagination cursor

BASH

curl https://xcrop.io/api/v2/users/VitalikButerin/verified-followers?count=20 \
  -H "Authorization: Bearer $XCROP_API_KEY"

POST/v2/users/batchLook up multiple users by username in a single request. Max 100 usernames.

Parameter	Type	Required	Default	Description
usernames	string[]	required	—	Array of usernames to look up (max 100)

BASH

curl -X POST https://xcrop.io/api/v2/users/batch \
  -H "Authorization: Bearer $XCROP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames": ["elonmusk", "VitalikButerin", "cz_binance"]}'

ResponseJSON

{
  "data": [
    {
      "id": "44196397",
      "username": "elonmusk",
      "name": "Elon Musk",
      "description": "",
      "followers": 236033705,
      "following": 1292,
      "tweets_count": 98496,
      "listed": 167755,
      "verified": true,
      "verified_type": null,
      "profile_image": "https://pbs.twimg.com/profile_images/.../normal.jpg",
      "created_at": "Tue Jun 02 20:12:29 +0000 2009"
    },
    {
      "id": "295218901",
      "username": "VitalikButerin",
      "name": "vitalik.eth",
      "description": "d/acc",
      "followers": 5580000,
      "following": 412,
      "tweets_count": 14200,
      "listed": 38500,
      "verified": true,
      "verified_type": null,
      "profile_image": "https://pbs.twimg.com/profile_images/.../normal.jpg",
      "created_at": "Mon May 09 19:51:52 +0000 2011"
    }
  ],
  "meta": { "total": 2, "requested": 3, "latency_ms": 3250 }
}

More in REST API

Full documentation with search: xcrop.io/docs