xAPIs.dev
API Reference · v2
Free Tools{ }OpenAPI YAMLGet API key
API Reference / User / Get user mentions

Get user mentions

GET/twitter/user/mentions15 credits

Fetch recent tweets that mention a given user. The sample response below is captured from the live API. List endpoints paginate with `has_next_page` and `next_cursor`.

Authentication required
Send your key in the x-api-key header. Requests without a valid key return 401.

Query parameters

userName
stringrequired
The @handle to fetch mentions for.
cursor
stringoptional
Pagination cursor for the next page.

Response fields

tweetsarray
Array of tweet objects with engagement metrics and author info.
has_next_pageboolean
Whether another page of results is available.
next_cursorstring
Cursor for the next page; null or empty when exhausted.
statusstring
Request status: "success" or "error".
msgstring
Status message from the upstream.
Request
curl https://v2.xapis.dev/twitter/user/mentions \
  -G --data-urlencode "userName=elonmusk" \
  -H "x-api-key: $XAPIS_KEY"
Response200 OK
application/json
{
  "tweets": [
    {
      "type": "tweet",
      "id": "2074776381829870030",
      "url": "https://x.com/LizaUK3/status/2074776381829870030",
      "twitterUrl": "https://twitter.com/LizaUK3/status/2074776381829870030",
      "text": "@HouseofCommons @RoyalFamily @Ed_Miliband @UKLabour @BorisJohnson @elonmusk @RishiSunak @KemiBadenoc…",
      "source": "Twitter for iPhone",
      "retweetCount": 0,
      "replyCount": 0,
      "likeCount": 0,
      "quoteCount": 0,
      "viewCount": 0,
      "createdAt": "Wed Jul 08 08:43:31 +0000 2026",
      "lang": "en",
      "bookmarkCount": 0,
      "isReply": true,
      "inReplyToId": "2074771692480512264",
      "conversationId": "2036088401590456378",
      "displayTextRange": [
        133
      ],
      "inReplyToUserId": "1154385013292638209",
      "inReplyToUsername": "LizaUK3",
      "author": {
        "type": "user",
        "userName": "LizaUK3",
        "url": "https://x.com/LizaUK3",
        "twitterUrl": "https://twitter.com/LizaUK3",
        "id": "1154385013292638209",
        "name": "LizaUK",
        "isVerified": false,
        "isBlueVerified": false,
        "verifiedType": null,
        "profilePicture": "https://pbs.twimg.com/profile_images/1372507280831344642/739Zszz3_normal.jpg",
        "coverPicture": "https://pbs.twimg.com/profile_banners/1154385013292638209/1708080962",
        "description": "",
        "location": "",
        "followers": 2110,
        "following": 1900,
        "status": "",
        "canDm": false,
        "canMediaTag": false,
        "createdAt": "Thu Jul 25 13:36:49 +0000 2019",
        "entities": {
          "description": "…",
          "url": "…"
        },
        "fastFollowersCount": 0,
        "favouritesCount": 88293,
        "hasCustomTimelines": true,
        "isTranslator": false,
        "…": "…"
      },
      "extendedEntities": {},
      "card": null,
      "place": {},
      "…": "…"
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAADDAABCgABHMsWIGtW8c4KAAIcyxXu4BsBSAAIAAIAAAACCAADAAAAAAgABAAAAAAKAAUcyxYpY8AnEAoABhzLFiljv9jwAAA",
  "status": "success",
  "msg": "success"
}
base url · https://v2.xapis.dev
Ready to call Get user mentions?