API Reference

Description: Provides historical data on the number of "smart" followers (manually curated by moderators) for a X account.

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

  • Follower change tracking – see new additions & removals over time.

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

Usage: Use this endpoint to analyze long or short-term smart audience growth trends & dynamics. Build historical charts of smart followers. Identify growth spikes & declines over time. Compare follower trends 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