Rankhog Docs
DocsCLIMCPAPI
API Reference

List Reddit Action History

List and filter the immutable Reddit action execution ledger, including creation origin, for one paid Rankhog workspace. `actionTypes` filters by several types at once. Each comment, reply and post carries a body preview, `contentKind` (linked the product's site, named it, on topic, or warm-up), the thread title, the latest observed Reddit numbers, its opportunity, and for Discovery finds the Google position when found. Cache policy: live. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.

POST
/agent/v1/reddit-actions/history

List and filter the immutable Reddit action execution ledger, including creation origin, for one paid Rankhog workspace. actionTypes filters by several types at once. Each comment, reply and post carries a body preview, contentKind (linked the product's site, named it, on topic, or warm-up), the thread title, the latest observed Reddit numbers, its opportunity, and for Discovery finds the Google position when found. 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/reddit-actions/history" \  -H "Content-Type: application/json" \  -d '{    "managedRedditAccountId": "mra_2x9rnkhdemo",    "organizationId": "org_2x9rnkhdemo",    "websiteId": "site_2x9rnkhdemo",    "actionType": "post",    "limit": 50,    "origin": "warmup",    "status": "submitted"  }'
{  "items": [    {      "actionType": "post",      "actorUserId": "user_2x9rnkhdemo",      "bodyPreview": "A useful post body.",      "contentKind": "warmup",      "createdAt": "2026-06-17T12:00:00.000Z",      "discoveryRank": null,      "metrics": {        "capturedAt": "2026-06-17T12:00:00.000Z",        "replies": 4,        "score": 23      },      "opportunityId": "opp_2x9rnkhdemo",      "threadTitle": "What is one tool you would not give up?",      "executionMode": "human",      "executionSource": "opportunity_confirmation",      "failureCode": null,      "failureReason": null,      "id": "ract_2x9rnkhdemo",      "latestVisibilityState": "visible",      "origin": "warmup",      "permalink": "https://www.reddit.com/r/SaaS/comments/abc123/example/",      "redditAccountId": "reddit_2x9rnkhdemo",      "redditUsername": "rankhog_demo",      "status": "submitted",      "subreddit": "SaaS",      "submittedAt": "2026-06-17T12:00:00.000Z",      "verificationExhaustedAt": null,      "warmupPlanId": "warmup_plan_2x9rnkhdemo"    }  ],  "nextCursor": null}
{  "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 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 Reddit Action Execution Status POST

Return normalized status for a Reddit action execution, including workflow step, final Reddit permalink, human-needed state, and structured failure or verification-required details. Cache policy: live. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.

Get Reddit Action History POST

Inspect one tenant-scoped Reddit action receipt with immutable origin, lifecycle events, observations, and derived performance. Cache policy: live. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.