v1

latestOpenAPI 3.1.0MIT2026-08-0453113564.4 KB

Reddit Stocks

Search stocks

Search stocks by ticker, company name or alias. Results prioritize match relevance first (exact ticker matches, then prefixes, then name/alias matches) and include a compact summary block for the last 7 UTC calendar days. Summary mentions include inherited thread-context mentions; use raw /mentions without include_inherited for explicit-only rows.

get/reddit/stocks/v1/search

Query parameters

qstring required

Search query (minimum 2 non-$ characters after trimming)

Example:tesla

Search query (minimum 2 non-$ characters after trimming)

limitinteger

Maximum number of results to return

Example:20

Maximum number of results to return

Response

Successful Response

querystring required

Original search query

countinteger required

Total number of matching results before the limit is applied

period_daysinteger required

Fixed lookback window used for each summary block

Example response

{
  "query": "tesla",
  "count": 1,
  "period_days": 7,
  "results": [
    {
      "ticker": "TSLA",
      "name": "Tesla Inc.",
      "type": "Stock",
      "exchange": "NASDAQ",
      "sector": "Consumer Discretionary",
      "country": "United States",
      "aliases": [
        "Tesla",
        "Elon"
      ],
      "summary": {
        "mentions": 342,
        "buzz_score": 87.5,
        "trend": "rising",
        "sentiment_score": 0.23,
        "bearish_pct": 18,
        "bullish_pct": 45,
        "subreddit_count": 8,
        "total_upvotes": 15234,
        "unique_posts": 45
      }
    }
  ]
}