Reddit API search
Reddit posts, comments, communities and users read through Reddit's own API, returning title, body, HTML, upvotes, comment count, author and community for each post.
What a call costs
Billed on actual usage, minimum $0.0020 per call, capped at $5.00 per call.
a price before every call. failed calls are never charged.
When to use it
Use as the fast structured Reddit reader for a search query, a subreddit feed, a single post URL or a user profile. Each query, subreddit or URL is a separate job, and a search job always fetches and bills a full page of 25 items, so asking for fewer does not cost less.
Inputs
Reddit API search takes 15 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 | relevance and comments are search-only. Subreddit feeds use hot, new, top, controversial or rising |
| time | string | optional | |
| maxItems | integer | optional | Maximum results per job. A search job always fetches and bills a full page of 25 items, so values below 25 do not cost less |
| searches | array of string | optional | Search queries. Each query is a separate billed job. Wrap in quotes for an exact phrase |
| startUrls | array of object | optional | Reddit subreddit, post or user URLs. Each URL is a separate billed job |
| includeNSFW | boolean | optional | |
| searchPosts | boolean | optional | |
| searchUsers | boolean | optional | |
| skipComments | boolean | optional | For a direct post URL, return only the post without its comments |
| skipCommunity | boolean | optional | |
| skipUserPosts | boolean | optional | |
| searchComments | boolean | optional | |
| ignorestartUrls | boolean | optional | Forces search-only mode: startUrls are ignored even when present. Note the lowercase s in the middle, which is how the actor spells it. |
| fetchPostComments | boolean | optional | Also attach top-level comments to each post. One extra request per post and materially more billed items |
| searchCommunities | boolean | optional |
How to call it
Connect once and your agent can reach Reddit API search 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.api",
"input": {
"sort": "relevance",
"time": "all",
"maxItems": 25,
"includeNSFW": false,
"searchPosts": true,
"searchUsers": false,
"skipComments": false,
"skipCommunity": true,
"skipUserPosts": false,
"searchComments": false,
"fetchPostComments": false,
"searchCommunities": false
}
}Related tools
More from social platforms, or browse the full tool catalog.
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...
from $0.0114 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 API search from your agent.
One balance for every tool in the catalog. Start with Build, $25 of credit for $19 a month.
Get started