> ## Documentation Index
> Fetch the complete documentation index at: https://phidatainc-agui.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Reddit

> RedditTools enables agents to interact with Reddit for browsing posts, comments, and subreddit information.

## Example

The following agent can browse and analyze Reddit content:

```python theme={null}
from agno.agent import Agent
from agno.tools.reddit import RedditTools

agent = Agent(
    instructions=[
        "You are a Reddit content analyst that helps explore and understand Reddit data",
        "Browse subreddits, analyze posts, and provide insights about discussions",
        "Respect Reddit's community guidelines and rate limits",
        "Provide clear summaries of Reddit content and trends",
    ],
    tools=[RedditTools()],
)

agent.print_response("Show me the top posts from r/technology today", stream=True)
```

## Toolkit Params

| Parameter         | Type                    | Default              | Description                                                   |
| ----------------- | ----------------------- | -------------------- | ------------------------------------------------------------- |
| `reddit_instance` | `Optional[praw.Reddit]` | `None`               | Existing Reddit instance to use.                              |
| `client_id`       | `Optional[str]`         | `None`               | Reddit client ID. Uses REDDIT\_CLIENT\_ID if not set.         |
| `client_secret`   | `Optional[str]`         | `None`               | Reddit client secret. Uses REDDIT\_CLIENT\_SECRET if not set. |
| `user_agent`      | `Optional[str]`         | `"RedditTools v1.0"` | User agent string for API requests.                           |
| `username`        | `Optional[str]`         | `None`               | Reddit username for authenticated access.                     |
| `password`        | `Optional[str]`         | `None`               | Reddit password for authenticated access.                     |

## Toolkit Functions

| Function              | Description                                              |
| --------------------- | -------------------------------------------------------- |
| `get_subreddit_info`  | Get information about a specific subreddit.              |
| `get_subreddit_posts` | Get posts from a subreddit with various sorting options. |
| `search_subreddits`   | Search for subreddits by name or topic.                  |
| `get_post_details`    | Get detailed information about a specific post.          |
| `get_post_comments`   | Get comments from a specific post.                       |
| `search_posts`        | Search for posts across Reddit or within subreddits.     |
| `get_user_info`       | Get information about a Reddit user.                     |
| `get_user_posts`      | Get posts submitted by a specific user.                  |
| `get_user_comments`   | Get comments made by a specific user.                    |
| `create_post`         | Create a new post (requires authentication).             |
| `create_comment`      | Create a comment on a post (requires authentication).    |
| `vote_on_post`        | Vote on a post (requires authentication).                |
| `vote_on_comment`     | Vote on a comment (requires authentication).             |

You can use `include_tools` or `exclude_tools` to modify the list of tools the agent has access to. Learn more about [selecting tools](/tools/selecting-tools).

## Developer Resources

* View [Tools Source](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/reddit.py)
* [Reddit API Documentation](https://www.reddit.com/dev/api/)
* [PRAW Documentation](https://praw.readthedocs.io/)