# Reddit

Your Toolhouse AI Worker can connect to Reddit using 23 specialized tools.

## Auth Connection

This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=reddit).

## Tools

<details>

<summary>Reddit Create Reddit Post</summary>

**Integration name:** **REDDIT\_CREATE\_REDDIT\_POST**

Creates a new text or link post on a specified, existing Reddit subreddit, optionally applying a flair. Immediately publishes publicly visible content — confirm subreddit, title, and body with the user before executing. Posts may be silently removed post-submission by automoderator or subreddit rules (errors: SUBMIT\_VALIDATION\_BODY\_BLACKLISTED\_STRING, POST\_GUIDANCE\_VALIDATION\_FAILED); verify visibility via the returned permalink. Rapid consecutive calls trigger RATELIMIT errors with cooldown hints.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example                                                                       | Description                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ----------- | ------ | :------: | ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`       | string |          | `"https://www.example.com/news/article.html"`                                 | The URL for a 'link' post. Required if `kind` is 'link'.                                                                                                                                                                                                                                                                                                                                                                                     |
| `kind`      | string |          | `"self"`                                                                      | The type of the post. Use 'self' for a text-based post (when providing 'text') or 'link' for a post that links to an external URL (when providing 'url'). If omitted, it is automatically inferred: 'self' when 'text' is provided, 'link' when 'url' is provided.                                                                                                                                                                           |
| `text`      | string |          | `"This is the body of my text post. It can include **markdown** formatting."` | The markdown-formatted text content for a 'self' post. Required if `kind` is 'self'. Body must not exceed \~40,000 characters.                                                                                                                                                                                                                                                                                                               |
| `title`     | string |     ✅    | `"My New Project!"`                                                           | The title of the post. Must be 300 characters or less.                                                                                                                                                                                                                                                                                                                                                                                       |
| `flair_id`  | string |          | `"a1b2c3d4-e5f6-7890-1234-567890abcdef"`                                      | ID of the post flair template (UUID format). Must be a valid flair template ID that exists for this specific subreddit. To get valid flair IDs, first use LIST\_SUBREDDIT\_POST\_FLAIRS action for the target subreddit. Do not pass generic strings like 'general' or 'news' - these are not universal flair IDs. Some subreddits enforce mandatory flair; omitting or providing an invalid ID returns SUBMIT\_VALIDATION\_FLAIR\_REQUIRED. |
| `subreddit` | string |     ✅    | `"learnpython"`                                                               | The name of the subreddit (without the 'r/' prefix) where the post will be submitted.                                                                                                                                                                                                                                                                                                                                                        |

</details>

<details>

<summary>Reddit Delete Reddit Comment</summary>

**Integration name:** **REDDIT\_DELETE\_REDDIT\_COMMENT**

Deletes a Reddit comment, identified by its fullname ID, if it was authored by the authenticated user. Deletion is permanent and irreversible.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example        | Description                                                                                                 |
| --------- | ------ | :------: | -------------- | ----------------------------------------------------------------------------------------------------------- |
| `id`      | string |     ✅    | `"t1_c0s4w1c"` | The full 'thing ID' (fullname, e.g., 't1\_c0s4w1c') of the comment to delete; typically starts with 't1\_'. |

</details>

<details>

<summary>Reddit Delete Reddit Post</summary>

**Integration name:** **REDDIT\_DELETE\_REDDIT\_POST**

Permanently and irreversibly deletes a Reddit post by its ID. Confirm with the user before calling. Only works on posts authored by the authenticated account; attempting to delete another user's post will fail.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example        | Description                                                                                                                                |
| --------- | ------ | :------: | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `id`      | string |     ✅    | `"t3_1abcdef"` | The full name (fullname) of the Reddit post to be deleted. This ID must start with 't3\_' followed by the post's unique base36 identifier. |

</details>

<details>

<summary>Reddit Edit Reddit Comment Or Post</summary>

**Integration name:** **REDDIT\_EDIT\_REDDIT\_COMMENT\_OR\_POST**

Edits the body text of the authenticated user's own existing comment or self-post on Reddit; cannot edit link posts or titles.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type   | Required | Example                                                         | Description                                                                                                                                                    |
| ---------- | ------ | :------: | --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `text`     | string |     ✅    | `"This is the *updated* content with **markdown** formatting."` | The new raw markdown text for the body of the comment or self-post.                                                                                            |
| `thing_id` | string |     ✅    | `"t1_c0c0c0c"`                                                  | The full name (fullname) of the comment or self-post to edit. This is a combination of a prefix (e.g., 't1\_' for comment, 't3\_' for post) and the item's ID. |

</details>

<details>

<summary>Reddit Get</summary>

**Integration name:** **REDDIT\_GET**

Tool to retrieve a listing of Reddit posts sorted by the specified criteria (hot, new, top, etc.). Use when you need to get posts from the Reddit front page or all of Reddit with a specific sort order. Supports pagination and time filtering for top/controversial sorts.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example  | Description                                                                                                                                                          |
| ------------- | ------- | :------: | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `show`        | string  |          | —        | The string 'all' to show all posts including filtered ones.                                                                                                          |
| `sort`        | string  |     ✅    | `"hot"`  | The sorting method for results. Valid values: hot, new, top, rising, controversial, best. Note: 'random' is NOT supported here - use the GET\_RANDOM action instead. |
| `after`       | string  |          | —        | Fullname of a thing for pagination (loads posts after this item).                                                                                                    |
| `count`       | integer |          | —        | A positive integer representing the number of items already seen (default: 0).                                                                                       |
| `limit`       | integer |          | `25`     | The maximum number of items desired (default: 25, maximum: 100).                                                                                                     |
| `before`      | string  |          | —        | Fullname of a thing for pagination (loads posts before this item).                                                                                                   |
| `time_filter` | string  |          | `"hour"` | Time filter for 'top' and 'controversial' sorts. Valid values: hour, day, week, month, year, all.                                                                    |

</details>

<details>

<summary>Reddit Get Controversial Posts</summary>

**Integration name:** **REDDIT\_GET\_CONTROVERSIAL\_POSTS**

Tool to retrieve controversial posts from all subreddits with time filters. Use when you need to find the most controversial posts across Reddit from a specific time period (hour, day, week, month, year, or all-time). Returns a paginated listing of posts ranked by controversy within the specified time frame.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example       | Description                                                                                                                         |
| --------- | ------- | :------: | ------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `t`       | string  |          | `"day"`       | Time filter for ranking controversial posts. Specifies the time period: 'hour', 'day', 'week', 'month', 'year', or 'all' (default). |
| `after`   | string  |          | `"t3_abc123"` | Fullname of a thing to use as anchor for pagination. Returns results that occur after this fullname in the listing.                 |
| `limit`   | integer |          | `10`          | Maximum number of controversial posts to return. Default is 25, maximum is 100.                                                     |
| `before`  | string  |          | `"t3_xyz789"` | Fullname of a thing to use as anchor for pagination. Returns results that occur before this fullname in the listing.                |

</details>

<details>

<summary>Reddit Get Me Prefs</summary>

**Integration name:** **REDDIT\_GET\_ME\_PREFS**

Tool to retrieve preference settings of the logged in user. Use when you need to check user preferences or settings.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                           | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| --------- | ------ | :------: | --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `fields`  | string |          | `"lang,theme_selector,nightmode"` | A comma-separated list of preference fields to return. If not specified, all preference fields are returned. Supported fields include: threaded\_messages, hide\_downs, hide\_ups, activity\_relevant\_ads, nightmode, compress, beta, media, media\_preview, label\_nsfw, over\_18, search\_include\_over\_18, hide\_ads, email\_messages, email\_digests, monitor\_mentions, hide\_from\_robots, profile\_opt\_out, public\_votes, lang, theme\_selector, min\_comment\_score, min\_link\_score, accept\_pms, show\_link\_flair, show\_trending, private\_feeds, research, ignore\_suggested\_sort, domain\_details, legacy\_search, live\_orangereds, highlight\_controversial, no\_profanity, email\_unsubscribe\_all, in\_redesign\_beta, allow\_clicktracking, show\_twitter, store\_visits, threaded\_modmail, enable\_default\_themes, geopopular, show\_stylesheets, show\_promote, organic, collapse\_read\_messages, show\_flair, mark\_messages\_read, top\_karma\_subreddits, newwindow, video\_autoplay, credit\_autorenew, clickgadget, use\_global\_defaults, other\_theme, num\_comments, numsites, and g. |

</details>

<details>

<summary>Reddit Get New</summary>

**Integration name:** **REDDIT\_GET\_NEW**

DEPRECATED: Use RetrieveRedditPost instead. Tool to retrieve newest posts from a subreddit sorted by creation time. Use when you need to find the most recently submitted posts to discover fresh content. Returns a paginated listing of posts ranked by newest first.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example       | Description                                                                                                                                           |
| ----------- | ------- | :------: | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `after`     | string  |          | `"t3_abc123"` | Fullname of a thing to use as anchor for pagination. Returns results that occur after this fullname in the listing.                                   |
| `count`     | integer |          | `0`           | Used by Reddit to number listings after the first page for pagination. Represents the number of items already seen.                                   |
| `limit`     | integer |          | `10`          | Maximum number of new posts to return. Default is 25, maximum is 100.                                                                                 |
| `before`    | string  |          | `"t3_xyz789"` | Fullname of a thing to use as anchor for pagination. Returns results that occur before this fullname in the listing.                                  |
| `subreddit` | string  |     ✅    | `"python"`    | Subreddit name (without 'r/' prefix). Must contain only letters, numbers, and underscores. No spaces or special characters allowed. Case-insensitive. |

</details>

<details>

<summary>Reddit Get Random</summary>

**Integration name:** **REDDIT\_GET\_RANDOM**

Tool to retrieve a random public Reddit post from any subreddit. Use when you want to discover serendipitous content or need a random post for testing or entertainment purposes.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example       | Description                                                                                                                              |
| ----------- | ------ | :------: | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `subreddit` | string |          | `"AskReddit"` | Name of the subreddit to get a random post from. If not specified, returns a random post from all of Reddit. Do not include 'r/' prefix. |

</details>

<details>

<summary>Reddit Get Reddit User About</summary>

**Integration name:** **REDDIT\_GET\_REDDIT\_USER\_ABOUT**

Retrieves information about a specified Reddit user account, including karma scores and gold status. Use when you need to get profile information for any public Reddit user.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type   | Required | Example  | Description                                                                                                                                                        |
| ---------- | ------ | :------: | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `username` | string |     ✅    | `"spez"` | The name of an existing Reddit user to retrieve information about. Do not include 'u/' prefix. Use 'me' to get information about the currently authenticated user. |

</details>

<details>

<summary>Reddit Get R Top</summary>

**Integration name:** **REDDIT\_GET\_R\_TOP**

Tool to retrieve top-rated posts from a subreddit with time filters. Use when you need to find the most popular posts from a specific time period (hour, day, week, month, year, or all-time). Returns a paginated listing of posts ranked by score within the specified time frame.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example       | Description                                                                                                                                           |
| ----------- | ------- | :------: | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `t`         | string  |          | `"day"`       | Time filter for ranking top posts. Specifies the time period for top posts: 'hour', 'day', 'week', 'month', 'year', or 'all' (default).               |
| `show`      | string  |          | `"all"`       | Display filtering option. Use 'all' to return items that would normally be omitted (e.g., posts you have hidden).                                     |
| `after`     | string  |          | `"t3_abc123"` | Fullname of a thing to use as anchor for pagination. Returns results that occur after this fullname in the listing.                                   |
| `count`     | integer |          | `0`           | Used by Reddit to number listings after the first page for pagination. Represents the number of items already seen.                                   |
| `limit`     | integer |          | `10`          | Maximum number of top posts to return. Default is 25, maximum is 100.                                                                                 |
| `before`    | string  |          | `"t3_xyz789"` | Fullname of a thing to use as anchor for pagination. Returns results that occur before this fullname in the listing.                                  |
| `sr_detail` | boolean |          | —             | Expand subreddits detail in response. Set to true to get more detailed subreddit information.                                                         |
| `subreddit` | string  |     ✅    | `"python"`    | Subreddit name (without 'r/' prefix). Must contain only letters, numbers, and underscores. No spaces or special characters allowed. Case-insensitive. |

</details>

<details>

<summary>Reddit Get Scopes</summary>

**Integration name:** **REDDIT\_GET\_SCOPES**

Tool to retrieve all available OAuth scopes supported by the Reddit API. Use when you need to understand what permissions are available or check scope definitions.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

*No parameters required.*

</details>

<details>

<summary>Reddit Get Subreddit Rules</summary>

**Integration name:** **REDDIT\_GET\_SUBREDDIT\_RULES**

Fetch the explicit posting rules for a subreddit to ensure compliance before posting or commenting. Use when you need to verify content meets community guidelines or explain subreddit requirements to users.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example    | Description                                                                                                                     |
| ----------- | ------- | :------: | ---------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `raw_json`  | boolean |          | —          | If True, prevents HTML encoding of special characters in rule descriptions. Recommended to set to True for cleaner text output. |
| `subreddit` | string  |     ✅    | `"python"` | Name of the subreddit (without 'r/' prefix) for which to retrieve posting rules.                                                |

</details>

<details>

<summary>Reddit Get Subreddits Search</summary>

**Integration name:** **REDDIT\_GET\_SUBREDDITS\_SEARCH**

Tool to search subreddits by title and description. Use when you need to find subreddits matching a specific topic or keyword. Returns a paginated listing of subreddits with their details including subscribers, descriptions, and other metadata.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example       | Description                                                                                                                                          |
| ------------ | ------- | :------: | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `q`          | string  |     ✅    | `"python"`    | A search query term to search subreddit titles and descriptions. Use specific keywords to find relevant subreddits.                                  |
| `show`       | string  |          | `"all"`       | The string 'all' to show all subreddits including those the user might have filtered.                                                                |
| `sort`       | string  |          | `"relevance"` | Sort order for the search results. 'relevance' sorts by relevance to the query (default). 'activity' sorts by subreddit activity.                    |
| `after`      | string  |          | `"t5_2qh1i"`  | Fullname of a thing - pagination cursor for the next page. Use the 'after' value from the previous response to get the next set of results.          |
| `count`      | integer |          | `0`           | A positive integer (default: 0) representing the number of items already seen in previous pages. Used for pagination tracking.                       |
| `limit`      | integer |          | `10`          | The maximum number of subreddits to return. Default is 25. Maximum allowed value is 100.                                                             |
| `before`     | string  |          | `"t5_2qh1i"`  | Fullname of a thing - pagination cursor for the previous page. Use the 'before' value from the previous response to get the previous set of results. |
| `sr_detail`  | boolean |          | —             | Expand subreddits with additional details. Set to true to get more detailed information about each subreddit.                                        |
| `show_users` | boolean |          | —             | Boolean value to include user results in the search. Set to true to include users matching the search query.                                         |

</details>

<details>

<summary>Reddit Get User Flair</summary>

**Integration name:** **REDDIT\_GET\_USER\_FLAIR**

Fetches the list of user flair assignments for a given subreddit. Returns paginated results with user flair details. Returned flair\_id values are scoped to the specific subreddit and must not be reused across different subreddits.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example         | Description                                                                                                                                            |
| ----------- | ------- | :------: | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `after`     | string  |          | —               | User ID to use as the anchor for fetching the next page of results. Use the 'next' value from a previous response.                                     |
| `limit`     | integer |          | —               | Maximum number of user flair entries to return per page. Reddit default is 25, maximum is 1000.                                                        |
| `before`    | string  |          | —               | User ID to use as the anchor for fetching the previous page of results. Use the 'prev' value from a previous response.                                 |
| `subreddit` | string  |     ✅    | `"learnpython"` | Name of the subreddit (e.g., 'pics', 'gaming') for which to retrieve user flair assignments. Do not include 'r/' prefix or URL paths — bare name only. |

</details>

<details>

<summary>Reddit Get Username Available</summary>

**Integration name:** **REDDIT\_GET\_USERNAME\_AVAILABLE**

Tool to check whether a username is available for registration on Reddit. Use when you need to verify if a username can be used to create a new account.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example         | Description                                                                                                                                          |
| --------- | ------ | :------: | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user`    | string |     ✅    | `"testuser123"` | The username to check for availability. Must be a valid, unused username string. Usernames are case-insensitive and must be between 3-20 characters. |

</details>

<details>

<summary>Reddit List Subreddit Post Flairs</summary>

**Integration name:** **REDDIT\_LIST\_SUBREDDIT\_POST\_FLAIRS**

List available link/post flairs for a subreddit (including flair\_template\_id) so posts can satisfy flair-required validation. Use when you need to discover valid flair IDs before creating a post in a subreddit that requires flair. Note: Reddit may return empty or deny access if the authenticated user cannot set link flair and is not a moderator.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example         | Description                                                                                       |
| ----------- | ------ | :------: | --------------- | ------------------------------------------------------------------------------------------------- |
| `subreddit` | string |     ✅    | `"learnpython"` | The name of the subreddit (without 'r/' prefix) for which to retrieve available post/link flairs. |

</details>

<details>

<summary>Reddit Post Reddit Comment</summary>

**Integration name:** **REDDIT\_POST\_REDDIT\_COMMENT**

Posts a comment on Reddit, replying to an existing submission (post) or another comment. Fails if the target thread is locked, archived, or restricted — verify thread state beforehand. Rapid successive calls trigger Reddit RATELIMIT errors with explicit cooldown hints (e.g., 'take a break for 9 minutes'); honor the specified wait before retrying. A successful API response does not guarantee public visibility — automod or spam filters may silently remove the comment. Publishes immediately and publicly; confirm target and text before executing.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type   | Required | Example                            | Description                                                                                                                                                                              |
| ---------- | ------ | :------: | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `text`     | string |     ✅    | `"This is an insightful comment!"` | REQUIRED. The raw Markdown text of the comment to be submitted. This field must be provided and cannot be empty.                                                                         |
| `thing_id` | string |     ✅    | `"t3_10omtdx"`                     | REQUIRED. The ID of the parent post (link) or comment, prefixed with 't3\_' for a post (e.g., 't3\_10omtdx') or 't1\_' for a comment (e.g., 't1\_h2g9w8l'). This field must be provided. |

</details>

<details>

<summary>Reddit Retrieve Post Comments</summary>

**Integration name:** **REDDIT\_RETRIEVE\_POST\_COMMENTS**

Retrieves all comments for a Reddit post given its base-36 article ID. Response is a two-element listings array: post metadata in `listings[0]`; comments in `listings[1].data.children` with text at each `[].data.body` and nested replies under each comment's `replies` field. Replies require recursive traversal to capture full discussion. Large, locked, or archived threads may return truncated trees or `more` placeholders rather than full results. Filter out comments where `body` is `[deleted]` or `[removed]`; use `parent_id` to reconstruct conversation flow. No time-filter parameter — compare `created_utc` against a UTC cutoff to filter by date.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example    | Description                                                                                                            |
| --------- | ------ | :------: | ---------- | ---------------------------------------------------------------------------------------------------------------------- |
| `article` | string |     ✅    | `"q5u7q5"` | Base-36 ID of the Reddit post (e.g., 'q5u7q5'), typically found in the post's URL and not including the 't3\_' prefix. |

</details>

<details>

<summary>Reddit Retrieve Reddit Post</summary>

**Integration name:** **REDDIT\_RETRIEVE\_REDDIT\_POST**

Retrieves posts from a specified, publicly accessible subreddit. Responses nest post data under `data.children[].data`; inspect the structure before parsing. Pagination uses a `data.after` cursor; deduplicate across pages by post `id`. No built-in date filtering; compare `created_utc` (Unix seconds, UTC) client-side. Rate limit: \~1–2 requests/second; back off on HTTP 429.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example        | Description                                                                                                                                                                                            |
| ------------- | ------- | :------: | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `sort`        | string  |          | `"hot"`        | Sort order for posts. Options: 'hot' (default, most active posts), 'new' (newest first), 'top' (highest scoring), 'rising' (trending posts), 'controversial' (most controversial).                     |
| `subreddit`   | string  |     ✅    | `"technology"` | The name of the subreddit from which to retrieve posts (e.g., 'popular', 'pics'). Do not include 'r/'. Subreddit names must be 3-21 characters and can only contain letters, numbers, and underscores. |
| `max_results` | integer |          | `5`            | The maximum number of posts to return. Default is 5. Set to 0 to retrieve the maximum allowed by the Reddit API (100 posts). Valid range: 0-100.                                                       |

</details>

<details>

<summary>Reddit Retrieve Specific Comment</summary>

**Integration name:** **REDDIT\_RETRIEVE\_SPECIFIC\_COMMENT**

Retrieves detailed information for a single Reddit comment or post using its fullname. Returns only the specified item, not surrounding thread context; use REDDIT\_RETRIEVE\_POST\_COMMENTS for full discussion retrieval. Deleted, removed, or quarantined items may return empty or partial payloads.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example       | Description                                                                                                                                                                                                                                                                                                                                                                     |
| --------- | ------ | :------: | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`      | string |     ✅    | `"t1_abc123"` | Reddit fullname identifier. Format: type prefix (t1\_ for comments, t3\_ for posts) followed by a base36 ID. Examples: 't1\_abc123', 't3\_1abc2de'. Note: Share URL tokens from reddit.com/r/.../s/... links are NOT valid fullnames and cannot be used directly. Note: REDDIT\_RETRIEVE\_POST\_COMMENTS expects the bare base-36 ID without the t3\_ prefix, unlike this tool. |

</details>

<details>

<summary>Reddit Search Across Subreddits</summary>

**Integration name:** **REDDIT\_SEARCH\_ACROSS\_SUBREDDITS**

Searches Reddit for posts/comments using a query. Results nested under `data.children[i].data` (kind `t3` for posts); a `posts` array may also appear — inspect actual response path. No native time-range filter; compare `created_utc` (Unix epoch, UTC) client-side for recency filtering. Empty `children` is a valid no-results outcome. Key post fields: `score`, `num_comments`, `created_utc`, `permalink`. Rate limit: \~1–2 requests/sec; HTTP 429 indicates throttling.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type    | Required | Example                | Description                                                                                                                                                                                                                                                                                                                                                               |
| -------------- | ------- | :------: | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sort`         | string  |          | `"relevance"`          | The criterion for sorting search results. 'relevance' (default) sorts by relevance to the query. 'hot' sorts by trending posts with recent upvotes and activity. 'new' sorts by newest first. 'top' sorts by highest score (typically all-time). 'comments' sorts by the number of comments.                                                                              |
| `after`        | string  |          | `"t3_1abc2de"`         | Pagination cursor to fetch the next page of results. Use the `after` value from the previous response to get subsequent results.                                                                                                                                                                                                                                          |
| `limit`        | integer |          | `"5"`                  | The maximum number of search results to return. Default is 5. Maximum allowed value is 100. Paginate beyond the first page using the `after` cursor from `data.after` in the response; deduplicate results across pages by post `id`.                                                                                                                                     |
| `before`       | string  |          | `"t3_1abc2de"`         | Pagination cursor to fetch the previous page of results. Use the `before` value from the previous response to get preceding results.                                                                                                                                                                                                                                      |
| `restrict_sr`  | boolean |          | `true`                 | If True (default), confines the search to posts and comments within subreddits. If False, the search scope is broader and may include matching subreddit names or other Reddit entities.                                                                                                                                                                                  |
| `search_query` | string  |     ✅    | `"latest AI research"` | The search query string. Supports Reddit search operators: 'title:', 'author:', 'subreddit:', 'url:', 'site:', 'flair:', 'self:yes/no', 'nsfw:yes/no', and boolean operators (AND, OR, NOT). Raw URLs (starting with http\:// or https\://) are not allowed - use the 'url:' or 'site:' operators instead (e.g., 'url:example.com' to find posts linking to that domain). |

</details>

<details>

<summary>Reddit Toggle Inbox Replies</summary>

**Integration name:** **REDDIT\_TOGGLE\_INBOX\_REPLIES**

Enable or disable inbox replies for a submission or comment. Use when you want to control whether you receive inbox notifications for replies to your own posts or comments.

**Parameters**

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example       | Description                                                                                                                                                                     |
| --------- | ------- | :------: | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`      | string  |     ✅    | `"t3_abc123"` | The fullname of a thing created by the user. Must be prefixed with the thing type (e.g., 't3\_' for a submission/post, 't1\_' for a comment). Example: 't3\_abc123' for a post. |
| `state`   | boolean |     ✅    | `true`        | Boolean value to enable or disable inbox replies. Set to true to enable receiving inbox notifications when users reply to this thing, or false to disable inbox notifications.  |

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.toolhouse.ai/toolhouse/integrations/reddit.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.