get/getUserPostRankInSubreddit

User Post Rank In Subreddit

Default

API Reference & Playground Get started for free

Cost / request

$0.01

Response format

JSON

Protocol

REST

About this endpoint

Access Reddit data through agntdata: User Post Rank In Subreddit. User Post Rank In Subreddit. 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

Name	In	Type	Required	Description
sort	query	string	required	Sort order: hot, new, rising, topDefault: `new`
username	query	string	required	Reddit username (e.g. spez)Default: `spez`
time	query	string	optional	Required when sort is top: hour, day, week, month, year, all
subreddit	query	string	required	Name of the subreddit (e.g. reddit)Default: `reddit`
max_pages	query	number	optional	Maximum pages to scan (1-10, default: 4)

Responses

Successful response

{
  "type": "object"
}

Agent / Developer Schema

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

{
  "operationId": "User_Post_Rank_In_Subreddit",
  "method": "get",
  "path": "/getUserPostRankInSubreddit",
  "summary": "User Post Rank In Subreddit",
  "description": "User Post Rank In Subreddit",
  "parameters": [
    {
      "name": "sort",
      "in": "query",
      "required": true,
      "schema": {
        "type": "string",
        "default": "new"
      },
      "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"
      },
      "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": [
    {
      "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.

Start for free

Related endpoints

getSubreddit Info

/getSubredditInfo

getComments By Subreddit

/getCommentsBySubreddit

getPost Comments With Sort

/getPostCommentsWithSort

Start using this endpoint

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

Get started for free View all endpoints

Reddit APIReddit data APIuser post rank in subreddit APIAI agents data APIReddit APIReddit data APIReddit for AI agents

Back to Reddit