RedRover Logo

Analytics

Get Reddit Performance

Reddit results for a window: totals, a daily series and the top posts and comments.

GET/analytics/reddit
Scope: analytics:readAI Connector Tool: redrover_get_reddit_performance

Send days for a rolling window ending today, or startDate and endDate for calendar dates (both inclusive, UTC). Windows run up to 365 days; the default is the last 30.

Headers

  • AuthorizationstringRequired

    Bearer followed by an rr_live_ API key or a connected app's access token. See Authentication.

  • X-Workspace-IdstringRequired

    The workspace to act on, from List Workspaces.

    UUID

Query Parameters

  • daysinteger

    A rolling window of 1 to 365 days ending today

    1 to 365

  • startDatestring

    First day, like 2026-10-01. Send with endDate

  • endDatestring

    Last day, like 2026-10-31. Send with startDate

Response

200 Results for the window.

  • dataobjectRequired
    Show 4 Child Fields
    • windowobjectRequired

      The window reported on

      Show 2 Child Fields
      • startDatestringRequired
      • endDatestringRequired
    • totalsobjectRequired
      Show 5 Child Fields
      • postsnumberRequired
      • commentsnumberRequired
      • upvotesnumberRequired
      • impressionsnumberRequired
      • repliesOnPostsnumberRequired
    • dailyobject[]Required
      Show 5 Child Fields
      • datestringRequired
      • postsnumberRequired
      • commentsnumberRequired
      • upvotesnumberRequired
      • impressionsnumberRequired
    • topContentobject[]Required
      Show 9 Child Fields
      • idstringRequired

        Same ID the posts and comments endpoints use

      • typestringRequired

        one of post, comment

      • subredditstringRequired

        nullable

      • titlestringRequired

        nullable

      • excerptstringRequired

        nullable

      • urlstringRequired

        nullable

      • upvotesnumberRequired
      • repliesnumberRequired
      • postedAtstringRequired

        ISO 8601 datetime

        nullable

Errors

Every error uses the error envelope.

  • 400The window is invalid or longer than allowed
  • 401The Authorization header is missing, or the key is invalid or revoked
  • 403The key lacks the endpoint's scope, or cannot reach the workspace
  • 429More than 120 requests in a minute. Wait for Retry-After seconds
  • 500Something went wrong on our side
curl "https://app.tryredrover.com/api/public/v1/analytics/reddit?startDate=2026-10-01&endDate=2026-10-31" \
  -H "Authorization: Bearer $REDROVER_API_KEY" \
  -H "X-Workspace-Id: $REDROVER_WORKSPACE_ID"
200 Response
{
  "data": {
    "window": {
      "startDate": "2026-10-17",
      "endDate": "2026-11-15"
    },
    "totals": {
      "posts": 12,
      "comments": 48,
      "upvotes": 1310,
      "impressions": 86200,
      "repliesOnPosts": 97
    },
    "daily": [
      {
        "date": "2026-11-14",
        "posts": 1,
        "comments": 2,
        "upvotes": 64,
        "impressions": 4100
      }
    ],
    "topContent": [
      {
        "id": "48213",
        "type": "post",
        "subreddit": "startups",
        "title": "What we learned shipping a weekly changelog for a year",
        "excerpt": "We started writing a public changelog every Friday...",
        "url": "https://www.reddit.com/r/startups/comments/1abcde2/",
        "upvotes": 412,
        "replies": 58,
        "postedAt": "2026-11-02T15:00:04Z"
      }
    ]
  }
}