Social platforms

Reddit API search

from $0.0090 per resultreddit.api

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.

FieldTypeRequiredWhat it does
sortstringoptionalrelevance and comments are search-only. Subreddit feeds use hot, new, top, controversial or rising
timestringoptional
maxItemsintegeroptionalMaximum results per job. A search job always fetches and bills a full page of 25 items, so values below 25 do not cost less
searchesarray of stringoptionalSearch queries. Each query is a separate billed job. Wrap in quotes for an exact phrase
startUrlsarray of objectoptionalReddit subreddit, post or user URLs. Each URL is a separate billed job
includeNSFWbooleanoptional
searchPostsbooleanoptional
searchUsersbooleanoptional
skipCommentsbooleanoptionalFor a direct post URL, return only the post without its comments
skipCommunitybooleanoptional
skipUserPostsbooleanoptional
searchCommentsbooleanoptional
ignorestartUrlsbooleanoptionalForces search-only mode: startUrls are ignored even when present. Note the lowercase s in the middle, which is how the actor spells it.
fetchPostCommentsbooleanoptionalAlso attach top-level comments to each post. One extra request per post and materially more billed items
searchCommunitiesbooleanoptional

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.md

Or 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
  }
}

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