Top mentions
GET/v2/data/top-mentions
Returns the most significant mentions for a given ticker symbol, ranked by engagement (viewCount → mentionedAt → relevance) within a specified time window.
Response shape. The response envelope is { success, data, metadata }.
data is a flat array of mentions; pagination state lives in metadata
(total, page, pageSize) — never merged into the top level.
No tweet content. V2 does not return raw tweet text. Use the link
field to fetch the original tweet via the Twitter/X API if needed, or use
the SDK's fetchRawTweets: true option with a Twitter bearer token.
No account object. Unlike /v2/data/keyword-mentions, this endpoint
does not return an account object per mention.
Field notes. mentionedAt is an ISO 8601 string (not a unix
timestamp). repostBreakdown.smart counts reposts by smart accounts;
repostBreakdown.ct counts reposts by crypto-Twitter accounts.
Request
Responses
- 200
- 401
Ok
Unauthorized