Multi keyword mentions search
Search mentions by keywords OR account name within a time period. Either keywords or accountName (or both) must be provided.
Response shape. The response envelope is { success, data, metadata }. data is a flat array of mentions; pagination state lives in metadata.
Cursor pagination. Unlike /x402/v2/data/top-mentions (which uses page/pageSize), this endpoint is cursor-paginated. metadata.cursor is a millisecond timestamp (number). To fetch the next page, pass its value back as the cursor query param. Page until data is empty; metadata.cursor is only omitted on that empty page. metadata.total is the complete matching result set, not the remainder after the cursor, and may be capped at 10000 for performance.
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.
Account info. Each mention includes a minimal account object with only username and isVerified. No id, display name, follower count, or bio is returned.
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.
Cost: 1 credit ($0.0145). Requires x402 payment.
Request
- Base URL: https://api.elfa.ai
- URL: https://api.elfa.ai/x402/v2/data/keyword-mentions
- Auth: none required
Query parameters
Up to 5 keywords to search for, separated by commas (optional if accountName provided)
Account username to filter by (optional if keywords provided)
Time window for mentions (e.g., "1h", "24h", "7d")
Start date (unix timestamp)
End date (unix timestamp)
Number of results to return (max 30)
Type of search (and, or)
Cursor for pagination (millisecond timestamp from a previous response's metadata.cursor)
Set to false to exclude reposts (default: included)
Response
Ok
Changes
No recorded changes to this operation across all 1 revision of this API.