latestOpenAPI 3.0.32026-08-02415689.9 KB

7742c72d6966

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 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

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
    }
  ]
}