superagnt/leverage / skills/core/social-data
social-data
VerifiedUnified data API for AI agents. One API key for LinkedIn, YouTube, TikTok, X, Instagram, Reddit, and Facebook, plus web scraping, SEO data, and hosted webhook receiving. Structured JSON, no infra to run.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 21.0 KB |
| references/facebook/README.md | markdown | 29.2 KB |
| references/instagram/README.md | markdown | 16.2 KB |
| references/linkedin/README.md | markdown | 33.5 KB |
| references/reddit/README.md | markdown | 17.6 KB |
| references/seo/README.md | markdown | 26.2 KB |
| references/tiktok/README.md | markdown | 6.3 KB |
| references/web/README.md | markdown | 6.7 KB |
| references/x/README.md | markdown | 32.0 KB |
| references/youtube/README.md | markdown | 13.8 KB |
references/reddit/README.md
View on GitHub# Reddit API Reference
**App name:** `reddit`
**Base URL:** `https://api.superagnt.com/v1/data/reddit`
**Endpoints:** 29
Unified access to subreddit metadata, post threads, user activity, and search. Built for LLMs and automation — not one-off scraping.
## Authentication
All requests require the superagnt API key:
```
Authorization: Bearer $SUPERAGNT_API_KEY
```
---
## Available Endpoints
| Method | Path | Summary |
|--------|------|---------|
| `GET` | `/getSimilarSubreddits` | Similar Subreddits |
| `GET` | `/getPostDuplicates` | Post Duplicates |
| `GET` | `/getSubredditModerators` | Subreddit Moderators |
| `GET` | `/getSubredditRules` | Subreddit Rules |
| `GET` | `/getUserOverview` | User Overview |
| `GET` | `/getSearchUsers` | Search Users |
| `GET` | `/getBestPopularPosts` | Best Popular Posts |
| `GET` | `/getControversialPostsBySubreddit` | Controversial Posts By Subreddit |
| `GET` | `/getUserPostRankInSubreddit` | User Post Rank In Subreddit |
| `GET` | `/getSubredditInfo` | Subreddit Info |
| `GET` | `/getCommentsBySubreddit` | Comments By Subreddit |
| `GET` | `/getPostCommentsWithSort` | Post Comments With Sort |
| `GET` | `/getProfile` | Profile |
| `GET` | `/getPostComments` | Post Comments |
| `GET` | `/getUserStats` | User Stats |
| `GET` | `/getSearchPosts` | Search Posts |
| `GET` | `/getSearchSubreddits` | Search Subreddits |
| `GET` | `/getNewSubreddits` | New Subreddits |
| `GET` | `/getPopularSubreddits` | Popular Subreddits |
| `GET` | `/getPostDetails` | Post Details |
| `GET` | `/getPostsBySubreddit` | Posts By Subreddit |
| `GET` | `/getTopCommentsByUsername` | Top Comments By Username |
| `GET` | `/getPopularPosts` | Popular Posts |
| `GET` | `/getTopPostsBySubreddit` | Top Posts By Subreddit |
| `GET` | `/getCommentsByUsername` | Comments By Username |
| `GET` | `/getTopPostsByUsername` | Top Posts By Username |
| `GET` | `/getPostsByUsername` | Posts By Username |
| `GET` | `/getRisingPopularPosts` | Rising Popular Posts |
| `GET` | `/getTopPopularPosts` | Top Popular Posts |
## Tool Schemas
The following JSON defines all available tools with their parameters. Each tool maps to an API endpoint.
```json
[
{
"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
```bash
curl -X GET "https://api.superagnt.com/v1/data/reddit/getSimilarSubreddits?param=value" \
-H "Authorization: Bearer $SUPERAGNT_API_KEY"
```
## Links
- [Documentation](https://superagnt.com/docs)
- [API Reference](https://superagnt.com/docs/apis/social/reddit)
- [superagnt app](https://app.superagnt.com/dashboard)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 471k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |