Rankhog Docs
DocsCLIMCPAPI
API Reference

Get Workspace Strategy

Return the current product-owned Discovery and Radar strategy. Cache policy: live. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.

POST
/agent/v1/strategy

Return the current product-owned Discovery and Radar strategy. 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

curl -X POST "https://example.com/agent/v1/strategy" \  -H "Content-Type: application/json" \  -d '{    "organizationId": "org_2x9rnkhdemo",    "websiteId": "site_2x9rnkhdemo"  }'
{  "discoveryHealth": {    "fingerprint": "example-input-fingerprint",    "coverage": {      "Intercom alternative": "2026-06-17T12:00:00.000Z"    },    "completedCoverage": {},    "emptyDays": [],    "review": null  },  "discoverySearchEvidence": [    {      "provider": "firecrawl",      "mode": "reddit_restricted",      "query": "site:reddit.com Intercom alternative",      "countryCode": "US",      "languageCode": "en",      "capturedAt": "2026-06-17T12:00:00.000Z",      "position": 2    }  ],  "keywords": [    {      "enabled": true,      "id": "kw_1",      "intent": "Compare tools",      "keyword": "Intercom alternative",      "priority": 1    }  ],  "strategy": {    "bootstrap": {      "error": null,      "lastAttemptAt": "2026-06-17T12:00:00.000Z",      "needsCommunities": false,      "readyAt": "2026-06-17T12:00:00.000Z",      "status": "ready"    },    "discovery": {      "consecutiveEmptyScans": 0,      "direction": "Find support-tool comparison demand",      "lastScanAt": "2026-06-17T12:00:00.000Z",      "lastSuccessAt": "2026-06-17T12:00:00.000Z",      "lastTechnicalError": null,      "nextScanAt": "2026-06-18T07:00:00.000Z",      "status": "running"    },    "id": "strategy_1",    "market": {      "countryCode": "US",      "determined": false,      "languageCode": "en"    },    "radarEnabled": true,    "radarSystemDisabledReason": null  },  "subreddits": [    {      "enabled": true,      "fitReason": "SaaS operators",      "id": "sub_1",      "priority": 1,      "subreddit": "SaaS",      "verificationStatus": "verified",      "verifiedAt": "2026-06-17T12:00:00.000Z"    }  ],  "timeZone": "Europe/Paris"}
{  "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_missing_scope",    "details": {      "missingScopes": [        "rankhog:read"      ]    },    "message": "Missing required scope: rankhog:read."  }}
{  "error": {    "code": "agentic_internal_error",    "message": "Rankhog could not complete this agentic request."  }}

Open Reddit URL POST

Open an allowed Reddit URL in the paired Rankhog Desktop browser. This never exposes raw browser control. Cache policy: live. Idempotency: required. Auth modes: mcp_oauth, session_bearer.

Get Radar Coverage POST

Return current Radar watcher coverage and collector health. Cache policy: live. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.