Rankhog Docs
DocsCLIMCPAPI
API Reference

Get Subreddit Activity

Return cached subreddit activity and optionally refresh it through the paired Rankhog Desktop browser. Cache policy: cached. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.

POST
/agent/v1/activity

Return cached subreddit activity and optionally refresh it through the paired Rankhog Desktop browser. Cache policy: cached. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.

Authorization

AuthorizationBearer <token>

Rankhog organization API key sent as Authorization: Bearer rhog_....

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/agent/v1/activity" \  -H "Content-Type: application/json" \  -d '{    "managedRedditAccountId": "mra_2x9rnkhdemo",    "organizationId": "org_2x9rnkhdemo",    "maxComments": 10,    "maxPosts": 10,    "refresh": false,    "subreddit": "SaaS"  }'
{  "cached": {    "capturedAt": "2026-06-17T12:00:00.000Z",    "comments": [      {        "author": "operator42",        "bodyPreview": "The biggest lift came from asking for one setup action instead of five.",        "commentCount": null,        "createdAt": "2026-06-17T11:00:00.000Z",        "createdUtc": 1781694000,        "fullname": "t1_examplecomment",        "id": "examplecomment",        "kind": "comment",        "parentId": "t3_examplepost",        "permalink": "https://www.reddit.com/r/SaaS/comments/examplepost/example/examplecomment/",        "postId": "examplepost",        "score": 9,        "subreddit": "SaaS",        "title": null,        "url": null      }    ],    "fetchUrls": {      "comments": "https://www.reddit.com/r/SaaS/comments.json?limit=10",      "posts": "https://www.reddit.com/r/SaaS/hot.json?limit=10"    },    "posts": [      {        "author": "founder_alt",        "bodyPreview": "We changed onboarding from a checklist to a guided setup and activation improved.",        "commentCount": 18,        "createdAt": "2026-06-17T10:30:00.000Z",        "createdUtc": 1781692200,        "fullname": "t3_examplepost",        "id": "examplepost",        "kind": "post",        "parentId": null,        "permalink": "https://www.reddit.com/r/SaaS/comments/examplepost/example/",        "postId": null,        "score": 42,        "subreddit": "SaaS",        "title": "What actually moved your SaaS activation rate?",        "url": "https://www.reddit.com/r/SaaS/comments/examplepost/example/"      }    ],    "source": "reactive_cache"  },  "freshness": {    "ageSeconds": 180,    "status": "fresh"  },  "refresh": {    "browserCommandId": null,    "reason": null,    "status": "not_requested"  },  "subreddit": "SaaS"}
{  "error": {    "code": "agentic_invalid_input",    "details": {      "issues": [        {          "code": "invalid_type",          "message": "Expected string, received undefined.",          "path": [            "organizationId"          ]        }      ]    },    "message": "Request body did not match the agentic capability schema."  }}

{  "error": {    "code": "agentic_unauthorized",    "message": "Authenticate before using Rankhog agentic capabilities."  }}

{  "error": {    "code": "agentic_paid_plan_required",    "details": {      "managedAccountBillingStatus": "active",      "subscriptionStatus": "past_due"    },    "message": "Rankhog agentic capabilities are available only for active or trialing paid workspaces."  }}

{  "error": {    "code": "agentic_missing_scope",    "details": {      "missingScopes": [        "rankhog:read",        "reddit:activity:read"      ]    },    "message": "Missing required OAuth scope: rankhog:read, reddit:activity:read."  }}

{  "error": {    "code": "agentic_managed_account_not_found",    "message": "Managed Reddit account not found."  }}
{  "error": {    "code": "agentic_managed_account_inactive",    "details": {      "managedAccountStatus": "setup_required"    },    "message": "This managed Reddit account must be active before browser-backed agentic tools can run."  }}
{  "error": {    "code": "agentic_internal_error",    "message": "Rankhog could not complete this agentic request."  }}

Get Subreddit Rules POST

Fetch verified or live Reddit subreddit rules for a paid Rankhog workspace. Cache policy: cached. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.

Get Reddit Browser Status POST

Report whether Rankhog Desktop has a ready Reddit browser session for this managed account. Cache policy: live. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.