Reddit Stock
Sentiment API

[
  {
    "ticker": "TSLA",
    "company_name": "Tesla, Inc.",
    "buzz_score": 87.5,
    "trend": "rising",
    "mentions": 342,
    "unique_posts": 45,
    "subreddit_count": 8,
    "sentiment_score": 0.23,
    "bullish_pct": 45,
    "bearish_pct": 18,
    "total_upvotes": 15234
  }
]

Returns sectors with highest aggregated buzz on Reddit, ranked by buzz score. Combines all stock mentions per sector and includes the top 5 tickers per sector.

Query Parameters

days	Time period in days (1-30, default: 1)
limit	Maximum results (1-100, default: 20)
offset	Skip first N results for pagination (default: 0)

Response

[
  {
    "sector": "Technology",
    "buzz_score": 78.4,
    "trend": "rising",
    "mentions": 4523,
    "unique_tickers": 34,
    "subreddit_count": 15,
    "sentiment_score": 0.28,
    "bullish_pct": 54,
    "bearish_pct": 22,
    "total_upvotes": 128450,
    "top_tickers": ["NVDA", "AAPL", "MSFT", "AMD", "GOOGL"]
  }
]

Response Fields

sector	Industry sector name
buzz_score	Aggregated buzz score (0-100)
trend	rising, falling, or stable
mentions	Total mentions across all tickers in sector
unique_tickers	Number of unique tickers mentioned
subreddit_count	Number of subreddits with mentions
sentiment_score	Weighted average sentiment (-1 to +1)
bullish_pct	Percentage of bullish mentions
bearish_pct	Percentage of bearish mentions
total_upvotes	Total upvotes across all mentions
top_tickers	Top 5 tickers by mention count

Returns countries with highest aggregated buzz on Reddit, ranked by buzz score. Combines all stock mentions per country and includes the top 5 tickers per country.

Query Parameters

days	Time period in days (1-30, default: 1)
limit	Maximum results (1-100, default: 20)
offset	Skip first N results for pagination (default: 0)

Response

[
  {
    "country": "United States",
    "buzz_score": 82.3,
    "trend": "stable",
    "mentions": 8934,
    "unique_tickers": 156,
    "subreddit_count": 18,
    "sentiment_score": 0.21,
    "bullish_pct": 48,
    "bearish_pct": 26,
    "total_upvotes": 245000,
    "top_tickers": ["NVDA", "TSLA", "AAPL", "AMD", "PLTR"]
  }
]

Response Fields

country	Country name
buzz_score	Aggregated buzz score (0-100)
trend	rising, falling, or stable
mentions	Total mentions across all tickers from country
unique_tickers	Number of unique tickers mentioned
subreddit_count	Number of subreddits with mentions
sentiment_score	Weighted average sentiment (-1 to +1)
bullish_pct	Percentage of bullish mentions
bearish_pct	Percentage of bearish mentions
total_upvotes	Total upvotes across all mentions
top_tickers	Top 5 tickers by mention count

Returns detailed sentiment analysis for a specific stock ticker. Includes daily trend data, top mentions by upvotes, and top subreddits.

Path Parameters

ticker

Stock ticker symbol (1-5 uppercase letters, e.g., TSLA)

Query Parameters

days	Time period in days (1-90, default: 7)

Response

{
  "ticker": "TSLA",
  "company_name": "Tesla, Inc.",
  "found": true,
  "buzz_score": 87.5,
  "total_mentions": 342,
  "sentiment_score": 0.23,
  "positive_count": 154,
  "negative_count": 62,
  "neutral_count": 126,
  "total_upvotes": 15234,
  "unique_posts": 45,
  "subreddit_count": 8,
  "period_days": 7,
  "daily_trend": [
    { "date": "2024-12-27", "mentions": 52, "sentiment": 0.31 },
    { "date": "2024-12-26", "mentions": 48, "sentiment": 0.18 }
  ],
  "top_subreddits": [
    { "subreddit": "wallstreetbets", "count": 89 },
    { "subreddit": "stocks", "count": 67 }
  ],
  "top_mentions": [
    {
      "text_snippet": "TSLA looking strong after...",
      "sentiment_score": 0.85,
      "sentiment_label": "positive",
      "upvotes": 1234,
      "subreddit": "wallstreetbets",
      "created_utc": "2024-12-27T10:30:00"
    }
  ]
}

Response Fields

ticker	Stock ticker symbol
company_name	Company name (null if not found)
found	Whether mentions were found
buzz_score	Overall buzz score (0-100)
total_mentions	Total number of mentions
sentiment_score	Average sentiment (-1 to +1)
positive_count	Number of positive mentions
negative_count	Number of negative mentions
neutral_count	Number of neutral mentions
total_upvotes	Total upvotes across all mentions
unique_posts	Number of unique posts
subreddit_count	Number of subreddits with mentions
period_days	Analysis period in days
daily_trend	Array of daily mentions and sentiment
top_subreddits	Top subreddits by mention count
top_mentions	Top mentions by upvotes

Error Codes

404	No mentions found for ticker in the specified period
401	Missing or invalid API key

Returns an AI-generated explanation of why a stock is trending based on recent Reddit user-comments.

Path Parameters

ticker

Stock ticker symbol (1-5 uppercase letters, e.g., TSLA)

Response

{
  "ticker": "TSLA",
  "company_name": "Tesla, Inc.",
  "explanation": "Tesla is trending due to strong Q4 delivery numbers and renewed investor optimism about EV demand.",
  "cached": false,
  "generated_at": "2025-01-14T12:30:00Z",
  "model": "SmolLM3 3B"
}

Response Fields

ticker	Stock ticker symbol
company_name	Company name (null if not found)
explanation	1-2 sentence AI-generated summary of why the stock is trending
cached	Whether the response was served from cache
generated_at	ISO timestamp when the explanation was generated
model	LLM model used for generation (null if unavailable)

Error Codes

404	No mentions found for ticker
401	Missing or invalid API key
503	Explanation service temporarily unavailable

Search for stocks by ticker symbol or company name. Returns matching stocks with their mention counts.

Query Parameters

q	Search query (ticker or company name, required)

Response

{
  "query": "tesla",
  "count": 1,
  "results": [
    {
      "ticker": "TSLA",
      "name": "Tesla Inc.",
      "aliases": ["Tesla", "Elon"],
      "mention_count": 342
    }
  ]
}

Response Fields

query	Original search query
count	Number of results found
results	Array of matching stocks
results[].ticker	Stock ticker symbol
results[].name	Company name
results[].aliases	Alternative names/aliases
results[].mention_count	Total mentions in database

Compare sentiment metrics for up to 10 stocks side by side.

Query Parameters

tickers	Comma-separated list of tickers (max 10, required)
days	Time period in days (1-90, default: 7)

Response

{
  "period_days": 7,
  "stocks": [
    {
      "ticker": "TSLA",
      "company_name": "Tesla, Inc.",
      "buzz_score": 87.5,
      "mentions": 342,
      "sentiment": 0.23,
      "upvotes": 15234
    },
    {
      "ticker": "NVDA",
      "company_name": "NVIDIA Corporation",
      "buzz_score": 72.3,
      "mentions": 189,
      "sentiment": 0.45,
      "upvotes": 8921
    }
  ]
}

Response Fields

period_days	Analysis period in days
stocks	Array of stock comparison data
stocks[].ticker	Stock ticker symbol
stocks[].company_name	Company name (null if not found)
stocks[].buzz_score	Overall buzz score (0-100)
stocks[].mentions	Total number of mentions
stocks[].sentiment	Average sentiment (-1 to +1)
stocks[].upvotes	Total upvotes across all mentions

Error Codes

400	Maximum 10 tickers allowed
401	Missing or invalid API key