Rankhog Docs
DocsCLIMCPAPI
API Reference

Get Reactive Coverage

Return durable Reactive coverage, overlap, backlog, freshness tier, and collector capacity for a paid workspace. Cache policy: live. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.

POST
/agent/v1/reactive/coverage

Return durable Reactive coverage, overlap, backlog, freshness tier, and collector capacity for a paid workspace. Cache policy: live. 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

curl -X POST "https://example.com/agent/v1/reactive/coverage" \  -H "Content-Type: application/json" \  -d '{    "managedRedditAccountId": "mra_2x9rnkhdemo",    "organizationId": "org_2x9rnkhdemo"  }'
{  "capacity": {    "delayed": false,    "eligibleNodeCount": 14,    "nodesPerUniqueSubreddit": 7,    "overlapRatio": 0.67,    "subscriptionCount": 6,    "uniqueSubredditCount": 2  },  "freshnessTier": {    "exactMentionTargetSeconds": 120,    "id": "one_minute",    "semanticTargetSeconds": 300,    "sourceTargetSeconds": 60  },  "generatedAt": "2026-06-17T12:00:00.000Z",  "sources": [    {      "commentOverlapAt": "2026-06-17T12:00:00.000Z",      "coverageStatus": "healthy",      "lastOverlapAt": "2026-06-17T12:00:00.000Z",      "lastSuccessfulScanAt": "2026-06-17T12:00:00.000Z",      "nextScanAt": "2026-06-17T12:01:00.000Z",      "oldestBacklogAt": null,      "postOverlapAt": "2026-06-17T12:00:00.000Z",      "subreddit": "saas"    }  ],  "watchedSubredditLimit": 10}
{  "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_internal_error",    "message": "Rankhog could not complete this agentic request."  }}

Get Subreddit Activity POST

Return subreddit activity from the durable Reactive source without bypassing internal collector scheduling. 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.