# Reddit Trends API

Gives your agent subreddit activity data: history, growth windows and a live hot-post feed. A Trends API key is required.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: trendsapi-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/trendsapi-ai/reddit-trends-api
- Updated: 2026-08-18
- HTML: https://affpapa.org/en/nevibecode/mcp/reddit-trends-api

## What it does

Three calls are exposed: a time series for one keyword, percent growth across chosen windows, and the current hot-post list. The community goes into the keyword without the `r/` prefix, so `wallstreetbets` rather than `r/wallstreetbets`. The `value` field is a 0-100 index for that series, not a subscriber count.

Under the hood it talks to `POST https://api.trendsapi.ai/api` and authenticates with `Authorization: Bearer $TRENDSAPI_KEY`. The same key works for the `trendsapi-reddit` Python package, which ships both sync and async clients. Every 200 response is one billed request, though asking for several growth windows at once still counts as a single one.

Reading is all you get. Posting, voting and comment streaming are out of scope. A 400 means the spelling of `source` or `type` is off — `source` is lowercase (`reddit`), `type` is exact (`Reddit Hot Posts`). On 404 there is no series for that keyword, so retrying will not help.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://reddit.api.trendsapi.ai/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http reddit-trends-api https://reddit.api.trendsapi.ai/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add reddit-trends-api --url https://reddit.api.trendsapi.ai/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "reddit-trends-api": {
            "url": "https://reddit.api.trendsapi.ai/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "reddit-trends-api": {
            "type": "http",
            "url": "https://reddit.api.trendsapi.ai/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http reddit-trends-api https://reddit.api.trendsapi.ai/mcp
```

## When to use it
- chart how a subreddit's activity moved over 12 months
- compare several growth windows in a single call
- pull the current Reddit hot posts
- load a time series into pandas and resample by month
- check whether a topic is gaining discussion before launch

## Example prompts
- Show me the discussion trend for `wallstreetbets` over the past year
- Compare `wallstreetbets` growth for 3M and 12M
- List 10 Reddit hot posts right now

## Similar
- [App Store Trends API](https://affpapa.org/en/nevibecode/mcp/app-store-trends-api.md) — MCP server
- [TikTok Trends API](https://affpapa.org/en/nevibecode/mcp/tiktok-trends-api.md) — MCP server · ★ 2
- [reddit-search-api](https://affpapa.org/en/nevibecode/skills/reddit-search-api.md) — skill · 10600 installs
- [reddit-api](https://affpapa.org/en/nevibecode/skills/alinaqi-reddit-api.md) — skill · 316 installs
- [News Sentiment Trends MCP](https://affpapa.org/en/nevibecode/mcp/news-sentiment-trends-mcp.md) — MCP server · ★ 1
- [Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)](https://affpapa.org/en/nevibecode/mcp/social-media-search-api-twitter-instagram-reddit-tiktok-xpoz.md) — MCP server · ★ 13

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md