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
- Base URL: https://api.elfa.ai
- URL: https://api.elfa.ai/v2/data/top-mentions
- Auth: API key in header x-elfa-api-key
Query parameters
The ticker symbol to get mentions for. Use $ prefix (e.g., $SOL or URL-encoded %24SOL) for exact cashtag matching only. Without $, results include both cashtag mentions and general token references.
Time window for mentions (e.g., "1h", "24h", "7d")
Start date (unix timestamp)
End date (unix timestamp)
Page number for pagination
Number of items per page
Response
Ok
Changes
No recorded changes to this operation across all 1 revision of this API.