Redditget/getTopPostsByUsername

Top Posts By Username

Default
Cost / request

$0.01

Response format

JSON

Protocol

REST

About this endpoint

Access Reddit data through agntdata: Top Posts By Username. Top Posts By Username. Responses are structured JSON for AI agents, analytics, and automation — one API key instead of juggling upstream accounts. Ideal when you need subreddit metadata, post threads, user activity, and search programmatically.

Use cases

AI agents that need Reddit data in structured form
Analytics and monitoring pipelines for Reddit content
Research and GTM workflows that combine Reddit signals with other data

Parameters

NameInTypeRequiredDescription
cursorquerystringoptional
usernamequerystringrequiredDefault: GoldenChrysus
timequerystringrequiredyou can just select one item from below: `hour` `day` `week` `month` `year` `all`Default: all

Responses

Successful response

{
  "type": "object"
}

Agent / Developer Schema

Machine-readable formats for integrating this endpoint into AI agents and toolchains.

{
  "operationId": "Top_Posts_By_Username",
  "method": "get",
  "path": "/getTopPostsByUsername",
  "summary": "Top Posts By Username",
  "description": "Top Posts By Username",
  "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"
      },
      "description": "you can just select one item from below:\n`hour`\n`day`\n`week`\n`month`\n`year`\n`all`"
    }
  ],
  "responses": [
    {
      "statusCode": "200",
      "description": "Successful response",
      "content": {
        "application/json": {
          "schema": {
            "type": "object"
          }
        }
      }
    },
    {
      "statusCode": "400",
      "description": "Bad request"
    },
    {
      "statusCode": "401",
      "description": "Unauthorized - invalid API key"
    },
    {
      "statusCode": "429",
      "description": "Rate limit exceeded"
    }
  ]
}

Pricing

$0.01per successful request

Credits are deducted from your agntdata balance on each successful API call. Failed requests (4xx/5xx) are not charged.

Related endpoints

Start using this endpoint

Generate your API key and make your first call in under a minute. Free tier available with transparent pricing.

Reddit APIReddit data APItop posts by username APIAI agents data APIReddit APIReddit data APIReddit for AI agents