Subreddit Posts
GET
/v1/reddit/subreddits/{name}/postsMCP
reddit_subreddit_posts1 creditLiveUpdated
Description
List a subreddit's posts by hot, new, top, rising, controversial or best. Returns post objects with score, comment count and link. Costs 1 credit per page. Tip: sort=top with time=week shows what that community rewards; sort=new is the freshest feed.
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
name | path | string | yes | Subreddit name, r/name or URL, e.g. SaaS. | |
sort | query | enum | no | hot | Feed order. One of: hot, new, top, rising, controversial, best. |
time | query | enum | no | week | Used when sort is top or controversial. One of: hour, day, week, month, year, all. |
nsfw | query | boolean,string | no | When false, NSFW posts are removed. | |
limit | query | integer | no | 25 | Max rows to return (1-100). Reddit pages hold about 25 rows; larger values still return one page. Range 1 to 100. |
cursor | query | string | no | Opaque cursor from the previous response's page.nextCursor. Length 1 to 2048. |
- name path, string, required
- Subreddit name, r/name or URL, e.g. SaaS.
- sort query, enum
- Feed order. One of:
hot,new,top,rising,controversial,best. Defaulthot. - time query, enum
- Used when sort is top or controversial. One of:
hour,day,week,month,year,all. Defaultweek. - nsfw query, boolean,string
- When false, NSFW posts are removed.
- limit query, integer
- Max rows to return (1-100). Reddit pages hold about 25 rows; larger values still return one page. Range 1 to 100. Default
25. - cursor query, string
- Opaque cursor from the previous response's page.nextCursor. Length 1 to 2048.
Request examples
curl "https://chatterapi.com/v1/reddit/subreddits/SaaS/posts?sort=top&time=week" \
-H "Authorization: Bearer $CHATTERAPI_KEY"Response
data is a list of RedditPost, with page.nextCursor and page.hasMore for the next page. Fields:
| Field | Type | Nullable | Description |
|---|---|---|---|
id | string | no | Platform id. |
fullname | string | no | Reddit fullname (t3_ for posts, t1_ for comments). Dedupe on this. |
title | string | no | Title. |
body | string | no | Text body. Empty for link and media posts. |
author | string | yes | Author username, null when deleted. |
subreddit | string | no | Subreddit name without r/. |
permalink | string | no | Path on reddit.com. |
url | string | no | Full URL on the platform. |
externalUrl | string | yes | Link the post points to, when it is a link post. |
score | number | yes | Score (upvotes minus downvotes) as Reddit reports it. |
numComments | number | yes | Comment count. |
upvoteRatio | number | yes | Share of upvotes, 0 to 1. |
createdAt | string | no | ISO 8601 UTC timestamp. |
nsfw | boolean | no | Marked adult content. |
locked | boolean | yes | Comments are locked. |
media | object | yes | Images, video or gallery URLs, or null. |
response
{
"data": [
{
"id": "1wwnhbt",
"fullname": "t3_1wwnhbt",
"title": "I've created Open Source 100% Rust clean-room replacements for 7 of Adobe's apps: Photoshop, Illustrator, Premiere, Lightroom, After Effects, InDesign, and Acrobat Pro. Free, no subscription, and you own the source code",
"body": "I've used Opus 5.5 to help me recreate 7 of the top Adobe apps in 100% pure native Rust:\n\n* Photoshop\n* Illustrator\n* Premiere\n* Lightroom\n* Acrobat Pro\n* After Effects\n* InDesign\n\nNo more subscriptions with cancellation fees. These are yours to own forever. You can fork them, build them. Whatever. They are yours to own. They're open source.\n\nIf you're worried this is just some one-off flash in the pan that will die, it isn't:\n\nI'm not just some casual vibe coder. I'm a 15-year industry veteran who has written everything from six-nines payment rails that move billions of dollars of transaction volume a day to advanced robotics and optics automation. I've used Rust extensively for about a decade, and I know how to build and maintain large-scale Rust projects.\n\nThis isn't going to be some orphaned small-team project either. We have a team building popular software for filmmakers, so supporting this is fully funded. Our purpose is serving every artist in the world with the best tools. We are absolutely going to bring these to full parity and squash every bug and feature request. We have a test harness so there won't be regressions.\n\nYou can help us reach parity by helping test the apps. Clone the code. Submit PRs. If you see gaps or want to help redesign pieces, let us know! You can contribute!\n\nLinks to everything - the apps, the code, etc. - are in the comments below.",
"author": "ai_art_is_art",
"subreddit": "SaaS",
"permalink": "/r/SaaS/comments/1wwnhbt/ive_created_open_source_100_rust_cleanroom/",
"url": "https://www.reddit.com/r/SaaS/comments/1wwnhbt/ive_created_open_source_100_rust_cleanroom/",
"externalUrl": null,
"score": 1773,
"numComments": 378,
"upvoteRatio": 0.9794037940379404,
"createdAt": "2026-10-03T13:37:37.000Z",
"nsfw": false,
"locked": null,
"media": null
},
{
"id": "1wvjgm2",
"fullname": "t3_1wvjgm2",
"title": "I made $7,802 today",
"body": "Pretty stoked on this.\n\nI do B2B cold SMS marketing, not many of us exist.\n\nAsk me anything.\n\nMy Youtube Channel (more info):\n\nhttps://youtube.com/@mrkylebanks",
"author": "OkPositive9373",
"subreddit": "SaaS",
"permalink": "/r/SaaS/comments/1wvjgm2/i_made_7802_today/",
"url": "https://www.reddit.com/r/SaaS/comments/1wvjgm2/i_made_7802_today/",
"externalUrl": null,
"score": 614,
"numComments": 276,
"upvoteRatio": 0.9456681350954479,
"createdAt": "2026-10-02T03:29:02.000Z",
"nsfw": false,
"locked": null,
"media": null
},
{
"id": "1wy79m1",
"fullname": "t3_1wy79m1",
"title": "Me and my saas ideas",
"body": "",
"author": "ImTomSnow",
"subreddit": "SaaS",
"permalink": "/r/SaaS/comments/1wy79m1/me_and_my_saas_ideas/",
"url": "https://www.reddit.com/r/SaaS/comments/1wy79m1/me_and_my_saas_ideas/",
"externalUrl": null,
"score": 547,
"numComments": 44,
"upvoteRatio": 0.9963702359346642,
"createdAt": "2026-10-05T12:28:18.000Z",
"nsfw": false,
"locked": null,
"media": null
}
],
"page": {
"nextCursor": "eyJ2IjoxLCJwIjoiYW55YXBpIiwiYyI6bnVsbCwibyI6MjUsImgiOiJiNzM3MmQ2ZTA0NDEifQ",
"hasMore": true
},
"credits": {
"charged": 1,
"remaining": 24997
},
"requestId": "req_01JA7Q3V8K2N4P5R6S7T8V",
"cached": false
}Recorded live response captured 2026-10-07, truncated to 3 items. Credits and request id are illustrative.
Credits
1 credit per call. Failed calls cost 0. Cached responses cost the same. Test keys cost 0. Repeat calls with the same input within 6 hours are served from cache.