Sign in
Reddit Stocks

Raw Mentions

Returns raw mention rows for a specific stock 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:

  • post/comment-level snippets
  • original timestamps
  • inherited-context filtering

Notes:

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

Path parameters

tickerstring required

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

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

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 mention rows to return

Example:50

Maximum number of raw mention 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.

include_inheritedboolean

Include thread-context inherited mentions in addition to direct ticker mentions

Include thread-context inherited mentions in addition to direct ticker mentions

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 for the requested include_inherited filter before limit and offset are applied; only the requested page is returned

Example response

{
  "ticker": "TSLA",
  "period_days": 7,
  "count": 1,
  "results": [
    {
      "post_id": "abc123",
      "comment_id": "def456",
      "subreddit": "wallstreetbets",
      "author": "user123",
      "text_snippet": "TSLA looks strong into earnings...",
      "created_utc": "2026-03-20T18:42:10Z",
      "upvotes": 381,
      "sentiment_score": 0.62,
      "sentiment_label": "positive",
      "is_inherited": false
    }
  ]
}