Sign in
X/Twitter Stocks

Raw Mentions

Returns raw tweet rows for a specific ticker within the live raw-data retention window. Professional account required. Free and Hobby accounts cannot use this endpoint.

Use this endpoint when you need:

  • tweet-level snippets
  • original timestamps
  • engagement counters on the raw rows

Notes:

  • Use from and to for explicit UTC date windows
  • Results are ordered newest first and support deterministic offset + limit pagination
  • empty result sets return 200 with results=[]
get/x/stocks/v1/stock/{ticker}/mentions

Path parameters

tickerstring required

Stock ticker symbol (e.g., TSLA, $AAPL, BRK.A)

Example:TSLA

Stock ticker symbol (e.g., TSLA, $AAPL, BRK.A)

Query parameters

fromstring date nullable

Start date in YYYY-MM-DD. Inclusive UTC date.

Start date in YYYY-MM-DD. Inclusive UTC date.

tostring date nullable

End date in YYYY-MM-DD. Inclusive UTC date. Omit to use the current UTC date.

End date in YYYY-MM-DD. Inclusive UTC date. Omit to use the current UTC date.

daysinteger

Deprecated v1 compatibility shorthand. Prefer from and to for reproducible UTC date windows.

Deprecated v1 compatibility shorthand. Prefer from and to for reproducible UTC date windows.

limitinteger

Maximum number of raw tweet rows to return

Example:50

Maximum number of raw tweet rows to return

offsetinteger

Number of raw mention rows to skip for offset-based pagination.

Number of raw mention rows to skip for offset-based pagination.

Response

Successful Response

tickerstring required

Stock ticker symbol

period_daysinteger required

Lookback window used for the query

countinteger required

Total number of matching raw rows before limit and offset are applied; only the requested page is returned

Example response

{
  "ticker": "NVDA",
  "period_days": 7,
  "count": 1,
  "results": [
    {
      "tweet_id": "1901234567890",
      "author": "marketwatcher",
      "text_snippet": "$NVDA still has room after the pullback...",
      "created_utc": "2026-03-20T14:11:02Z",
      "likes": 942,
      "retweets": 88,
      "views": 52110,
      "is_reply": false,
      "sentiment_score": 0.44,
      "sentiment_label": "positive"
    }
  ]
}