Work in Progress These docs are a work in progress. More content is coming soon.

← Back to Documentation

Reddit (Unofficial)

Search Reddit posts and communities, explore discussions and comments, and inspect public user activity through an unofficial read-only provider.

Tool Reference: 8 tools with full schemas →

Use the Reddit (Unofficial) toolkit to research public Reddit discussions without leaving your conversation. Its eight tools can search posts and communities, browse subreddit listings, fetch individual posts and flattened comment trees, inspect public user profiles and comment history, and check your provider credit balance.

The toolkit is read-only: it cannot post, comment, vote, message users, or change a Reddit account.

Unofficial Reddit access
This toolkit uses RedditAPI, an unofficial third-party proxy that is not affiliated with or endorsed by Reddit. The toolkit is labeled “Reddit (Unofficial)” throughout Toolforest and is read-only by design.

Example prompts

What is r/ClaudeCode discussing this week?
Summarize the top comments on this Reddit thread <link>.
How old is the account u/example and what does it post about?

Setup

Connect the Reddit (Unofficial) toolkit by entering a RedditAPI key in Toolforest. The provider signup happens separately on the RedditAPI website; the setup video and written steps below cover only the Toolforest configuration.

Prefer video? This setup video (0:51) shows how to configure your RedditAPI key in Toolforest:

Prerequisites

Before configuring the toolkit, ensure you have:

  • Configured an MCP server in your toolforest.io dashboard.
  • Created an account at RedditAPI and copied your API key. New accounts include $0.50 in free credit.

Configuration field

FieldRequiredDescription
RedditAPI KeyYesA RedditAPI bearer token from your provider account.

Setup steps

  1. Open Toolforest and go to Toolkits.
  2. Select the Social tab.
  3. Find Reddit (Unofficial) and click Configure.
  4. Paste your RedditAPI Key into the configuration modal.
  5. Click Save and confirm that the toolkit shows Configured.
  6. Ask your assistant to use Toolforest to check your RedditAPI balance. A successful get_account_balance response verifies the connection without using any credit.

Pricing

RedditAPI is a pay-per-call service:

  • New accounts include $0.50 in free credit.
  • Each read costs $0.002.
  • Every page fetched by a paginated tool call counts as one billed read. For example, fetching three pages costs three reads, or $0.006.
  • get_account_balance is free and can be used to check remaining credit at any time.

Pricing is set by the third-party provider and may change. Check redditapis.com for current account and billing details.


Capabilities

ToolCapability
search_postsSearch Reddit posts globally or within a subreddit, with sort and time filters.
search_communitiesFind communities by name or topic and inspect public subreddit details.
get_subreddit_postsBrowse a subreddit's new, hot, top, rising, or other supported listings.
get_postFetch a single post with its full text and public metadata.
get_post_commentsFetch a post and its nested comment tree, flattened with depth and parent information for easier analysis.
get_userInspect a public user profile, including karma, account age, flags, and bio.
get_user_commentsBrowse a public user's recent comment history.
get_account_balanceCheck remaining RedditAPI credit and usage for free.