Skip to main content

Multi keyword mentions search

GET 
/v2/data/keyword-mentions

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 /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. metadata.cursor is absent on the final page. metadata.total 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, or use the SDK's fetchRawTweets: true option with a Twitter bearer token.

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.

Request​

Responses​

Ok