Reddit Post Search
GET
/v1/reddit/searchMCP
reddit_search1 creditLiveUpdated
Description
Search Reddit posts by keyword across all of Reddit or inside one subreddit. Returns posts with title, body, author, subreddit, score, comment count and URL, newest data within minutes. Costs 1 credit per page of up to 25 posts. Tip: Reddit operators work inside q, e.g. "exact phrase", OR, NOT, author:name.
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
q | query | string | yes | Search text. Reddit operators allowed. | |
subreddit | query | string | no | Limit to one subreddit, e.g. SaaS. | |
sort | query | enum | no | relevance | Result order. One of: relevance, new, hot, top, comments. |
time | query | enum | no | all | Time window. One of: hour, day, week, month, year, all. |
nsfw | query | boolean,string | no | Include adult posts. true needs the 18+ setting and is billed as reddit.nsfw_search. | |
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. |
- q query, string, required
- Search text. Reddit operators allowed.
- subreddit query, string
- Limit to one subreddit, e.g. SaaS.
- sort query, enum
- Result order. One of:
relevance,new,hot,top,comments. Defaultrelevance. - time query, enum
- Time window. One of:
hour,day,week,month,year,all. Defaultall. - nsfw query, boolean,string
- Include adult posts. true needs the 18+ setting and is billed as reddit.nsfw_search.
- 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/search?q=best+crm+for+small+business&time=year" \
-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": "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 fall apart. I’m trying to figure out what the best CRM for a small business looks like when you need something the whole team can use without spending weeks setting it up. \n \nI keep finding everything from really basic small business CRM tools to newer AI native CRM platforms, and I’m more interested in something that can take some of the sales work off the team rather than just becoming another database we have to maintain. Main thing is finding a CRM we can grow into without needing a dedicated ops person just to keep it running.",
"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 been using it for six months.\n\nI'm more interested in hearing from people who rely on one every day. Which CRM are you using, and what keeps you from switching? Is there anything about it that drives you crazy, or do you feel like it's been worth every dollar?\n\nMy main goal is to stay on top of leads, keep follow-ups organized, and automate the routine work without ending up with a system that's harder to manage than the business itself.\n\nI'd appreciate hearing some live experiences. If you've found a CRM you'd choose again, I'd love to know which one and why.",
"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
},
{
"id": "1vjeath",
"fullname": "t3_1vjeath",
"title": "Simple CRM recommendations.",
"body": "I have searched the sub for what I’m looking for but can’t find it exactly. \n\nI have a freight brokerage and use a TMS for all the actual operations but don’t have integrated CRM that does what I need. Here’s what I need:\n\n\\-Simple, no bloat. I don’t need analytics, email/phone integration, etc. \n\\-I want users to create leads/prospects with simple info, able to leave notes, contact info and things like that. \n\\-Ideally I want to have “open prospects” and “claimed prospects”. Claimed would revert to open after a set amount of time. (“Customers” would remain locked until admin changes it) Again, wishlist but not mandatory. \n\\-Be able to export a prospect so I can import into the TMS once they become a customer. Not required but would make life so much easier. \n\\-Admin ability to adjust status and lock out certain users from making changes. \n\nThe main thing is I don’t want a bunch of bells and whistles that clog up the user experience. I can live with some bloat as long as it’s not in the way. \n\nAnyway, any recommendations would be fantastic. Thanks! ",
"author": "diminaband",
"subreddit": "smallbusiness",
"permalink": "/r/smallbusiness/comments/1vjeath/simple_crm_recommendations/",
"url": "https://www.reddit.com/r/smallbusiness/comments/1vjeath/simple_crm_recommendations/",
"externalUrl": null,
"score": 4,
"numComments": 39,
"upvoteRatio": null,
"createdAt": "2026-08-09T02:47:20.000Z",
"nsfw": false,
"locked": null,
"media": null
}
],
"page": {
"nextCursor": "eyJ2IjoxLCJwIjoiYW55YXBpIiwiYyI6ImN1cl9qWGJYVzlhZ3E1NXBDdHI4d3VCeG9nIiwibyI6MCwiaCI6ImQ4ZmU3ZjZiNjM0OSJ9",
"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 10 minutes are served from cache.