Skip to content

List subreddit posts

GET/v1/reddit/subreddits/{name}/posts
MCPreddit_subreddit_posts1 creditLive

Updated

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 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. Default hot.
time query, enum
Used when sort is top or controversial. One of: hour, day, week, month, year, all. Default week.
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:

FieldTypeNullableDescription
idstringnoPlatform id.
fullnamestringnoReddit fullname (t3_ for posts, t1_ for comments). Dedupe on this.
titlestringnoTitle.
bodystringnoText body. Empty for link and media posts.
authorstringyesAuthor username, null when deleted.
subredditstringnoSubreddit name without r/.
permalinkstringnoPath on reddit.com.
urlstringnoFull URL on the platform.
externalUrlstringyesLink the post points to, when it is a link post.
scorenumberyesScore (upvotes minus downvotes) as Reddit reports it.
numCommentsnumberyesComment count.
upvoteRationumberyesShare of upvotes, 0 to 1.
createdAtstringnoISO 8601 UTC timestamp.
nsfwbooleannoMarked adult content.
lockedbooleanyesComments are locked.
mediaobjectyesImages, 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.

Errors this endpoint can return

Try it