ADadanos
X/Twitter Stocks

Raw mentions

Changed on

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

Request

  • Base URL
    https://api.adanos.com
  • Auth
    API key in header X-API-Key

Path parameters

tickerstring required

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

Example:TSLA

Query parameters

fromstring date nullable

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.

limitinteger

Maximum number of raw tweet rows to return

Example:50
offsetinteger

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"
    }
  ]
}

Changes