Reddit posts
Reddit posts and their comments from a search term, subreddit, user profile or direct post URL, with title, body, community, author, timestamps and optionally upvotes and media links.
What a call costs
Billed on actual usage, minimum $0.0020 per call, capped at $6.00 per call.
a price before every call. failed calls are never charged.
When to use it
Use for broad Reddit research where you want posts together with their comment threads from public pages. This actor charges a fixed $0.04 start fee before the first result, so send one larger request rather than many tiny ones.
Inputs
Reddit posts takes 25 fields, none of them required. Anything you leave out falls back to the tool's own default.
| Field | Type | Required | What it does |
|---|---|---|---|
| sort | string | optional | |
| time | string | optional | |
| maxItems | integer | optional | Maximum items saved across the whole run. Billed per item, on top of the fixed $0.04 start fee |
| searches | array of string | optional | Search terms to run against Reddit. Remove startUrls when you use this |
| startUrls | array of object | optional | Reddit post, subreddit, user or search URLs. Leave empty when you use searches |
| includeNSFW | boolean | optional | |
| maxComments | integer | optional | Maximum comments taken from each post page. Set to 0 to skip comments. Comments count as billed items too |
| searchMedia | boolean | optional | Also search media posts for the search terms. |
| searchPosts | boolean | optional | |
| searchUsers | boolean | optional | |
| maxPostCount | integer | optional | Maximum posts taken from each posts page or community page |
| maxUserCount | integer | optional | Pages of user results to scrape. The actor takes 2 when you leave it out. Each page is more billed items. |
| skipComments | boolean | optional | Do not scrape comments while going through posts |
| postDateLimit | string | optional | Only posts published after this date |
| scrollTimeout | integer | optional | Seconds the scraper keeps scrolling a feed for more items before it stops. The actor uses 40. Raise it when a long feed returns fewer items than maxItems, lower it to cut a run short. |
| skipCommunity | boolean | optional | |
| skipUserPosts | boolean | optional | |
| searchComments | boolean | optional | |
| ignoreStartUrls | boolean | optional | Ignore startUrls even when they are present, making the run search-only. Useful when you keep a stored URL list but want one search-only call. |
| commentDateLimit | string | optional | Only comments published after this date |
| includeMediaLinks | boolean | optional | Include upVotes, upVoteRatio, imageUrls, videoUrls and numberOfComments. Slower extraction |
| navigationTimeout | integer | optional | Seconds to wait for a page to load, 20 to 60. The actor uses 60. |
| searchCommunities | boolean | optional | |
| maxCommunitiesCount | integer | optional | Pages of community results to scrape when a search or startUrl is a communities listing. The actor takes 2 when you leave it out. Each page is more billed items. |
| searchCommunityName | string | optional | Restrict the search to one community, e.g. programming |
How to call it
Connect once and your agent can reach Reddit posts the same way it reaches everything else in the catalog. Add Goro as an MCP connector, or paste the setup line into an agent that reads skills.
MCP
Add this server in Claude, Claude Code, or any MCP client.
https://mcp.usegoro.ai/mcp
Skill
One line in your agent's chat. It sets itself up.
set up https://usegoro.ai/SKILL.mdOr plain HTTP
POST /v1/run
{
"endpoint": "reddit.posts",
"input": {
"sort": "new",
"maxItems": 10,
"includeNSFW": false,
"maxComments": 10,
"searchPosts": true,
"searchUsers": false,
"maxPostCount": 10,
"skipComments": false,
"skipCommunity": false,
"skipUserPosts": false,
"searchComments": false,
"includeMediaLinks": false,
"searchCommunities": false
}
}Related tools
More from social platforms, or browse the full tool catalog.
Reddit API search
Reddit posts, comments, communities and users read through Reddit's own API, returning title, body, HTML, upvotes, comment count, author and...
from $0.0090 per resultFacebook Ads Library
Ads from the public Facebook Ads Library for a page or a keyword search, with creative body, headline, call to action, landing URL, run dates,...
from $0.002250 per resultFacebook events
Structured Facebook event records: name, description, start time and duration, going, interested and responded counts, venue with address,...
from $0.03 per eventFacebook group posts
Posts from public Facebook groups with post text, author, permalink, timestamp, attachments and reaction, comment and share counts.
from $0.0120 per postFurther reading: Social listening with AI agents: track mentions, trends and competitors
Run Reddit posts from your agent.
One balance for every tool in the catalog. Start with Build, $25 of credit for $19 a month.
Get started