Get discovery criteria and strategy

GET/api/v2/websets/{webset_id}/strategy

Returns the currently persisted criteria and search strategy. It does not start a model call or search and does not consume credits. Requires websets:read; the Webset does not need to be complete.

cURLCopy
curl "https://revor.ai/api/v2/websets/WEBSET_ID/strategy" \
  -H "Authorization: Bearer sk-revor-REPLACE_ME"

Response

JSONCopy
{
  "ok": true,
  "request_id": "req_xxx",
  "webset_id": "webset-uuid",
  "webset_status": "searching",
  "readiness": "ready",
  "criteria_ready": true,
  "strategy_ready": true,
  "criteria": [
    {
      "id": "criterion-1",
      "description": "Manufactures, sells, rents, or repairs excavators",
      "type": "business_fit",
      "weight": 0.65,
      "required": true,
      "active": true
    }
  ],
  "strategy": {
    "query_groups": [
      {
        "angle": "North American excavator dealers and rentals",
        "rationale": "Cover regional dealerships and equipment-rental businesses",
        "queries": [
          {
            "text": "excavator dealer rental United States Canada",
            "user_location": "US"
          }
        ]
      }
    ],
    "additional_queries": [],
    "rounds": []
  },
  "criteria_updated_at": "2026-09-24T07:58:08.000Z",
  "strategy_available_at": "2026-09-24T07:58:12.000Z",
  "strategy_updated_at": "2026-09-24T07:58:12.000Z"
}

Readiness

• generating_criteria: criteria are still being generated.
• planning: criteria are ready and strategy planning continues.
• ready: the strategy can be displayed.
• failed / cancelled: the operation failed or was cancelled.

Display criteria after criteria_ready=true and strategy after strategy_ready=true. Before that, strategy=null. The SSE webset.strategy event sends the same complete presentation snapshot.