---
title: "Raw Mentions"
method: GET
path: "/reddit/stocks/v1/stock/{ticker}/mentions"
tags: ["Reddit Stocks"]
---

# Raw Mentions

`GET /reddit/stocks/v1/stock/{ticker}/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=[]`

## Path parameters

- `ticker` string, required — Stock ticker symbol (e.g., TSLA, aapl, BRK.A, $GME)

## Query parameters

- `from` string, date, nullable — Start date in YYYY-MM-DD. Inclusive UTC date.
- `to` string, date, nullable — End date in YYYY-MM-DD. Inclusive UTC date. Omit to use the current UTC date.
- `days` integer — Deprecated v1 compatibility shorthand. Prefer `from` and `to` for reproducible UTC date windows.
- `limit` integer — Maximum number of raw mention rows to return
- `offset` integer — Number of raw mention rows to skip for offset-based pagination.
- `include_inherited` boolean — Include thread-context inherited mentions in addition to direct ticker mentions

## Response `200`

Successful Response

- RedditRawMentionsResponse — Paginated raw Reddit mentions for a single ticker.
  - `ticker` string, required — Stock ticker symbol
  - `period_days` integer, required — Lookback window used for the query
  - `count` integer, 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
  - `results` RedditRawMentionItem[], required — Raw mention rows ordered by newest first
    - `post_id` string, nullable — Reddit post identifier
    - `comment_id` string, nullable — Reddit comment identifier when the mention comes from a comment
    - `subreddit` string, nullable — Source subreddit
    - `author` string, nullable — Public Reddit author name, if scraped
    - `text_snippet` string, required — Stored mention snippet (truncated at ingestion time)
    - `created_utc` string, date-time, required — ISO timestamp of creation
    - `upvotes` integer, required — Reddit score (upvotes) for this mention row
    - `sentiment_score` number, nullable — Sentiment score (-1 to +1)
    - `sentiment_label` string, nullable — Sentiment label (positive/negative/neutral)
    - `is_inherited` boolean, required — Whether ticker context was inherited from the parent thread instead of directly mentioned

## Other responses

- `401` — Authentication failed
- `403` — Historical data limit exceeded
- `422` — Invalid period or query parameters
- `429` — Rate limit exceeded
- `503` — Database temporarily unavailable
- `504` — Analytics request deadline exceeded

---

[API](https://skmtc.net/adanos/apis/adanos-market-sentiment-api.md) · [All operations](https://skmtc.net/adanos/apis/adanos-market-sentiment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adanos/adanos-market-sentiment-api/revisions/351caf64ba81/schema)