Skip to main content
Portal

Mentions and Accounts

Mentions and account endpoints help answer: who amplified this, how good was the attention, and should the account matter to my agent?

Content boundary

These endpoints return links and engagement metrics. They do not return tweet text and do not return sentiment.

Top Mentions​

Top mentions returns the most significant mentions for a ticker, ranked by attention signals.

Use it to:

  • Separate smart amplification from broad amplification: compare repostBreakdown.smart with repostBreakdown.ct.
  • Measure depth, not only applause: high bookmarkCount relative to likeCount can indicate stronger intent than a like.
  • Detect an argument: high quoteCount relative to repostCount suggests people are talking back, not just passing it along.
  • Find the post to cite: use link when your report, alert, or agent response needs a source.

This is an attention-quality endpoint, not a content-ingestion endpoint.

Keyword Mentions​

Keyword mentions searches up to five keywords or an account name over a time window.

Use it to:

  • Get the author join key: this is the mention endpoint that returns account.username, which you can pass into Smart Stats.
  • Watch a name over time: track a protocol, product, competitor, or ticker on a schedule.
  • Catch spikes early: judge movement on volume and amplification, not sentiment.
  • Search precisely: use searchType=and when all terms must be present, or searchType=or when any term can match.

Operational limits to design around: results are cursor paginated, limit is capped at 30 per call, and metadata.total may be capped at 10,000.

Smart Stats​

Smart stats returns raw account metrics: follower count, smart followers, average reach, average engagement, and smart following.

Use it to:

  • Spot an inflated audience: 100k followers with 200 smart followers reads very differently from 20k followers with 4,000 smart followers.
  • Check whether anyone sees the posts: compare averageReach with followerCount.
  • Judge how plugged in they are: smartFollowingCount is a proxy for whether an account follows high-signal accounts.
  • Prune a watchlist: keep accounts that move attention and drop accounts that only post.
  • Do diligence before paying: check actual reach before a collaboration or campaign.
Experimental endpoint

/v2/account/smart-stats is experimental. It returns raw numbers, not a reputation score; the signal is in the ratios.

Common Chain​

For trust-weighted mentions, call Keyword Mentions, extract account.username, then call Smart Stats for each account you need to score.