查询潜客名单详情

GET/api/v2/websets/{webset_id}

查询名单状态、进度、条件和时间信息。需要 websets:read 权限。

cURL复制
curl "https://revor.ai/api/v2/websets/WEBSET_ID"   -H "Authorization: Bearer sk-revor-REPLACE_ME"

响应

JSON复制
{
  "ok": true,
  "request_id": "req_xxx",
  "item": {
    "id": "webset-uuid",
    "name": "北美挖掘机公司",
    "query": "北美地区的挖掘机制造商……",
    "target_kind": "company",
    "status": "searching",
    "progress": {
      "stage": "searching",
      "goal": 25,
      "verify_cap": 75,
      "verified": 0,
      "qualified": 0,
      "full": 0,
      "stop_reason": null,
      "updated_at": "2026-09-24T08:00:00.000Z"
    },
    "criteria": [
      {
        "id": "criterion-1",
        "description": "实际制造、销售、出租或维修挖掘机",
        "type": "business_fit",
        "weight": 0.65,
        "required": true,
        "active": true
      }
    ],
    "failure": null
  }
}

进度字段

• goal：希望交付的合格结果总数。
• verify_cap：本轮允许核验的候选上限，不是结果数。
• verified：当前一次创建或 Find More 运行已核验的数量；新运行会重新计数。
• qualified：当前结果池中的 full + partial 数量，可能包含尚未释放的 overflow。
• full：完全符合条件的数量。
• stop_reason：本轮停止原因。

Find More 后 verified 变小而 qualified 增长是正常现象。最终可见结果以 Items 分页为准。

失败

status=failed 时读取 failure.code。不存在或不属于当前用户的 ID 返回 404 webset_not_found。