Get Control Pane Analytics Summary
Return the cached Rankhog control-pane analytics summary for a paid workspace. Cache policy: cached. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.
Return the cached Rankhog control-pane analytics summary for a paid workspace. Cache policy: cached. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.
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/analytics/control-pane-summary" \ -H "Content-Type: application/json" \ -d '{ "managedRedditAccountId": "mra_2x9rnkhdemo", "organizationId": "org_2x9rnkhdemo", "websiteId": "site_2x9rnkhdemo", "period": "week" }'{ "accountPool": { "connectedRedditAccounts": 3, "karma": { "current": 924, "delta": 42, "deltaPercent": 4.76, "previous": 882 } }, "generatedAt": "2026-06-17T12:00:00.000Z", "googleRankingsFound": { "delta": 2, "value": 8 }, "karma": { "current": 284, "delta": 31, "deltaPercent": 12.25, "previous": 253 }, "meaningfulSignals": { "delta": 4, "value": 19 }, "opportunitiesFound": { "delta": 6, "value": 42 }, "period": "week", "periodEndsAt": "2026-06-21T23:59:59.999Z", "periodStartsAt": "2026-06-15T00:00:00.000Z", "plannedWork": { "generatedAt": "2026-06-17T12:00:00.000Z", "needsAttention": 2, "plannedActions": { "blocked": 1, "comments": 6, "dueThisWeek": 8, "openTotal": 13, "pendingApproval": 3, "posts": 4, "ready": 5, "research": 2, "running": 1 }, "workerJobs": { "activeTotal": 4, "failedLast24h": 1, "queued": 2, "running": 1, "scheduled": 1 } }, "postsAndComments": { "comments": { "delta": 3, "value": 11 }, "posts": { "delta": 1, "value": 4 } }}{ "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" ] }, "message": "Missing required OAuth scope: rankhog: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 Reddit Action Execution Status POST
Return normalized status for a Reddit action execution, including workflow step, final Reddit permalink, and structured failure or verification-required details. Cache policy: live. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.
Get Job POST
Return one authorized background job snapshot. API keys cannot use this endpoint. Cache policy: live. Idempotency: none. Auth modes: mcp_oauth, session_bearer.