Open any action to see what it takes and what it gives back.
Check username availability 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.
See details → Create a 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.
See details → Delete a 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.
See details → 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.
See details → Edit 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.
See details → Enable or disable 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.
See details → Expand More Comments Resolve up to 20 child IDs from a `more` placeholder returned by Retrieve Comments for a Post. Pass the placeholder's `children`, the post fullname in `link_id`, and optionally its bare `data.id` as `more_id`. Reddit permits only one concurrent request to this endpoint, so call expansions serially.
See details → Get controversial posts from all subreddits 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.
See details → Get OAuth 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.
See details → Get random Reddit post 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.
See details → Get Reddit listing by sort Tool to retrieve a listing of Reddit posts sorted by the specified criteria (hot, new, top, rising, controversial, best). 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 and controversial sorts. For new controversial-post workflows, prefer GET_CONTROVERSIAL; this action retains controversial support for backward compatibility. Use GET_RANDOM for random posts.
See details → Get Reddit posts by fullname Retrieve Reddit posts directly by their t3 fullnames.
See details → Get Reddit user comments RSS Retrieve a named Reddit user's comments as a raw Atom feed string.
See details → Get subreddit metadata Retrieve one exact subreddit's public profile metadata, including descriptions, subscriber count, settings, and connected-user relationship fields.
See details → 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.
See details → Get subreddit wiki page Retrieve a subreddit wiki page's rendered and Markdown content, optionally at a historical revision or as a comparison between two revisions.
See details → 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.
See details → Get user information 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.
See details → Get user preferences Tool to retrieve preference settings of the logged in user. Use when you need to check user preferences or settings.
See details → List custom Reddit feed List posts from a public custom Reddit feed owned by a named user.
See details → List moderation queue List one moderator review queue for a subreddit. Use `data.after` as `after` on the next call to continue pagination. The connected account must have the `posts` moderator permission for the requested subreddit.
See details → List popular subreddits List communities in Reddit's current activity-based popular ordering.
See details → List subreddit comments List recent comments across all posts in a subreddit. Use `data.after` as `after` on the next call to continue pagination. This is a subreddit-wide feed, not the comment tree for one post.
See details → List subreddit moderators List a subreddit's moderators and each moderator's granted permissions.
See details → 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.
See details → Post a 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.
See details → Prepare Reddit media upload Registers an image or video with Reddit and returns temporary upload instructions. This does not upload the file or publish a post. Pass every returned upload field and its value unchanged to the upload destination before the temporary signature expires.
See details → Retrieve Comments for a Post 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. Optionally control ordering (`sort`), how many comments are returned (`limit`), and how deep the reply tree is expanded (`depth`) before Reddit collapses remaining replies into `more` placeholders. Large, locked, or archived threads may still return truncated trees regardless of `depth`. Filter out comments where `body` is `[deleted]` or `[removed]`; use `parent_id` to reconstruct conversation flow. No date/time-range filter — compare `created_utc` against a UTC cutoff to filter by date.
See details → Retrieve posts from subreddit 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.
See details → Retrieve specific comment or post 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.
See details → Search across subreddits Searches Reddit for posts using a query. Results are nested under `data.children[i].data` (kind `t3` for posts); a `posts` array may also appear, so inspect the actual response path. Optional `time_filter` restricts results to a time period (hour/day/week/month/year/all). Optional `result_type` must include `link`; non-post types in a mixed search do not appear in the streamlined `posts` field. 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.
See details → Search subreddits 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.
See details → Vote on Reddit content Cast or clear one vote only when directly instructed by a human. Never infer how to vote, vote autonomously, amplify a vote, or apply one instruction to multiple items.
See details →