Rankhog Docs
DocsCLIMCPAPI
API Reference

Get Radar Status

Report whether Radar is running for this workspace, what is blocking it, and what it has checked, surfaced and triaged recently. Cache policy: cached. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.

POST
/agent/v1/strategy/radar/status

Report whether Radar is running for this workspace, what is blocking it, and what it has checked, surfaced and triaged recently. 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

curl -X POST "https://example.com/agent/v1/strategy/radar/status" \  -H "Content-Type: application/json" \  -d '{    "organizationId": "org_2x9rnkhdemo",    "websiteId": "site_2x9rnkhdemo"  }'
{  "activity": {    "checkedCount": 1284,    "days": [      {        "checked": 96,        "day": "2026-08-31",        "surfaced": 1      },      {        "checked": 88,        "day": "2026-09-01",        "surfaced": 0      },      {        "checked": 103,        "day": "2026-09-02",        "surfaced": 2      }    ],    "surfacedCount": 11,    "triagedCount": 8,    "waitingCount": 3,    "windowDays": 14  },  "generatedAt": "2026-06-17T12:00:00.000Z",  "issues": [    {      "code": "results_delayed",      "message": "Some Radar results are taking longer to appear. Rankhog is retrying them automatically.",      "severity": "warning"    }  ],  "state": "live"}
{  "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."  }}

Get Radar Activity POST

Return measured Radar screening work and durable opportunity results for this product, including measurement coverage and freshness. Cache policy: cached. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.

Start Discovery POST

Start Discovery with an optional product direction. Cache policy: live. Idempotency: required. Auth modes: api_key, mcp_oauth, session_bearer.