Reddit is a social platform where users share and discuss content in topic-based communities called subreddits.
In Cadense, you can use the Reddit integration to:
- Get Posts: Retrieve posts from any subreddit, with options to sort (Hot, New, Top, Rising) and filter Top posts by time (Day, Week, Month, Year, All Time).
- Get Comments: Fetch comments from a specific post, with options to sort and set the number of comments.
These operations let your agents access and analyze Reddit content as part of your automated workflows.
Usage Instructions
Integrate Reddit into workflows. Read posts, comments, and search content. Submit posts, vote, reply, edit, manage messages, and access user and subreddit info.
Tools
reddit_get_posts
Fetch posts from a subreddit with different sorting options
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
subreddit | string | Yes | The subreddit to fetch posts from (e.g., "technology", "news") |
sort | string | No | Sort method for posts (e.g., "hot", "new", "top", "rising", "controversial"). Default: "hot" |
limit | number | No | Maximum number of posts to return (e.g., 25). Default: 10, max: 100 |
time | string | No | Time filter for "top" sorted posts: "day", "week", "month", "year", or "all" (default: "all") |
after | string | No | Fullname of a thing to fetch items after (for pagination) |
before | string | No | Fullname of a thing to fetch items before (for pagination) |
count | number | No | A count of items already seen in the listing (used for numbering) |
show | string | No | Show items that would normally be filtered (e.g., "all") |
sr_detail | boolean | No | Expand subreddit details in the response |
g | string | No | Geo filter for posts (e.g., "GLOBAL", "US", "AR", etc.) |
Output
| Parameter | Type | Description |
|---|---|---|
subreddit | string | Name of the subreddit where posts were fetched from |
posts | array | Array of posts with title, author, URL, score, comments count, and metadata |
↳ id | string | Post ID |
↳ name | string | Thing fullname (t3_xxxxx) |
↳ title | string | Post title |
↳ author | string | Author username |
↳ url | string | Post URL |
↳ permalink | string | Reddit permalink |
↳ score | number | Post score (upvotes - downvotes) |
↳ num_comments | number | Number of comments |
↳ created_utc | number | Creation timestamp (UTC) |
↳ is_self | boolean | Whether this is a text post |
↳ selftext | string | Text content for self posts |
↳ thumbnail | string | Thumbnail URL |
↳ subreddit | string | Subreddit name |
after | string | Fullname of the last item for forward pagination |
before | string | Fullname of the first item for backward pagination |
reddit_get_comments
Fetch comments from a specific Reddit post
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
postId | string | Yes | The ID of the Reddit post to fetch comments from (e.g., "abc123") |
subreddit | string | Yes | The subreddit where the post is located (e.g., "technology", "programming") |
sort | string | No | Sort method for comments: "confidence", "top", "new", "controversial", "old", "random", "qa" (default: "confidence") |
limit | number | No | Maximum number of comments to return (e.g., 25). Default: 50, max: 100 |
depth | number | No | Maximum depth of subtrees in the thread (controls nested comment levels) |
context | number | No | Number of parent comments to include |
showedits | boolean | No | Show edit information for comments |
showmore | boolean | No | Include "load more comments" elements in the response |
threaded | boolean | No | Return comments in threaded/nested format |
truncate | number | No | Integer to truncate comment depth |
comment | string | No | ID36 of a comment to focus on (returns that comment thread) |
Output
| Parameter | Type | Description |
|---|---|---|
post | object | Post information including ID, title, author, content, and metadata |
↳ id | string | Post ID |
↳ name | string | Thing fullname (t3_xxxxx) |
↳ title | string | Post title |
↳ author | string | Post author |
↳ selftext | string | Post text content |
↳ score | number | Post score |
↳ created_utc | number | Creation timestamp |
↳ permalink | string | Reddit permalink |
comments | array | Nested comments with author, body, score, timestamps, and replies |
↳ id | string | Comment ID |
↳ name | string | Thing fullname (t1_xxxxx) |
↳ author | string | Comment author |
↳ body | string | Comment text |
↳ score | number | Comment score |
↳ created_utc | number | Creation timestamp |
↳ permalink | string | Comment permalink |
↳ replies | array | Nested reply comments |
reddit_get_controversial
Fetch controversial posts from a subreddit
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
subreddit | string | Yes | The subreddit to fetch posts from (e.g., "technology", "news") |
time | string | No | Time filter for controversial posts: "hour", "day", "week", "month", "year", or "all" (default: "all") |
limit | number | No | Maximum number of posts to return (e.g., 25). Default: 10, max: 100 |
after | string | No | Fullname of a thing to fetch items after (for pagination) |
before | string | No | Fullname of a thing to fetch items before (for pagination) |
count | number | No | A count of items already seen in the listing (used for numbering) |
show | string | No | Show items that would normally be filtered (e.g., "all") |
sr_detail | boolean | No | Expand subreddit details in the response |
Output
| Parameter | Type | Description |
|---|---|---|
subreddit | string | Name of the subreddit where posts were fetched from |
posts | array | Array of controversial posts with title, author, URL, score, comments count, and metadata |
↳ id | string | Post ID |
↳ name | string | Thing fullname (t3_xxxxx) |
↳ title | string | Post title |
↳ author | string | Author username |
↳ url | string | Post URL |
↳ permalink | string | Reddit permalink |
↳ score | number | Post score (upvotes - downvotes) |
↳ num_comments | number | Number of comments |
↳ created_utc | number | Creation timestamp (UTC) |
↳ is_self | boolean | Whether this is a text post |
↳ selftext | string | Text content for self posts |
↳ thumbnail | string | Thumbnail URL |
↳ subreddit | string | Subreddit name |
after | string | Fullname of the last item for forward pagination |
before | string | Fullname of the first item for backward pagination |
reddit_search
Search for posts within a subreddit
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
subreddit | string | Yes | The subreddit to search in (e.g., "technology", "programming") |
query | string | Yes | Search query text (e.g., "artificial intelligence", "machine learning tutorial") |
sort | string | No | Sort method for search results (e.g., "relevance", "hot", "top", "new", "comments"). Default: "relevance" |
time | string | No | Time filter for search results: "hour", "day", "week", "month", "year", or "all" (default: "all") |
limit | number | No | Maximum number of posts to return (e.g., 25). Default: 10, max: 100 |
restrict_sr | boolean | No | Restrict search to the specified subreddit only (default: true) |
after | string | No | Fullname of a thing to fetch items after (for pagination) |
before | string | No | Fullname of a thing to fetch items before (for pagination) |
count | number | No | A count of items already seen in the listing (used for numbering) |
show | string | No | Show items that would normally be filtered (e.g., "all") |
type | string | No | Type of search results: "link" (posts), "sr" (subreddits), or "user" (users). Default: "link" |
sr_detail | boolean | No | Expand subreddit details in the response |
Output
| Parameter | Type | Description |
|---|---|---|
subreddit | string | Name of the subreddit where search was performed |
posts | array | Array of search result posts with title, author, URL, score, comments count, and metadata |
↳ id | string | Post ID |
↳ name | string | Thing fullname (t3_xxxxx) |
↳ title | string | Post title |
↳ author | string | Author username |
↳ url | string | Post URL |
↳ permalink | string | Reddit permalink |
↳ score | number | Post score (upvotes - downvotes) |
↳ num_comments | number | Number of comments |
↳ created_utc | number | Creation timestamp (UTC) |
↳ is_self | boolean | Whether this is a text post |
↳ selftext | string | Text content for self posts |
↳ thumbnail | string | Thumbnail URL |
↳ subreddit | string | Subreddit name |
after | string | Fullname of the last item for forward pagination |
before | string | Fullname of the first item for backward pagination |
reddit_submit_post
Submit a new post to a subreddit (text or link)
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
subreddit | string | Yes | The subreddit to post to (e.g., "technology", "programming") |
title | string | Yes | Title of the submission (e.g., "Check out this new AI tool"). Max 300 characters |
text | string | No | Text content for a self post in markdown format (e.g., "This is the body of my post") |
url | string | No | URL for a link post (cannot be used with text) |
nsfw | boolean | No | Mark post as NSFW |
spoiler | boolean | No | Mark post as spoiler |
send_replies | boolean | No | Send reply notifications to inbox (default: true) |
flair_id | string | No | Flair template UUID for the post (max 36 characters) |
flair_text | string | No | Flair text to display on the post (max 64 characters) |
collection_id | string | No | Collection UUID to add the post to |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether the post was submitted successfully |
message | string | Success or error message |
data | object | Post data including ID, name, URL, and permalink |
↳ id | string | New post ID |
↳ name | string | Thing fullname (t3_xxxxx) |
↳ url | string | Post URL from API response |
↳ permalink | string | Full Reddit permalink |
reddit_vote
Upvote, downvote, or unvote a Reddit post or comment
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Thing fullname to vote on (e.g., "t3_abc123" for post, "t1_def456" for comment) |
dir | number | Yes | Vote direction: 1 (upvote), 0 (unvote), or -1 (downvote) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether the vote was successful |
message | string | Success or error message |
reddit_save
Save a Reddit post or comment to your saved items
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Thing fullname to save (e.g., "t3_abc123" for post, "t1_def456" for comment) |
category | string | No | Category to save under (Reddit Gold feature) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether the save was successful |
message | string | Success or error message |
reddit_unsave
Input
| Parameter | Type | Required | Description |
|---|
Output
| Parameter | Type | Description |
|---|---|---|
subreddit | string | Subreddit name |
posts | json | Posts data |
post | json | Single post data |
comments | json | Comments data |
success | boolean | Operation success status |
message | string | Result message |
data | json | Response data |
after | string | Pagination cursor (next page) |
before | string | Pagination cursor (previous page) |
id | string | Entity ID |
name | string | Entity fullname |
messages | json | Messages data |
display_name | string | Subreddit display name |
subscribers | number | Subscriber count |
description | string | Description text |
link_karma | number | Link karma |
comment_karma | number | Comment karma |
total_karma | number | Total karma |
icon_img | string | Icon image URL |
reddit_reply
Add a comment reply to a Reddit post or comment
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
parent_id | string | Yes | Thing fullname to reply to (e.g., "t3_abc123" for post, "t1_def456" for comment) |
text | string | Yes | Comment text in markdown format (e.g., "Great post! Here is my reply") |
return_rtjson | boolean | No | Return response in Rich Text JSON format |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether the reply was posted successfully |
message | string | Success or error message |
data | object | Comment data including ID, name, permalink, and body |
↳ id | string | New comment ID |
↳ name | string | Thing fullname (t1_xxxxx) |
↳ permalink | string | Comment permalink |
↳ body | string | Comment body text |
reddit_edit
Edit the text of your own Reddit post or comment
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
thing_id | string | Yes | Thing fullname to edit (e.g., "t3_abc123" for post, "t1_def456" for comment) |
text | string | Yes | New text content in markdown format (e.g., "Updated content here") |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether the edit was successful |
message | string | Success or error message |
data | object | Updated content data |
↳ id | string | Edited thing ID |
↳ body | string | Updated comment body (for comments) |
↳ selftext | string | Updated post text (for self posts) |
reddit_delete
Delete your own Reddit post or comment
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Thing fullname to delete (e.g., "t3_abc123" for post, "t1_def456" for comment) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether the deletion was successful |
message | string | Success or error message |
reddit_subscribe
Subscribe or unsubscribe from a subreddit
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
subreddit | string | Yes | The subreddit to subscribe to or unsubscribe from (e.g., "technology", "programming") |
action | string | Yes | Action to perform: "sub" to subscribe or "unsub" to unsubscribe |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether the subscription action was successful |
message | string | Success or error message |
reddit_get_me
Get information about the authenticated Reddit user
Input
| Parameter | Type | Required | Description |
|---|
Output
| Parameter | Type | Description |
|---|---|---|
id | string | User ID |
name | string | Username |
created_utc | number | Account creation time in UTC epoch seconds |
link_karma | number | Total link karma |
comment_karma | number | Total comment karma |
total_karma | number | Combined total karma |
is_gold | boolean | Whether user has Reddit Premium |
is_mod | boolean | Whether user is a moderator |
has_verified_email | boolean | Whether email is verified |
icon_img | string | User avatar/icon URL |
reddit_get_user
Get public profile information about any Reddit user by username
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
username | string | Yes | Reddit username to look up (e.g., "spez", "example_user") |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | User ID |
name | string | Username |
created_utc | number | Account creation time in UTC epoch seconds |
link_karma | number | Total link karma |
comment_karma | number | Total comment karma |
total_karma | number | Combined total karma |
is_gold | boolean | Whether user has Reddit Premium |
is_mod | boolean | Whether user is a moderator |
has_verified_email | boolean | Whether email is verified |
icon_img | string | User avatar/icon URL |
reddit_send_message
Send a private message to a Reddit user
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
to | string | Yes | Recipient username (e.g., "example_user") or subreddit (e.g., "/r/subreddit") |
subject | string | Yes | Message subject (max 100 characters) |
text | string | Yes | Message body in markdown format |
from_sr | string | No | Subreddit name to send the message from (requires moderator mail permission) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether the message was sent successfully |
message | string | Success or error message |
reddit_get_messages
Retrieve private messages from your Reddit inbox
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
where | string | No | Message folder to retrieve: "inbox" (all), "unread", "sent", "messages" (direct messages only), "comments" (comment replies), "selfreply" (self-post replies), or "mentions" (username mentions). Default: "inbox" |
limit | number | No | Maximum number of messages to return (e.g., 25). Default: 25, max: 100 |
after | string | No | Fullname of a thing to fetch items after (for pagination) |
before | string | No | Fullname of a thing to fetch items before (for pagination) |
mark | boolean | No | Whether to mark fetched messages as read |
count | number | No | A count of items already seen in the listing (used for numbering) |
show | string | No | Show items that would normally be filtered (e.g., "all") |
Output
| Parameter | Type | Description |
|---|---|---|
messages | array | Array of messages with sender, recipient, subject, body, and metadata |
↳ id | string | Message ID |
↳ name | string | Thing fullname (t4_xxxxx) |
↳ author | string | Sender username |
↳ dest | string | Recipient username |
↳ subject | string | Message subject |
↳ body | string | Message body text |
↳ created_utc | number | Creation time in UTC epoch seconds |
↳ new | boolean | Whether the message is unread |
↳ was_comment | boolean | Whether the message is a comment reply |
↳ context | string | Context URL for comment replies |
↳ distinguished | string | Distinction: null/"moderator"/"admin" |
after | string | Fullname of the last item for forward pagination |
before | string | Fullname of the first item for backward pagination |
reddit_get_subreddit_info
Get metadata and information about a subreddit
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
subreddit | string | Yes | The subreddit to get info about (e.g., "technology", "programming", "news") |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Subreddit ID |
name | string | Subreddit fullname (t5_xxxxx) |
display_name | string | Subreddit name without prefix |
title | string | Subreddit title |
description | string | Full subreddit description (markdown) |
public_description | string | Short public description |
subscribers | number | Number of subscribers |
accounts_active | number | Number of currently active users |
created_utc | number | Creation time in UTC epoch seconds |
over18 | boolean | Whether the subreddit is NSFW |
lang | string | Primary language of the subreddit |
subreddit_type | string | Subreddit type: public, private, restricted, etc. |
url | string | Subreddit URL path (e.g., /r/technology/) |
icon_img | string | Subreddit icon URL |
banner_img | string | Subreddit banner URL |