---
title: "Raw mentions"
method: GET
path: "/reddit/crypto/v1/token/{symbol}/mentions"
tags: ["Reddit Crypto"]
---

# Raw mentions

`GET /reddit/crypto/v1/token/{symbol}/mentions`

## Request

- Base URL: `https://api.adanos.com`
- URL: `https://api.adanos.com/reddit/crypto/v1/token/{symbol}/mentions`
- Auth: API key in header `X-API-Key`

Returns raw Reddit mention rows for a specific crypto symbol 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

- `symbol` string, required: Crypto symbol (e.g., BTC, $ETH, SOL)

## 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.
- `limit` integer: Maximum number of raw mentions to return
- `offset` integer: Number of raw mention rows to skip for offset-based pagination.
- `include_inherited` boolean: Include inherited thread-context mentions in addition to direct symbol matches

## Response `200`

Successful Response

- CryptoRawMentionsResponse: Paginated raw Reddit crypto mentions for a single symbol.
  - `symbol` string, required: Crypto 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` CryptoRawMentionItem[], 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: UTC timestamp of creation (ISO 8601)
    - `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 symbol 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

## Changes

- **2026-09-30** `a74a23b969c4`: 1 info
  - deleted the `query` request parameter `days` with deprecation

[Operation history](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/changes/reddit/crypto/v1/token/:symbol/mentions/get.md)

---

[API](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api.md) - [All operations](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/revisions/7e8bdb1e7e75?raw)