Reddit Analytics

Reddit analytics endpoints provide insights for your connected Reddit accounts.

1. GET /api/reddit/overview

Returns account-level metrics with current vs. previous period comparison.

Sample Request

curl --location --request GET \
"https://analyze.oneupapp.io/api/reddit/overview?apiKey=YOUR_API_KEY&social_network_id=123&preset=last_30_days"

Sample Response

{
  "success": true,
  "data": {
    "metrics": [
      {
        "key": "posts",
        "name": "Posts",
        "value_current_period": 20,
        "value_last_period": 18,
        "percentage_change": "+11.1%",
        "description": "Total number of posts in this period"
      },
      {
        "key": "upvotes",
        "name": "Upvotes",
        "value_current_period": 2500,
        "value_last_period": 2100,
        "percentage_change": "+19.0%",
        "description": "The number of upvotes on your posts"
      },
      {
        "key": "downvotes",
        "name": "Downvotes",
        "value_current_period": 45,
        "value_last_period": 40,
        "percentage_change": "+12.5%",
        "description": "The number of downvotes on your posts"
      },
      {
        "key": "comments",
        "name": "Comments",
        "value_current_period": 380,
        "value_last_period": 320,
        "percentage_change": "+18.8%",
        "description": "The number of comments on your posts"
      },
      {
        "key": "shares",
        "name": "Shares",
        "value_current_period": 85,
        "value_last_period": 70,
        "percentage_change": "+21.4%",
        "description": "The number of times your posts were shared"
      }
    ],
    "total_followers": 12500,
    "post_performance": {
      "most_engaging": [],
      "least_engaging": [],
      "most_upvoted": [],
      "least_upvoted": [],
      "most_commented": [],
      "least_commented": []
    }
  }
}

Metrics

Key	Name	Description
posts	Posts	Total posts published
upvotes	Upvotes	The number of upvotes on your posts
downvotes	Downvotes	The number of downvotes on your posts
comments	Comments	The number of comments on your posts
shares	Shares	The number of times your posts were shared

---

2. GET /api/reddit/posts

Returns analytics for individual posts.

Sample Request

curl --location --request GET \
"https://analyze.oneupapp.io/api/reddit/posts?apiKey=YOUR_API_KEY&social_network_id=123&preset=last_30_days"

Sample Response

{
  "success": true,
  "data": {
    "stats": [
      {
        "key": "posts",
        "name": "Posts",
        "value_current_period": 20,
        "value_last_period": 18,
        "percentage_change": "+11.1%",
        "description": "Total number of posts in this period"
      },
      {
        "key": "upvotes",
        "name": "Upvotes",
        "value_current_period": 2500,
        "value_last_period": 2100,
        "percentage_change": "+19.0%",
        "description": "The number of upvotes on your posts"
      },
      {
        "key": "downvotes",
        "name": "Downvotes",
        "value_current_period": 45,
        "value_last_period": 40,
        "percentage_change": "+12.5%",
        "description": "The number of downvotes on your posts"
      },
      {
        "key": "comments",
        "name": "Comments",
        "value_current_period": 380,
        "value_last_period": 320,
        "percentage_change": "+18.8%",
        "description": "The number of comments on your posts"
      },
      {
        "key": "shares",
        "name": "Shares",
        "value_current_period": 85,
        "value_last_period": 70,
        "percentage_change": "+21.4%",
        "description": "The number of times your posts were shared"
      }
    ],
    "posts": [
      {
        "id": "post_abc123",
        "page_id": "reddit_account_123",
        "format": "text",
        "text": "Interesting discussion topic",
        "permalink": "https://reddit.com/r/subreddit/comments/abc123",
        "media_type": "TEXT",
        "media_url": null,
        "stats": {
          "upvotes": 125,
          "downvotes": 2,
          "comments": 19,
          "shares": 4
        },
        "timestamp": "2025-05-01 16:00:00"
      }
    ]
  }
}

Post Stats

Field	Description
upvotes	Number of upvotes
downvotes	Number of downvotes
comments	Number of comments
shares	Number of shares

✅ Result: You have successfully retrieved Reddit analytics data!