Reddit Data

---
name: reddit-data
description: "Reddit posts, comments, and subreddit data for agents — community research and sentiment as structured JSON."
version: 2.0.2
author: superagnt
license: MIT-0
platforms: [macos, linux, windows]
required_environment_variables:
  - SUPERAGNT_API_KEY
metadata:
  hermes:
    tags: [reddit-data, community-research, sentiment]
  openclaw:
    requires:
      env:
        - SUPERAGNT_API_KEY
      bins:
        - curl
    primaryEnv: SUPERAGNT_API_KEY
    emoji: "⚡"
    homepage: https://superagnt.com/r/ch-reddit-data-docs
---

# 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://mcp.superagnt.com/agent-setup/prompt.md

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 [dashboard](https://superagnt.com/r/ch-reddit-data-key) 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:

```bash
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 dashboard shows both.

## Base URL

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

## 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 every operation with its parameters. Each tool maps
to an API endpoint under the base URL.

```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": "you can just select one item from below:\n`relevance`\n`hot`\n`top`\n`new`\n`comments`"
        },
        "subreddit": {
          "type": "string",
          "description": "subreddit"
        },
        "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": [
        "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' \
  -H 'X-API-Key: your_api_key_here' \
  -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

- [Documentation](https://superagnt.com/r/ch-reddit-data-docs)
- [Dashboard / API keys](https://superagnt.com/r/ch-reddit-data-key)
- [This listing](https://clawhub.ai/superagnt/skills/reddit-data)