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.

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
Read one post
Call
reddit.scrapewith the post id or link.Search posts
Call
reddit.searchwith a keyword and a time window.List a community
Call
reddit.subreddit_postswith the subreddit name and a sort.
Endpoints that do it
| Endpoint | What it's for | Credits |
|---|---|---|
| Get a postGET /v1/reddit/posts/{id} | One post by id or link. | 2 credits |
| Search postsGET /v1/reddit/search | Posts by keyword. | 2 credits |
| List subreddit postsGET /v1/reddit/subreddits/{name}/posts | A 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"{
"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?
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?
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?
How do I get one Reddit post by id?
Can I list posts from a subreddit?
Guides
More ways to use the API
- Access the Twitter API
- Claude Reddit bot
- Live Twitter monitor
- Reddit API application
- Reddit brand monitoring
- Reddit data export
- Reddit scraper API
- Social listening API
- Post with the Twitter API
- Twitter API statuses
- Twitter exporter
- Twitter scraper API
- Twitter webhook
- Reddit comments API
- Reddit user API
- Subreddit API
- Twitter followers API
- Twitter user API
- Twitter search API
- Social media scraping API
- Reddit listening tool
- Twitter feed API
- Twitter hashtag API
- Social media analytics API
- Twitter image API