Subreddit Posts API

List the posts in a subreddit sorted by hot, new, top or rising, optionally limited to a time window. Each post includes the title, body, author, score, comment count and link. Page through results with `cursor`.

Endpoint: POST /reddit/list-subreddit-posts
Price: 1 credit per request
SDK: client.reddit.listSubredditPosts()
MCP tool: reddit_list_subreddit_posts

Start free with 100 credits Read docs →

Terminal

$curl -X POST "https://api.bridgly.app/reddit/list-subreddit-posts" \
  -H "Authorization: Bearer $BRIDGLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "subreddit": "programming",
  "sort": "top",
  "time": "week",
  "count": 10
}'

request.py

import os
import requests
response = requests.post(
    "https://api.bridgly.app/reddit/list-subreddit-posts",
    headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"},
    json={
        "subreddit": "programming",
        "sort": "top",
        "time": "week",
        "count": 10,
    },
)
data = response.json()

request.js

const response = await fetch("https://api.bridgly.app/reddit/list-subreddit-posts", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BRIDGLY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "subreddit": "programming",
    "sort": "top",
    "time": "week",
    "count": 10
  }),
});
const data = await response.json();

request.ts

import { Bridgly } from "@bridgly/sdk";
const client = new Bridgly({ apiKey: "bgly_YOUR_KEY" });
const res = await client.reddit.listSubredditPosts({
  subreddit: "programming",
  sort: "top",
  time: "week",
  count: 10
});
if (res.type === "success") {
  console.log(res.data);
}

[ REQUEST AND RESPONSE ]

What does the Subreddit Posts API return?

Subreddit scraper API: list posts in any subreddit sorted by hot, new, top or rising, from the last hour up to all time, with score, comments and link. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.

Request body

subredditstringrequired: Subreddit name, with or without the "r/" prefix, or the subreddit link, e.g. "programming" or "https://www.reddit.com/r/programming/".
sortenum: Feed ordering. Defaults to "hot".; hot | new | top | rising
timeenum: Restrict results to a recent window. Defaults to "all".; hour | day | week | month | year | all
countinteger · 1–10 · default 10: Number of results to return (1–10). Defaults to 10.
cursorstring: The previous response's `nextCursor`, to fetch the next page. Omit it for the first page.

Example response

200 OK · application/json

{
  "timeMs": 1840,
  "creditsCost": 1,
  "data": {
    "nextCursor": "string",
    "posts": [
      {
        "id": "string",
        "fullname": "string",
        "title": "string",
        "author": "string",
        "authorFullname": "string",
        "selftext": "string",
        "score": 0,
        "ups": 0,
        "downs": 0,
        "upvoteRatio": 0,
        "numComments": 0,
        "numCrossposts": 0,
        "totalAwardsReceived": 0,
        "gilded": 0,
        "createdUtc": 0,
        "createdAt": "string",
        "editedUtc": 0,
        "editedAt": "string",
        "permalink": "string",
        "postUrl": "string",
        "url": "string",
        "subreddit": "string",
        "subredditId": "string",
        "subredditUrl": "string",
        "subredditPrefixed": "string",
        "subredditSubscribers": 0,
        "subredditType": "string",
        "linkFlairText": "string",
        "domain": "string",
        "thumbnail": "string",
        "distinguished": "string",
        "isSelf": true,
        "isVideo": true,
        "isOriginalContent": true,
        "over18": true,
        "spoiler": true,
        "stickied": true,
        "pinned": true,
        "archived": true,
        "contestMode": true,
        "locked": true
      }
    ],
    "subreddit": "string"
  }
}

[ USE CASES ]

What can you build with the Subreddit Posts API?

Daily digests

Send the top posts of a subreddit each morning to a team channel.

Find content ideas

See which questions and topics rise in your niche each week.

Monitor launches

Watch new posts in product and industry communities as they arrive.

[ FAQ ]

Subreddit Posts API questions

How do I get the top posts from a subreddit this week?

Send the subreddit name with sort set to top and time set to week. Each post has the title, body, author, score, comment count and link, up to 10 per call; send the nextCursor back as cursor for the next page.

How do I monitor a subreddit for new posts?

Call it with sort set to new on a schedule and keep the posts you have not seen yet. It suits alerts on a niche subreddit or feeding new threads into a support or sales workflow.

Can I use subreddit posts for market research?

Yes. The top posts of a month or year show what a community cares about; read their comment threads with the Reddit Post API.

How do I get more than 10 posts from a subreddit?

Each call returns up to 10 posts and a nextCursor. Send it back as cursor, with the same sort, to get the next 10; it is null once there are no more posts.

How do I use the Subreddit Posts API?

Send a POST request to https://api.bridgly.app/reddit/list-subreddit-posts with subreddit in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.reddit.listSubredditPosts(). AI agents connected to Bridgly over MCP can call the reddit_list_subreddit_posts tool.

How much does the Subreddit Posts API cost?

Costs 1 credit per request. Credits cost $2.00 per 1,000 on pay-as-you-go and as low as $1.00 per 1,000 at volume. New accounts on a business email start with 100 free credits, and failed requests are never charged.

[ MORE ENDPOINTS ]

More Reddit endpoints

The same API key works on every endpoint. See all Reddit API endpoints.

Try the Subreddit Posts API

100 free credits on business email, no card. Your first call takes a minute.

APIMCPSDKCLI

free credits

On business email signup. No credit card required.

Start free with 100 credits

Book a demo Read the docs