Reddit API
Official Reddit API profile for reading, submitting, editing, and deleting content. Register a Reddit OAuth application, use the documented authorization URL and scopes, exchange the code for an access token, and send Authorization: Bearer TOKEN to oauth.reddit.com. Use a descriptive User-Agent, honor rate limits and subreddit rules, and request only the scopes needed for the operation.
Connect this API to an AI agent Browse all specs
What you can do with Reddit API via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| GET | /r/{subreddit}/new |
list_reddit_subreddit_posts | List subreddit posts Method: GET Path: /r/{subreddit}/new IMPORTANT: This function has 1 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - subreddit: Subreddit name Query Parameters: OPTIONAL: - limit: Listing size - after: Pagination fullname |
| GET | /comments/{article} |
get_reddit_post_comments | Read a post and comments Method: GET Path: /comments/{article} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - article: Reddit article fullname or ID |
| POST | /api/submit |
create_reddit_post | Create a post Method: POST Path: /api/submit IMPORTANT: This function has 3 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Request Body: REQUIRED: - sr: Subreddit name. - kind: kind parameter from application/json - title: Text content. OPTIONAL: - text: text parameter from application/json - url: url parameter from application/json |
| POST | /api/editusertext |
edit_reddit_self_post | Edit a self-post Method: POST Path: /api/editusertext IMPORTANT: This function has 2 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Request Body: REQUIRED: - thing_id: Fullname of the self-post. - text: text parameter from application/json |
| POST | /api/del |
delete_reddit_content | Delete a post or comment Method: POST Path: /api/del IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Request Body: REQUIRED: - id: Fullname of the post or comment. |
Usage guide
## Authentication Official Reddit API profile for reading, submitting, editing, and deleting content. Register a Reddit OAuth application, use the documented authorization URL and scopes, exchange the code for an access token, and send Authorization: Bearer TOKEN to oauth.reddit.com. Use a descriptive User-Agent, honor rate limits and subreddit rules, and request only the scopes needed for the operation. ## Endpoint coverage This listing contains 5 documented path(s) and 5 operation(s). Review each operation's required OAuth scope or token type before use. ## Official documentation [Reddit developer documentation](https://www.reddit.com/dev/api/)
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “Reddit API” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.