Skip to content

superagnt/leverage / skills/core/reddit-data

reddit-data

Verified

Reddit posts, comments, users, and subreddits for agents — no Reddit app or API approval needed.

Reddit Data

The superagnt Reddit API wraps Reddit surface areas into a single integration. Instead of managing multiple keys, proxies, and rate limits yourself, you call superagnt with one credential and consume structured JSON optimized for downstream AI and analytics. Whether you are building a social listening agent, a content research pipeline, or a creator-intelligence product, this API gives you consistent access to subreddit metadata, post threads, user activity, and search with predictable billing and operational simplicity.

Alternative install: the scoped MCP server

If this client speaks MCP, you can connect the Reddit Data facet server instead of using this skill's curl calls — the same endpoints below as native MCP tools with structured parameters and OAuth sign-in, scoped to this capability:

https://mcp.superagnt.com/mcp/reddit

That URL publishes full OAuth discovery: an MCP-capable client needs the URL and nothing else (approve once in the browser). On clients that hold a bearer instead, add it as an Authorization: Bearer header. Per-client setup lines: https://www.superagnt.com/install?facet=reddit

This skill document stays fully usable on curl-only environments — everything below works with just the API key.

Authentication

Get an API key from the superagnt app and export it as SUPERAGNT_API_KEY. Every request sends it as a Bearer token:

Authorization: Bearer $SUPERAGNT_API_KEY

If the variable is not set, ask the user for their key or point them at https://superagnt.com/r/ch-reddit-data-key.

Verify the install (do this first)

One call proves the key, the credit balance, and this source end to end:

curl -s https://api.superagnt.com/v1/credits \
  -H 'Authorization: Bearer $SUPERAGNT_API_KEY'

A JSON result means you are live. A 401 means the key is wrong or missing; a 402 means the workspace is out of credits — the superagnt app shows both.

Base URL

https://api.superagnt.com/v1/data/reddit

Available Endpoints

MethodPathSummary
GET/getSimilarSubredditsSimilar Subreddits
GET/getPostDuplicatesPost Duplicates
GET/getSubredditModeratorsSubreddit Moderators
GET/getSubredditRulesSubreddit Rules
GET/getUserOverviewUser Overview
GET/getSearchUsersSearch Users
GET/getBestPopularPostsBest Popular Posts
GET/getControversialPostsBySubredditControversial Posts By Subreddit
GET/getUserPostRankInSubredditUser Post Rank In Subreddit
GET/getSubredditInfoSubreddit Info
GET/getCommentsBySubredditComments By Subreddit
GET/getPostCommentsWithSortPost Comments With Sort
GET/getProfileProfile
GET/getPostCommentsPost Comments
GET/getUserStatsUser Stats
GET/getSearchPostsSearch Posts
GET/getSearchSubredditsSearch Subreddits
GET/getNewSubredditsNew Subreddits
GET/getPopularSubredditsPopular Subreddits
GET/getPostDetailsPost Details
GET/getPostsBySubredditPosts By Subreddit
GET/getTopCommentsByUsernameTop Comments By Username
GET/getPopularPostsPopular Posts
GET/getTopPostsBySubredditTop Posts By Subreddit
GET/getCommentsByUsernameComments By Username
GET/getTopPostsByUsernameTop Posts By Username
GET/getPostsByUsernamePosts By Username
GET/getRisingPopularPostsRising Popular Posts
GET/getTopPopularPostsTop Popular Posts

Tool Schemas

The following JSON defines every operation with its parameters. Each tool maps to an API endpoint under the base URL.

[
  {
    "name": "superagnt_reddit_Similar_Subreddits",
    "description": "Similar Subreddits",
    "method": "GET",
    "path": "/getSimilarSubreddits",
    "parameters": {
      "type": "object",
      "properties": {
        "cursor": {
          "type": "string",
          "description": "Pagination cursor from previous response"
        },
        "subreddit": {
          "type": "string",
          "description": "Name of the subreddit (e.g. python)"
        }
      },
      "required": [
        "subreddit"
      ]
    }
  },
  {
    "name": "superagnt_reddit_Post_Duplicates",
    "description": "Post Duplicates",
    "method": "GET",
    "path": "/getPostDuplicates",
    "parameters": {
      "type": "object",
      "properties": {
        "cursor": {
          "type": "string",
          "description": "Pagination cursor from previous response"
        },
        "post_url": {
          "type": "string",
          "description": "Full Reddit post URL (e.g."
        }
      },
      "required": [
        "post_url"
      ]
    }
  },
  {
    "name": "superagnt_reddit_Subreddit_Moderators",
    "description": "Subreddit Moderators",
    "method": "GET",
    "path": "/getSubredditModerators",
    "parameters": {
      "type": "object",
      "properties": {
        "subreddit": {
          "type": "string",
          "description": "Name of the subreddit (e.g. askreddit)"
        }
      },
      "required": [
        "subreddit"
      ]
    }
  },
  {
    "name": "superagnt_reddit_Subreddit_Rules",
    "description": "Subreddit Rules",
    "method": "GET",
    "path": "/getSubredditRules",
    "parameters": {
      "type": "object",
      "properties": {
        "subreddit": {
          "type": "string",
          "description": "Name of the subreddit (e.g. askreddit)"
        }
      },
      "required": [
        "subreddit"
      ]
    }
  },
  {
    "name": "superagnt_reddit_User_Overview",
    "description": "User Overview",
    "method": "GET",
    "path": "/getUserOverview",
    "parameters": {
      "type": "object",
      "properties": {
        "sort": {
          "type": "string",
          "description": "Sort order: hot, new, top, controversial"
        },
        "time": {
          "type": "string",
          "description": "Required when sort is top or controversial: hour, day, week, month, year, all"
        },
        "cursor": {
          "type": "string",
          "description": "Pagination cursor from previous response"
        },
        "username": {
          "type": "string",
          "description": "Reddit username (e.g. spez)"
        }
      },
      "required": [
        "sort",
        "username"
      ]
    }
  },
  {
    "name": "superagnt_reddit_Search_Users",
    "description": "Search Users",
    "method": "GET",
    "path": "/getSearchUsers",
    "parameters": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "description": "Search keyword (e.g. spez)"
        },
        "cursor": {
          "type": "string",
          "description": "Pagination cursor from previous response"
        }
      },
      "required": [
        "query"
      ]
    }
  },
  {
    "name": "superagnt_reddit_Best_Popular_Posts",
    "description": "Best Popular Posts",
    "method": "GET",
    "path": "/getBestPopularPosts",
    "parameters": {
      "type": "object",
      "properties": {
        "cursor": {
          "type": "string",
          "description": "Pagination cursor from previous response"
        }
      }
    }
  },
  {
    "name": "superagnt_reddit_Controversial_Posts_By_Subreddit",
    "description": "Controversial Posts By Subreddit",
    "method": "GET",
    "path": "/getControversialPostsBySubreddit",
    "parameters": {
      "type": "object",
      "properties": {
        "cursor": {
          "type": "string",
          "description": "Pagination cursor from previous response"
        },
        "subreddit": {
          "type": "string",
          "description": "Name of the subreddit (e.g. askreddit)"
        },
        "time": {
          "type": "string",
          "description": "Time filter: hour, day, week, month, year, all"
        }
      },
      "required": [
        "subreddit",
        "time"
      ]
    }
  },
  {
    "name": "superagnt_reddit_User_Post_Rank_In_Subreddit",
    "description": "User Post Rank In Subreddit",
    "method": "GET",
    "path": "/getUserPostRankInSubreddit",
    "parameters": {
      "type": "object",
      "properties": {
        "sort": {
          "type": "string",
          "description": "Sort order: hot, new, rising, top"
        },
        "username": {
          "type": "string",
          "description": "Reddit username (e.g. spez)"
        },
        "time": {
          "type": "string",
          "description": "Required when sort is top: hour, day, week, month, year, all"
        },
        "subreddit": {
          "type": "string",
          "description": "Name of the subreddit (e.g. reddit)"
        },
        "max_pages": {
          "type": "number",
          "description": "Maximum pages to scan (1-10, default: 4)"
        }
      },
      "required": [
        "sort",
        "username",
        "subreddit"
      ]
    }
  },
  {
    "name": "superagnt_reddit_Subreddit_Info",
    "description": "Subreddit Info",
    "method": "GET",
    "path": "/getSubredditInfo",
    "parameters": {
      "type": "object",
      "properties": {
        "subreddit": {
          "type": "string",
          "description": "subreddit"
        }
      },
      "required": [
        "subreddit"
      ]
    }
  },
  {
    "name": "superagnt_reddit_Comments_By_Subreddit",
    "description": "Comments By Subreddit",
    "method": "GET",
    "path": "/getCommentsBySubreddit",
    "parameters": {
      "type": "object",
      "properties": {
        "subreddit": {
          "type": "string",
          "description": "subreddit"
        },
        "cursor": {
          "type": "string",
          "description": "cursor"
        }
      },
      "required": [
        "subreddit"
      ]
    }
  },
  {
    "name": "superagnt_reddit_Post_Comments_With_Sort",
    "description": "Post Comments With Sort",
    "method": "GET",
    "path": "/getPostCommentsWithSort",
    "parameters": {
      "type": "object",
      "properties": {
        "sort": {
          "type": "string",
          "description": "Valid options are: confidence, top, new, controversial, old, qa"
        },
        "cursor": {
          "type": "string",
          "description": "cursor"
        },
        "post_url": {
          "type": "string",
          "description": "post_url"
        }
      },
      "required": [
        "sort",
        "post_url"
      ]
    }
  },
  {
    "name": "superagnt_reddit_Profile",
    "description": "Profile",
    "method": "GET",
    "path": "/getProfile",
    "parameters": {
      "type": "object",
      "properties": {
        "username": {
          "type": "string",
          "description": "username"
        }
      },
      "required": [
        "username"
      ]
    }
  },
  {
    "name": "superagnt_reddit_Post_Comments",
    "description": "Post Comments",
    "method": "GET",
    "path": "/getPostComments",
    "parameters": {
      "type": "object",
      "properties": {
        "post_url": {
          "type": "string",
          "description": "post_url"
        }
      },
      "required": [
        "post_url"
      ]
    }
  },
  {
    "name": "superagnt_reddit_User_Stats",
    "description": "User Stats",
    "method": "GET",
    "path": "/getUserStats",
    "parameters": {
      "type": "object",
      "properties": {
        "username": {
          "type": "string",
          "description": "username"
        }
      },
      "required": [
        "username"
      ]
    }
  },
  {
    "name": "superagnt_reddit_Search_Posts",
    "description": "Search Posts",
    "method": "GET",
    "path": "/getSearchPosts",
    "parameters": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "description": "query"
        },
        "cursor": {
          "type": "string",
          "description": "cursor"
        },
        "sort": {
          "type": "string",
          "description": "Sort order. Use 'top' to filter by time."
        },
        "subreddit": {
          "type": "string",
          "description": "subreddit"
        },
        "time": {
          "type": "string",
          "description": "Time window. Only applies with sort 'top'; any other sort is refused with time set."
        }
      },
      "required": [
        "query"
      ]
    }
  },
  {
    "name": "superagnt_reddit_Search_Subreddits",
    "description": "Search Subreddits",
    "method": "GET",
    "path": "/getSearchSubreddits",
    "parameters": {
      "type": "object",
      "properties": {
        "cursor": {
          "type": "string",
          "description": "cursor"
        },
        "query": {
          "type": "string",
          "description": "query"
        }
      },
      "required": [
        "query"
      ]
    }
  },
  {
    "name": "superagnt_reddit_New_Subreddits",
    "description": "New Subreddits",
    "method": "GET",
    "path": "/getNewSubreddits",
    "parameters": {
      "type": "object",
      "properties": {
        "cursor": {
          "type": "string",
          "description": "cursor"
        }
      }
    }
  },
  {
    "name": "superagnt_reddit_Popular_Subreddits",
    "description": "Popular Subreddits",
    "method": "GET",
    "path": "/getPopularSubreddits",
    "parameters": {
      "type": "object",
      "properties": {
        "cursor": {
          "type": "string",
          "description": "cursor"
        }
      }
    }
  },
  {
    "name": "superagnt_reddit_Post_Details",
    "description": "Post Details",
    "method": "GET",
    "path": "/getPostDetails",
    "parameters": {
      "type": "object",
      "properties": {
        "post_url": {
          "type": "string",
          "description": "post_url"
        }
      },
      "required": [
        "post_url"
      ]
    }
  },
  {
    "name": "superagnt_reddit_Posts_By_Subreddit",
    "description": "Posts By Subreddit",
    "method": "GET",
    "path": "/getPostsBySubreddit",
    "parameters": {
      "type": "object",
      "properties": {
        "subreddit": {
          "type": "string",
          "description": "example: reddit.com/r/`memes`"
        },
        "sort": {
          "type": "string",
          "description": "you can just select one item from below:\n`new`\n`hot`\n`rising`"
        },
        "cursor": {
          "type": "string",
          "description": "cursor"
        }
      },
      "required": [
        "subreddit",
        "sort"
      ]
    }
  },
  {
    "name": "superagnt_reddit_Top_Comments_By_Username",
    "description": "Top Comments By Username",
    "method": "GET",
    "path": "/getTopCommentsByUsername",
    "parameters": {
      "type": "object",
      "properties": {
        "time": {
          "type": "string",
          "description": "you can just select one item from below:\n`hour`\n`day`\n`week`\n`month`\n`year`\n`all`"
        },
        "username": {
          "type": "string",
          "description": "username"
        },
        "cursor": {
          "type": "string",
          "description": "cursor"
        }
      },
      "required": [
        "time",
        "username"
      ]
    }
  },
  {
    "name": "superagnt_reddit_Popular_Posts",
    "description": "Popular Posts",
    "method": "GET",
    "path": "/getPopularPosts",
    "parameters": {
      "type": "object",
      "properties": {
        "cursor": {
          "type": "string",
          "description": "cursor"
        },
        "sort": {
          "type": "string",
          "description": "you can just send `new `or `hot`"
        }
      },
      "required": [
        "sort"
      ]
    }
  },
  {
    "name": "superagnt_reddit_Top_Posts_By_Subreddit",
    "description": "Top Posts By Subreddit",
    "method": "GET",
    "path": "/getTopPostsBySubreddit",
    "parameters": {
      "type": "object",
      "properties": {
        "time": {
          "type": "string",
          "description": "you can just select one item from below:\n`hour`\n`day`\n`week`\n`month`\n`year`\n`all`"
        },
        "subreddit": {
          "type": "string",
          "description": "example: reddit.com/r/`memes`"
        },
        "cursor": {
          "type": "string",
          "description": "cursor"
        }
      },
      "required": [
        "time",
        "subreddit"
      ]
    }
  },
  {
    "name": "superagnt_reddit_Comments_By_Username",
    "description": "Comments By Username",
    "method": "GET",
    "path": "/getCommentsByUsername",
    "parameters": {
      "type": "object",
      "properties": {
        "sort": {
          "type": "string",
          "description": "you can just send `new `or `hot`"
        },
        "username": {
          "type": "string",
          "description": "username"
        },
        "cursor": {
          "type": "string",
          "description": "cursor"
        }
      },
      "required": [
        "sort",
        "username"
      ]
    }
  },
  {
    "name": "superagnt_reddit_Top_Posts_By_Username",
    "description": "Top Posts By Username",
    "method": "GET",
    "path": "/getTopPostsByUsername",
    "parameters": {
      "type": "object",
      "properties": {
        "cursor": {
          "type": "string",
          "description": "cursor"
        },
        "username": {
          "type": "string",
          "description": "username"
        },
        "time": {
          "type": "string",
          "description": "you can just select one item from below:\n`hour`\n`day`\n`week`\n`month`\n`year`\n`all`"
        }
      },
      "required": [
        "username",
        "time"
      ]
    }
  },
  {
    "name": "superagnt_reddit_Posts_By_Username",
    "description": "Posts By Username",
    "method": "GET",
    "path": "/getPostsByUsername",
    "parameters": {
      "type": "object",
      "properties": {
        "username": {
          "type": "string",
          "description": "username"
        },
        "cursor": {
          "type": "string",
          "description": "cursor"
        },
        "sort": {
          "type": "string",
          "description": "you can just send `new `or `hot`"
        }
      },
      "required": [
        "username",
        "sort"
      ]
    }
  },
  {
    "name": "superagnt_reddit_Rising_Popular_Posts",
    "description": "Rising Popular Posts",
    "method": "GET",
    "path": "/getRisingPopularPosts",
    "parameters": {
      "type": "object",
      "properties": {
        "cursor": {
          "type": "string",
          "description": "cursor"
        }
      }
    }
  },
  {
    "name": "superagnt_reddit_Top_Popular_Posts",
    "description": "Top Popular Posts",
    "method": "GET",
    "path": "/getTopPopularPosts",
    "parameters": {
      "type": "object",
      "properties": {
        "time": {
          "type": "string",
          "description": "you can just select one item from below:\n`hour`\n`day`\n`week`\n`month`\n`year`\n`all`"
        },
        "cursor": {
          "type": "string",
          "description": "cursor"
        }
      },
      "required": [
        "time"
      ]
    }
  }
]

Example

curl -X GET 'https://api.superagnt.com/v1/data/reddit' \
  -H 'Authorization: Bearer $SUPERAGNT_API_KEY' \
  -H 'Content-Type: application/json'

Use Cases

  • Social and creator intelligence agents using Reddit
  • Marketing and research teams monitoring accounts and content
  • Product teams building alerts, digests, and dashboards
  • Developers prototyping LLM tools that need live network data
  • Data teams joining Reddit signals with CRM or warehouse data

Scope

This skill covers Reddit Data only — the endpoints listed above, nothing else. The same API key also works with superagnt's other data sources and platform tools, but those are separate listings that the user installs or enables themselves; this skill does not add or enable anything beyond what is documented here. The public catalog is at https://api.superagnt.com/v1/platforms.

Links

reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 469kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 321kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 321kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 321kUpdated Claude CodeCodexVerifiedInstall