API Reference

Mentions History

Description: Provides historical data on the total number of mentions for a X account.

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

  • Change tracking – see how mention frequency evolves over time.

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

Usage: Use this endpoint to analyze audience engagement trends and detect spikes in attention. Build historical mention charts for tracking engagement. Identify sudden spikes in visibility (viral moments, controversy, promotions). Compare mentions of trends across different timeframes.

Usage Cost: 2 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

  • D90 - Last 90 days

  • D180 - Last 180 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