find_tools, describe_tool, execute_tool — with more
than one provider behind the scenes, so one route failing does not stop the
task.
What you can ask
- “What is r/LocalLLaMA saying about the new Llama release this week?”
- “Pull the full comment tree of this thread and summarize the strongest arguments on each side.”
- “Find the most upvoted posts mentioning our product across Reddit.”
- “What are the rules and posting guidelines of r/startups?”
- “Show me what u/spez has posted and commented on recently.”
- “What are people searching for on Reddit right now?”
- “Which subreddits is this user most active in?”
- “Give me today’s popular feed and the pinned highlights of r/MachineLearning.”
What’s covered
Posts- Keyword search for posts, with a continuation token to page through results
- Post detail by ID, single or in batches
- Comment trees with pagination, and the replies hidden under a collapsed comment
- Community highlights — featured posts and announcements for a subreddit
- Subreddit info, rules and style, settings and post channels
- The subreddit feed, and topic feeds that group several communities
- Home, popular, explore, news and games feeds as the app shows them
- Muted-status check for a subreddit
- Profile, submitted posts and comment history
- The subreddits a user is active in, and their public trophies
- Dynamic search across posts, communities, comments, media and users
- Typeahead suggestions and today’s trending searches
- Reddit Answers — the AI-generated posts and comments Reddit builds for a question
How to use it
Pass the request in plain language and let the router pick the tool:describe_tool before executing —
parameters and per-call costs differ between providers.
Building with code? The same capability is available as fixed-contract
Scenario Methods with automatic provider
failover:
social.reddit.post.search,
social.reddit.post.get,
social.reddit.post.comments,
social.reddit.topic.search,
social.reddit.topic.posts,
social.reddit.user.get,
social.reddit.user.posts,
social.reddit.user.search,
social.reddit.trending.FAQ
Do I need a Reddit account or API key?
Do I need a Reddit account or API key?
No. AgentKey holds the upstream access; your agent only needs your AgentKey
subscription.
Can it read private or quarantined subreddits?
Can it read private or quarantined subreddits?
No. Only publicly visible posts, comments, subreddits and profiles are
available.
How do very long comment threads work?
How do very long comment threads work?
Comments are paginated, and replies that Reddit collapses behind a “more”
cursor come from a separate call for that comment. Plan on several calls
for a thread with thousands of comments, and check the per-call cost with
describe_tool first.