Accounts

Removed on 28 October 2026

GET /v2/account/smart-stats is legacy. It will be removed on 28 October 2026 and is not being extended. The closest v3 endpoint is People. It is a partial match: it ranks accounts by standing or track record rather than returning per-user stats.

Accounts answers: does this X account reach anyone who matters?

Endpoint	Returns
GET /v2/account/smart-stats	Follower, smart-follower, reach and engagement metrics for one username

Smart Stats

GET /v2/account/smart-stats: raw account metrics for a username.

{
  "success": true,
  "data": {
    "averageReach": 1,
    "averageEngagement": 1,
    "smartFollowingCount": 1
  }
}

curl -H "x-elfa-api-key: $ELFA_API_KEY" \
  "https://api.elfa.ai/v2/account/smart-stats?username=elfa_ai"

The spec's example uses placeholder values.

Field	Type	Meaning
data.followerCount	number	Followers. May be absent
data.smartFollowerCount	number	Followers that are smart accounts. May be absent
data.averageReach	number	Average reach of the account's posts
data.averageEngagement	number	Average engagement on the account's posts
data.smartFollowingCount	number	Smart accounts this account follows

Parameter	Required	Type	Meaning
username	Yes	string	X username to get stats for

Raw Numbers, Not a Score

These are raw numbers, not a reputation score. The signal is in the ratios:

• Inflated audience: 100k followers with 200 smart followers reads very differently from 20k followers with 4,000 smart followers.
• Whether anyone sees the posts: compare averageReach with followerCount.
• How plugged in they are: smartFollowingCount is a proxy for whether the account follows high-signal accounts.

Getting a Username

Keyword mentions returns account.username on each mention. Pass it here as username.

Also via x402: GET /x402/v2/account/smart-stats

Errors

This endpoint uses the shared v2 errors: see Enums and Errors.

Related

• Reference: smart-stats
• v3 replacement (partial): People
• Mentions and Agent Playbooks