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 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

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