GET /reddit_mentions
Reddit posts and sentiment for a search query or ticker-derived query.
Authentication
Use the apiKey (or apikey) query parameter.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| apiKey | string | yes | API key query parameter (case-insensitive). |
| search | string | no | Search string (pipe-separated supported). Requires date. |
| date | string | no | Required when using search (YYYY-MM-DD). |
| symbol | string | no | Ticker-based query using stored reddit_query. |
| source | string | no | Stocks or Crypto (search mode only). |
| order | string | no | created to sort by time; otherwise sorted by score. |
Behavior Notes
- Use
search+dateto query a specific day. - Use
symbolto 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"
}
]
}