API Reference

Description:Provides historical data on the number of Smart Mentions for a X account. These mentions come from "smart" accounts, manually curated by moderators, and include mentions from users who are not necessarily followers.

  • Graph-ready data – structured for date vs. mention count visualization.

  • Smart mentions tracking – see how often key accounts reference this profile.

  • Custom timeframes – query by last 1H, 24H, 7D, 30D, or 1Y.

Usage: Use this endpoint to analyze engagement from influential users and track shifts in relevance within the smart audience. Monitor mentions from high-value, curated accounts. Identify spikes in attention from smart users. Compare smart mentions across different timeframes.

Usage Cost: 4 points per request

Timeframe: The time range for the returned data. Possible values:

  • H1 - Last 1 hour

  • H24 - Last 24 hours

  • D7 - Last 7 days

  • D30 - Last 30 days

  • Y1 - Last 1 year

Log in to see full request history
Path Params
string
required

The username (handle) of the user in x.com

Query Params
string
Defaults to H24

Timeframe

Headers
string
required
Response

Response body
object
chart
array

List of [Timestamp (UNIX) representing the date, Historical value on this date]

chart
float

Change in value over the specified timeframe

float

Change in value since the account was first identified

float

Value at the time the account was first discovered

Language