API v1 (Legacy)
Reference
GET /reddit_mentions

GET /reddit_mentions

Reddit posts and sentiment for a search query or ticker-derived query.

Authentication

Use the apiKey (or apikey) query parameter.

Parameters

NameTypeRequiredDescription
apiKeystringyesAPI key query parameter (case-insensitive).
searchstringnoSearch string (pipe-separated supported). Requires date.
datestringnoRequired when using search (YYYY-MM-DD).
symbolstringnoTicker-based query using stored reddit_query.
sourcestringnoStocks or Crypto (search mode only).
orderstringnocreated to sort by time; otherwise sorted by score.

Behavior Notes

  • Use search + date to query a specific day.
  • Use symbol to query using the ticker's stored Reddit query.
  • Search mode returns up to 50 posts; symbol mode returns up to 10 posts.

Example (Search Mode)

curl "https://api.altindex.com/reddit_mentions?apiKey=YOUR_API_KEY&search=TSLA|Tesla&date=2026-01-27"

Response Shape (Search Mode)

{
  "status": 200,
  "search": "TSLA|Tesla",
  "count": 42,
  "sentiment": 0.62,
  "posts": [
    {
      "text": "Tesla deliveries beat expectations...",
      "created": "2026-01-27 11:23:00",
      "score": 12,
      "permalink": "https://reddit.com/r/stocks/...",
      "id": "abc123",
      "author": "user123"
    }
  ]
}