superagnt-com

superagnt-com Reddit: Default API

The Reddit: Default API from superagnt-com — 29 operation(s) for reddit: default.

GitHub OpenAPI

Operations 29

GET /v1/data/reddit/getSimilarSubreddits Similar Subreddits #
GET /v1/data/reddit/getPostDuplicates Post Duplicates #
GET /v1/data/reddit/getSubredditModerators Subreddit Moderators #
GET /v1/data/reddit/getSubredditRules Subreddit Rules #
GET /v1/data/reddit/getUserOverview User Overview #
GET /v1/data/reddit/getSearchUsers Search Users #
GET /v1/data/reddit/getControversialPostsBySubreddit Controversial Posts By Subreddit #
GET /v1/data/reddit/getUserPostRankInSubreddit User Post Rank In Subreddit #
GET /v1/data/reddit/getSubredditInfo Subreddit Info #
GET /v1/data/reddit/getCommentsBySubreddit Comments By Subreddit #
GET /v1/data/reddit/getPostCommentsWithSort Post Comments With Sort #
GET /v1/data/reddit/getProfile Profile #
GET /v1/data/reddit/getPostComments Post Comments #
GET /v1/data/reddit/getUserStats User Stats #
GET /v1/data/reddit/getSearchPosts Search Posts #
GET /v1/data/reddit/getSearchSubreddits Search Subreddits #
GET /v1/data/reddit/getNewSubreddits New Subreddits #
GET /v1/data/reddit/getPostDetails Post Details #
GET /v1/data/reddit/getPostsBySubreddit Posts By Subreddit #
GET /v1/data/reddit/getTopCommentsByUsername Top Comments By Username #
GET /v1/data/reddit/getTopPostsBySubreddit Top Posts By Subreddit #
GET /v1/data/reddit/getCommentsByUsername Comments By Username #
GET /v1/data/reddit/getTopPostsByUsername Top Posts By Username #
GET /v1/data/reddit/getPostsByUsername Posts By Username #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/superagnt-com/openapi/superagnt-com-reddit-default-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/superagnt-com/json-schema/superagnt-com-agnt-meta-schema.json
📊
JSONSchema
https://artifacts.apis.io/superagnt-com/json-schema/superagnt-com-companies-bulk-enrich-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/superagnt-com/json-schema/superagnt-com-companies-bulk-enrich-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/superagnt-com/json-schema/superagnt-com-companies-discover-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/superagnt-com/json-schema/superagnt-com-companies-discover-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/superagnt-com/json-schema/superagnt-com-companies-domain-emails-request-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/superagnt-com:superagnt-com-reddit-default-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API 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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

superagnt-com-reddit-default-api-openapi.yml Raw ↑ 
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_...'