Get User Mentions

Get tweets that mention a given @handle, 20 per page.

GET https://api.aisa.one/apis/v1/twitter/user/mentions

Get User Mentions

cURL

curl --request GET \
  --url https://api.aisa.one/apis/v1/twitter/user/mentions \
  --header 'Authorization: Bearer <token>'

200

{
  "tweets": [
    {
      "type": "<string>",
      "id": "<string>",
      "url": "<string>",
      "text": "<string>",
      "source": "<string>",
      "retweetCount": 123,
      "replyCount": 123,
      "likeCount": 123,
      "quoteCount": 123,
      "viewCount": 123,
      "createdAt": "<string>",
      "lang": "<string>",
      "bookmarkCount": 123,
      "isReply": true,
      "inReplyToId": "<string>",
      "conversationId": "<string>",
      "displayTextRange": [
        123
      ],
      "inReplyToUserId": "<string>",
      "inReplyToUsername": "<string>",
      "author": {
        "type": "<string>",
        "userName": "<string>",
        "url": "<string>",
        "id": "<string>",
        "name": "<string>",
        "isBlueVerified": true,
        "verifiedType": "<string>",
        "profilePicture": "<string>",
        "coverPicture": "<string>",
        "description": "<string>",
        "location": "<string>",
        "followers": 123,
        "following": 123,
        "canDm": true,
        "createdAt": "<string>",
        "favouritesCount": 123,
        "hasCustomTimelines": true,
        "isTranslator": true,
        "mediaCount": 123,
        "statusesCount": 123,
        "withheldInCountries": [
          "<string>"
        ],
        "possiblySensitive": true,
        "pinnedTweetIds": [
          "<string>"
        ],
        "isAutomated": true,
        "automatedBy": "<string>",
        "unavailable": true,
        "message": "<string>",
        "unavailableReason": "<string>"
      },
      "entities": {
        "hashtags": [
          {
            "indices": [
              123
            ],
            "text": "<string>"
          }
        ],
        "urls": [
          {
            "display_url": "<string>",
            "expanded_url": "<string>",
            "indices": [
              123
            ],
            "url": "<string>"
          }
        ],
        "user_mentions": [
          {
            "id_str": "<string>",
            "name": "<string>",
            "screen_name": "<string>"
          }
        ]
      }
    }
  ],
  "has_next_page": true,
  "next_cursor": "<string>",
  "status": "success",
  "msg": "<string>",
  "code": 123
}

Get tweets that mention a given @handle, 20 per page. This is the only user-scoped X endpoint that supports a time window: pass sinceTime and/or untilTime as Unix timestamps in seconds to bound the range. Use this for monitoring — brand mentions, inbound replies, reputation tracking, or ‘what happened to this account in the last 24 hours’.

Returns tweets with has_next_page and next_cursor.

For the account’s own posts rather than mentions of it, use get_twitter_user_tweet_timeline.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

userName · string · required

The user screen name to get mentions for.

sinceTime · integer<int64>

On or after a specified unix timestamp in seconds.

untilTime · integer<int64>

Before a specified unix timestamp in seconds.

cursor · string

The cursor to paginate through the results. First page is empty.

Response

200 - application/json

Successful response

tweets · object[]

Show child attributes

has_next_page · boolean

next_cursor · string

status · enum<string>

Available options: success, error

msg · string

code · integer