Reddit

Learn how to use Reddit with Composio

Overview

Enum

REDDIT

Description

Connect to Reddit to post and comment.

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
stringDefaults to identity read vote submit flair edit
base_url
stringDefaults to https://oauth.reddit.com

Actions

Creates a new text or link post on a specified, existing reddit subreddit, optionally applying a flair.

Action Parameters

flair_id
stringRequired
kind
stringRequired
subreddit
stringRequired
text
string
title
stringRequired
url
string

Action Response

data
object
error
successful
boolean
Deletes a reddit comment, identified by its fullname id, if it was authored by the authenticated user.

Action Parameters

id
stringRequired

Action Response

data
object
error
successful
boolean
Permanently deletes a reddit post by its id, provided the authenticated user has deletion permissions for that post.

Action Parameters

id
stringRequired

Action Response

data
object
error
successful
boolean
Edits the body text of the authenticated user's own existing comment or self-post on reddit; cannot edit link posts or titles.

Action Parameters

text
stringRequired
thing_id
stringRequired

Action Response

data
object
error
successful
boolean
Fetches the list of available link flairs (i.e., post flairs, not user flairs) for a given subreddit.

Action Parameters

subreddit
stringRequired

Action Response

data
object
error
successful
boolean
Posts a comment on reddit, replying to an existing and accessible submission (post) or another comment.

Action Parameters

text
stringRequired
thing_id
stringRequired

Action Response

data
object
error
successful
boolean
Retrieves all comments for a reddit post given its article id (which must be for an existing, public post); nested replies within comments are returned as raw dictionaries requiring parsing.

Action Parameters

article
stringRequired

Action Response

data
object
error
successful
boolean
Retrieves the current hot posts from a specified, publicly accessible subreddit.

Action Parameters

size
integerDefaults to 5
subreddit
stringRequired

Action Response

data
object
error
successful
boolean
Retrieves detailed information for a specific reddit comment or post using its fullname.

Action Parameters

id
stringRequired

Action Response

data
object
error
successful
boolean
Searches reddit for content (e.g., posts, comments) using a query, with results typically confined to subreddits unless `restrict sr` is set to false.

Action Parameters

limit
integerDefaults to 5
restrict_sr
booleanDefaults to True
search_query
stringRequired
sort
stringDefaults to relevance

Action Response

data
object
error
successful
boolean