SOsorsa
Search

Search Mentions

Returns tweets that mention the specified user handle. Up to 20 results per page, sorted by mention time (newest first by default). Supports the richest set of filters among all search endpoints: minimum likes, replies, retweets, and a date range. Results can also be sorted by popular or latest.

post/mentions

Request

Request body

min_likesinteger
min_repliesinteger
min_retweetsinteger
next_cursorstring
orderstring
querystring
since_datestring
until_datestring

Example request

{
  "min_likes": 100,
  "min_replies": 100,
  "min_retweets": 100,
  "next_cursor": "JKHSJFHADUYJKSDy2y3u123",
  "order": "popular",
  "query": "elonmusk",
  "since_date": "2026-01-01",
  "until_date": "2026-01-01"
}

Response

OK

next_cursorstring

Cursor for fetching the next page of results. Null or absent if no more pages.

Example response

{
  "tweets": [
    {
      "bookmark_count": 15,
      "conversation_id_str": "1782368585664626774",
      "created_at": "2024-01-15T10:30:00Z",
      "entities": [
        {
          "link": "https://t.co/example",
          "preview": "https://pbs.twimg.com/preview",
          "type": "photo"
        }
      ],
      "full_text": "Hello world",
      "id": "1782368585664626774",
      "in_reply_to_tweet_id": "1782368585664626000",
      "in_reply_to_username": "username",
      "lang": "en",
      "likes_count": 200,
      "quote_count": 5,
      "reply_count": 10,
      "retweet_count": 50,
      "user": {
        "created_at": "2009-06-02T20:12:29Z",
        "description": "Bio text",
        "display_name": "Elon Musk",
        "favourites_count": 1200,
        "followers_count": 100000,
        "followings_count": 500,
        "id": "44196397",
        "location": "Austin, TX",
        "media_count": 300,
        "profile_background_image_url": "https://pbs.twimg.com/profile_banners/44196397/123",
        "profile_image_url": "https://pbs.twimg.com/profile_images/123/photo.jpg",
        "tweets_count": 5000,
        "username": "elonmusk",
        "verified": true
      },
      "view_count": 10000
    }
  ]
}

Changes

No recorded changes to this operation across all 5 revisions of this API.