superagnt-com Reddit: Default API
The Reddit: Default API from superagnt-com — 29 operation(s) for reddit: default.
The Reddit: Default API from superagnt-com — 29 operation(s) for reddit: default.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/superagnt-com:superagnt-com-reddit-default-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: 'superagnt Reddit: Default API'
description: Unified API for social media data. Access LinkedIn, YouTube, TikTok, X, Instagram, Reddit, and Facebook through a single API key.
version: 1.0.0
contact:
name: superagnt
url: https://superagnt.com
servers:
- url: https://api.superagnt.com
description: superagnt API
security:
- ApiKeyAuth: []
tags:
- name: 'Reddit: Default'
paths:
/v1/data/reddit/getSimilarSubreddits:
get:
operationId: Similar_Subreddits
summary: Similar Subreddits
tags:
- 'Reddit: Default'
parameters:
- name: cursor
in: query
required: false
schema:
type: string
description: Pagination cursor from previous response
- name: subreddit
in: query
required: true
schema:
type: string
default: python
description: Name of the subreddit (e.g. python)
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getPostDuplicates:
get:
operationId: Post_Duplicates
summary: Post Duplicates
tags:
- 'Reddit: Default'
parameters:
- name: cursor
in: query
required: false
schema:
type: string
description: Pagination cursor from previous response
- name: post_url
in: query
required: true
schema:
type: string
default: https://www.reddit.com/r/technology/comments/abc123/post_title
description: Full Reddit post URL (e.g.
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getSubredditModerators:
get:
operationId: Subreddit_Moderators
summary: Subreddit Moderators
tags:
- 'Reddit: Default'
parameters:
- name: subreddit
in: query
required: true
schema:
type: string
default: askreddit
description: Name of the subreddit (e.g. askreddit)
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getSubredditRules:
get:
operationId: Subreddit_Rules
summary: Subreddit Rules
tags:
- 'Reddit: Default'
parameters:
- name: subreddit
in: query
required: true
schema:
type: string
default: askreddit
description: Name of the subreddit (e.g. askreddit)
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getUserOverview:
get:
operationId: User_Overview
summary: User Overview
tags:
- 'Reddit: Default'
parameters:
- name: sort
in: query
required: true
schema:
type: string
default: new
enum:
- hot
- new
- top
- controversial
description: 'Sort order: hot, new, top, controversial'
- name: time
in: query
required: false
schema:
type: string
enum:
- hour
- day
- week
- month
- year
- all
description: 'Required when sort is top or controversial: hour, day, week, month, year, all'
- name: cursor
in: query
required: false
schema:
type: string
description: Pagination cursor from previous response
- name: username
in: query
required: true
schema:
type: string
default: spez
description: Reddit username (e.g. spez)
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getSearchUsers:
get:
operationId: Search_Users
summary: Search Users
tags:
- 'Reddit: Default'
parameters:
- name: query
in: query
required: true
schema:
type: string
default: spez
description: Search keyword (e.g. spez)
- name: cursor
in: query
required: false
schema:
type: string
description: Pagination cursor from previous response
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getBestPopularPosts:
get:
operationId: Best_Popular_Posts
summary: Best Popular Posts
tags:
- 'Reddit: Default'
parameters:
- name: cursor
in: query
required: false
schema:
type: string
description: Pagination cursor from previous response
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getControversialPostsBySubreddit:
get:
operationId: Controversial_Posts_By_Subreddit
summary: Controversial Posts By Subreddit
tags:
- 'Reddit: Default'
parameters:
- name: cursor
in: query
required: false
schema:
type: string
description: Pagination cursor from previous response
- name: subreddit
in: query
required: true
schema:
type: string
default: askreddit
description: Name of the subreddit (e.g. askreddit)
- name: time
in: query
required: true
schema:
type: string
default: all
enum:
- hour
- day
- week
- month
- year
- all
description: 'Time filter: hour, day, week, month, year, all'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getUserPostRankInSubreddit:
get:
operationId: User_Post_Rank_In_Subreddit
summary: User Post Rank In Subreddit
tags:
- 'Reddit: Default'
parameters:
- name: sort
in: query
required: true
schema:
type: string
default: new
enum:
- hot
- new
- rising
- top
description: 'Sort order: hot, new, rising, top'
- name: username
in: query
required: true
schema:
type: string
default: spez
description: Reddit username (e.g. spez)
- name: time
in: query
required: false
schema:
type: string
enum:
- hour
- day
- week
- month
- year
- all
description: 'Required when sort is top: hour, day, week, month, year, all'
- name: subreddit
in: query
required: true
schema:
type: string
default: reddit
description: Name of the subreddit (e.g. reddit)
- name: max_pages
in: query
required: false
schema:
type: number
description: 'Maximum pages to scan (1-10, default: 4)'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getSubredditInfo:
get:
operationId: Subreddit_Info
summary: Subreddit Info
tags:
- 'Reddit: Default'
parameters:
- name: subreddit
in: query
required: true
schema:
type: string
default: memes
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getCommentsBySubreddit:
get:
operationId: Comments_By_Subreddit
summary: Comments By Subreddit
tags:
- 'Reddit: Default'
parameters:
- name: subreddit
in: query
required: true
schema:
type: string
default: memes
- name: cursor
in: query
required: false
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getPostCommentsWithSort:
get:
operationId: Post_Comments_With_Sort
summary: Post Comments With Sort
tags:
- 'Reddit: Default'
parameters:
- name: sort
in: query
required: true
schema:
type: string
default: new
enum:
- confidence
- top
- new
- controversial
- old
- qa
description: 'Valid options are: confidence, top, new, controversial, old, qa'
- name: cursor
in: query
required: false
schema:
type: string
- name: post_url
in: query
required: true
schema:
type: string
default: https://www.reddit.com/r/fut/comments/1jv41on/baby_coming_in_team_2/
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getProfile:
get:
operationId: Profile
summary: Profile
tags:
- 'Reddit: Default'
parameters:
- name: username
in: query
required: true
schema:
type: string
default: GoldenChrysus
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getPostComments:
get:
operationId: Post_Comments
summary: Post Comments
tags:
- 'Reddit: Default'
parameters:
- name: post_url
in: query
required: true
schema:
type: string
default: https://www.reddit.com/r/fut/comments/1jv41on/baby_coming_in_team_2/
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getUserStats:
get:
operationId: User_Stats
summary: User Stats
tags:
- 'Reddit: Default'
parameters:
- name: username
in: query
required: true
schema:
type: string
default: GoldenChrysus
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getSearchPosts:
get:
operationId: Search_Posts
summary: Search Posts
description: getSearchPosts
tags:
- 'Reddit: Default'
parameters:
- name: query
in: query
required: true
schema:
type: string
default: nike
- name: cursor
in: query
required: false
schema:
type: string
- name: sort
in: query
required: false
schema:
type: string
enum:
- relevance
- hot
- top
- new
- comments
description: Sort order. Use 'top' to filter by time.
- name: subreddit
in: query
required: false
schema:
type: string
- name: time
in: query
required: false
schema:
type: string
enum:
- hour
- day
- week
- month
- year
- all
description: Time window. Only applies with sort 'top'; any other sort is refused with time set.
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getSearchSubreddits:
get:
operationId: Search_Subreddits
summary: Search Subreddits
description: getSearchSubreddits
tags:
- 'Reddit: Default'
parameters:
- name: cursor
in: query
required: false
schema:
type: string
- name: query
in: query
required: true
schema:
type: string
default: nike
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getNewSubreddits:
get:
operationId: New_Subreddits
summary: New Subreddits
description: getNewSubreddits
tags:
- 'Reddit: Default'
parameters:
- name: cursor
in: query
required: false
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getPopularSubreddits:
get:
operationId: Popular_Subreddits
summary: Popular Subreddits
description: getPopularSubreddits
tags:
- 'Reddit: Default'
parameters:
- name: cursor
in: query
required: false
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getPostDetails:
get:
operationId: Post_Details
summary: Post Details
tags:
- 'Reddit: Default'
parameters:
- name: post_url
in: query
required: true
schema:
type: string
default: https://www.reddit.com/r/fut/comments/1jv41on/baby_coming_in_team_2/
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getPostsBySubreddit:
get:
operationId: Posts_By_Subreddit
summary: Posts By Subreddit
tags:
- 'Reddit: Default'
parameters:
- name: subreddit
in: query
required: true
schema:
type: string
default: memes
description: 'example: reddit.com/r/`memes`'
- name: sort
in: query
required: true
schema:
type: string
default: new
enum:
- new
- hot
- rising
description: 'you can just select one item from below:
`new`
`hot`
`rising`'
- name: cursor
in: query
required: false
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getTopCommentsByUsername:
get:
operationId: Top_Comments_By_Username
summary: Top Comments By Username
tags:
- 'Reddit: Default'
parameters:
- name: time
in: query
required: true
schema:
type: string
default: all
enum:
- hour
- day
- week
- month
- year
- all
description: 'you can just select one item from below:
`hour`
`day`
`week`
`month`
`year`
`all`'
- name: username
in: query
required: true
schema:
type: string
default: GoldenChrysus
- name: cursor
in: query
required: false
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getPopularPosts:
get:
operationId: Popular_Posts
summary: Popular Posts
tags:
- 'Reddit: Default'
parameters:
- name: cursor
in: query
required: false
schema:
type: string
- name: sort
in: query
required: true
schema:
type: string
default: new
enum:
- new
- hot
description: you can just send `new `or `hot`
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getTopPostsBySubreddit:
get:
operationId: Top_Posts_By_Subreddit
summary: Top Posts By Subreddit
tags:
- 'Reddit: Default'
parameters:
- name: time
in: query
required: true
schema:
type: string
default: year
enum:
- hour
- day
- week
- month
- year
- all
description: 'you can just select one item from below:
`hour`
`day`
`week`
`month`
`year`
`all`'
- name: subreddit
in: query
required: true
schema:
type: string
default: memes
description: 'example: reddit.com/r/`memes`'
- name: cursor
in: query
required: false
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getCommentsByUsername:
get:
operationId: Comments_By_Username
summary: Comments By Username
tags:
- 'Reddit: Default'
parameters:
- name: sort
in: query
required: true
schema:
type: string
default: hot
enum:
- new
- hot
description: you can just send `new `or `hot`
- name: username
in: query
required: true
schema:
type: string
default: GoldenChrysus
- name: cursor
in: query
required: false
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getTopPostsByUsername:
get:
operationId: Top_Posts_By_Username
summary: Top Posts By Username
tags:
- 'Reddit: Default'
parameters:
- name: cursor
in: query
required: false
schema:
type: string
- name: username
in: query
required: true
schema:
type: string
default: GoldenChrysus
- name: time
in: query
required: true
schema:
type: string
default: all
enum:
- hour
- day
- week
- month
- year
- all
description: 'you can just select one item from below:
`hour`
`day`
`week`
`month`
`year`
`all`'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getPostsByUsername:
get:
operationId: Posts_By_Username
summary: Posts By Username
tags:
- 'Reddit: Default'
parameters:
- name: username
in: query
required: true
schema:
type: string
default: GoldenChrysus
- name: cursor
in: query
required: false
schema:
type: string
- name: sort
in: query
required: true
schema:
type: string
default: new
enum:
- new
- hot
description: you can just send `new `or `hot`
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getRisingPopularPosts:
get:
operationId: Rising_Popular_Posts
summary: Rising Popular Posts
tags:
- 'Reddit: Default'
parameters:
- name: cursor
in: query
required: false
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
/v1/data/reddit/getTopPopularPosts:
get:
operationId: Top_Popular_Posts
summary: Top Popular Posts
tags:
- 'Reddit: Default'
parameters:
- name: time
in: query
required: true
schema:
type: string
default: year
enum:
- hour
- day
- week
- month
- year
- all
description: 'you can just select one item from below:
`hour`
`day`
`week`
`month`
`year`
`all`'
- name: cursor
in: query
required: false
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'400':
description: Bad request
'401':
description: Unauthorized - invalid API key
'429':
description: Rate limit exceeded
security:
- ApiKeyAuth: []
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: Authorization
description: 'Bearer token. Pass your agntdata API key as: Authorization: Bearer agnt_live_...'