v1

latestOpenAPI 3.0.32026-07-213841124.9 KB

Search for Mentions of account

Returns tweets that mention a specific user, selected by the user’s handle. Results are sorted by mention time in descending order (newest first). Each page returns up to 20 mentions, and you can use next_cursor to load the next page. Each mention includes the tweet text and key metrics, plus basic author info.

Use cases:

Customer support teams tracking public replies and complaints about a brand account; community managers monitoring shoutouts and conversations around a project or founder; marketing teams measuring campaign mentions and finding UGC to repost; analytics tools collecting mentions over time for reporting and sentiment tagging; developers building a notifications-style mentions inbox with cursor pagination.

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