Skip to content

Reddit post API

A Reddit post API can mean reading posts or creating them. This API reads: it fetches a post by id, searches posts, or lists a subreddit. It is read-only. To create a post you need an approved Reddit app of your own.

Fetch a Reddit post now, no signupThen call the same data from code.
Reddit post api: a reader at a village noticeboard lifting one pinned note to read it closely.

The job

To get comments from a post, call reddit.thread with the post id and read the nested replies; to get posts from a subreddit, list its feed by sort. Most jobs only need reading, such as monitoring a topic, collecting a dataset or checking how a thread is doing. Each post comes back with its title, body, author, score, comment count, time and link.

If you want to publish posts, use Reddit's own API, which needs an approved app. See how to use the Reddit API and Reddit API application.

How it works

  1. Read one post

    Call reddit.scrape with the post id or link.

  2. Search posts

    Call reddit.search with a keyword and a time window.

  3. List a community

    Call reddit.subreddit_posts with the subreddit name and a sort.

Endpoints that do it

EndpointWhat it's forCredits
Get a postGET /v1/reddit/posts/{id}One post by id or link.2 credits
Search postsGET /v1/reddit/searchPosts by keyword.2 credits
List subreddit postsGET /v1/reddit/subreddits/{name}/postsA subreddit's posts.2 credits
Get a thread with commentsGET /v1/reddit/threads/{id}A post with its comments.3 credits

Free tools for the same job

Try the job in a browser first. These tools call the same endpoints, and you don't need a key or any code.

Reading posts

Use a search call. Each post has a score, comment count and date.

curl "https://api.chatterapi.com/v1/reddit/search?q=best+crm+for+small+business&time=year" \
  -H "Authorization: Bearer $CHATTERAPI_KEY"
response, first 2 rows
{
  "data": [
    {
      "id": "1wdihhj",
      "fullname": "t3_1wdihhj",
      "title": "What CRM should a small business use?",
      "body": "We’re a small B2B business with 6 people and sales is still pretty founder led, but revenue has grown enough that keeping leads, follow ups and customer conversations spread across spreadsheets and inboxes is starting to…",
      "author": "NotedWhisky",
      "subreddit": "CRM",
      "permalink": "/r/CRM/comments/1wdihhj/what_crm_should_a_small_business_use/",
      "url": "https://www.reddit.com/r/CRM/comments/1wdihhj/what_crm_should_a_small_business_use/",
      "externalUrl": null,
      "score": 51,
      "numComments": 186,
      "upvoteRatio": null,
      "createdAt": "2026-09-11T14:52:16.000Z",
      "nsfw": false,
      "locked": null,
      "media": null
    },
    {
      "id": "1vmy4xb",
      "fullname": "t3_1vmy4xb",
      "title": "If You Had to Pick the Best CRM for Small Business Today, What Would It Be?",
      "body": "I've spent the last few days reading reviews and watching videos, and somehow I'm even more undecided than when I started.\n\nEvery CRM looks amazing on its website, but that doesn't tell you what it's like after you've be…",
      "author": "Living_Dependent242",
      "subreddit": "CRMSoftware",
      "permalink": "/r/CRMSoftware/comments/1vmy4xb/if_you_had_to_pick_the_best_crm_for_small/",
      "url": "https://www.reddit.com/r/CRMSoftware/comments/1vmy4xb/if_you_had_to_pick_the_best_crm_for_small/",
      "externalUrl": null,
      "score": 10,
      "numComments": 56,
      "upvoteRatio": null,
      "createdAt": "2026-08-13T02:25:31.000Z",
      "nsfw": false,
      "locked": null,
      "media": null
    }
  ],
  "page": {
    "nextCursor": "AX-v…",
    "hasMore": true
  }
}

Recorded from a live call on . Long text is shortened and the cursor is cut. A live key is charged 2 credits for this call. A test key returns this same sample for 0 credits.

What it won't do

  • It is read-only. It cannot create, edit, vote on or delete posts.
  • Removed posts are not returned.
  • Reddit's content rules apply to what you do with the data.

Questions

How do I get posts from a subreddit with the Reddit API?
Call reddit.subreddit_posts with the subreddit name and a sort such as hot, new or top, then page with the cursor. The free subreddit posts tool shows the same rows in a browser.
How do I get comments from a Reddit post?
Call reddit.thread with the post id or link. It returns the post and its nested replies. See the Reddit comments API.
Can I create a Reddit post with this API?
No. It is read-only. Posting needs your own approved Reddit app.
How do I get one Reddit post by id?
Call the post endpoint with the id, or use the free Reddit scraper in your browser.
Can I list posts from a subreddit?
Yes. See the subreddit posts tool.

More ways to use the API

Build it with one API key

Try it free for 7 days with 1,000 credits.