Reddit Hot Posts trending API

Newsrooms, growth teams, and agent workflows often need a fast read on what Reddit is amplifying right now. The native Reddit API can do that, but OAuth setup, rate cards, and endpoint selection add friction when the only requirement is a ranked title list.

Trends MCP documents Reddit Hot Posts as a top_trends feed. One POST returns rank and title pairs with a timestamp.

Request body

{
  "mode": "top_trends",
  "type": "Reddit Hot Posts",
  "limit": 25
}

Quota follows the standard top-trends model: each feed and each paginated page counts toward the monthly budget. Read https://www.trendsmcp.ai/docs before polling wide offsets in a tight loop.

Response shape

A Trends MCP API snapshot on 2026-07-26 returned:

{
  "as_of_ts": "2026-07-26T01:01:35.714461+00:00",
  "type": "Reddit Hot Posts",
  "limit": 5,
  "offset": 0,
  "count": 5,
  "data": [
    [1, "No seriously…why??"],
    [2, "Customer tracking me"],
    [3, "My dad's blood sugar pill is pink and heart-shaped"],
    [4, "1992 Olympic torch lighting"],
    [5, "Cone Gratulations Everyone"]
  ]
}

Each row is [rank, title]. Set limit up to 200. Use offset for pagination.

Endpoint

POST https://api.trendsmcp.ai/api
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Code examples

Python

import requests

res = requests.post(
    "https://api.trendsmcp.ai/api",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={"mode": "top_trends", "type": "Reddit Hot Posts", "limit": 25},
    timeout=30,
)
payload = res.json()
for rank, title in payload["data"]:
    print(rank, title)

JavaScript

const res = await fetch("https://api.trendsmcp.ai/api", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    mode: "top_trends",
    type: "Reddit Hot Posts",
    limit: 25,
  }),
});
const payload = await res.json();

cURL

curl -s -X POST https://api.trendsmcp.ai/api \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode":"top_trends","type":"Reddit Hot Posts","limit":25}'

Pair hot titles with subreddit history

Hot posts show what is loud today. Subreddit subscriber curves show whether a community has been building for months. After a title spikes, pull the subreddit source when the community name is known:

{
  "mode": "get_time_series",
  "source": "reddit",
  "keyword": "worldnews"
}

Subreddit keywords omit the r/ prefix. Broader Reddit discussion context lives on https://www.trendsmcp.ai/reddit-discussion-data.

Editorial and crisis workflows

Morning briefings often copy ten post titles from a browser tab. A scheduled JSON job stores rank, title, and as_of_ts so editors review a queue with timestamps. The list is noisy by design: humor, local stories, and breaking news share the same feed.

Crisis and comms teams sometimes watch hot rankings for brand or executive mentions. A title on the hot list is a triage signal, not confirmation of sentiment. Follow with news volume or Google Search pulls when the story might leave Reddit.

MCP usage in coding agents

Add the hosted MCP server from https://www.trendsmcp.ai/mcp-server-for-cursor and ask: "Via TrendsMCP, what are the top Reddit Hot Posts right now?" The via TrendsMCP phrasing routes the client to tool calls instead of a generic web search.

For Claude Code and other CLI agents, the same endpoint and Bearer header apply as documented on https://www.trendsmcp.ai/mcp-server-for-claude-code.

Errors

Related pages

Reddit subreddit time series: https://www.trendsmcp.ai/reddit-trends

Reddit API pricing context: https://www.trendsmcp.ai/reddit-api

All live trending feeds: https://www.trendsmcp.ai/trending-topics-api