分页读取潜客结果

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

读取 Webset 的权威 Items 快照。名单运行中也可读取，此时 provisional=true 表示条目仍可能更新或移除。需要 websets:read 权限。

Query 参数

参数	默认值	说明
`match`	`qualified`	`qualified`、`full`、`partial`、`rejected`、`verified`。
`detail`	`compact`	`compact`、`standard` 或 `full`。
`limit`	`10`	`compact` 最大 50，`standard` 最大 25，`full` 最大 10。
`cursor`	无	上一页的 `next_cursor`。

qualified 返回 full + partial；verified 返回 full + partial + rejected。单条 Item 的 match.status 只会是 full、partial 或 rejected。

当前 weighted scoring 模式下，顶层 match.score 是 0–100 的综合加权分：80–100 为 full，40–79 为 partial，0–39 为 rejected。逐项条件的 confidence 或 score 是单项判断，不应和顶层综合分混用。

cURL
curl "https://revor.ai/api/v2/websets/WEBSET_ID/items?match=qualified&detail=compact&limit=50"   -H "Authorization: Bearer sk-revor-REPLACE_ME"

详细程度

compact：名称、网站或主页、行业或职位、匹配状态和分数。
standard：增加完整 entity、检查计数和条件摘要。
full：增加每项条件的 reasoning、confidence 和参考 URL。

响应

JSON
{
  "ok": true,
  "request_id": "req_xxx",
  "items": [
    {
      "id": "item-uuid",
      "target_kind": "company",
      "entity": {
        "name": "Example Equipment",
        "website": "https://example.com",
        "industry": "Construction Equipment"
      },
      "match": {
        "status": "full",
        "score": 92
      },
      "provisional": true
    }
  ],
  "detail": "compact",
  "next_cursor": null,
  "has_more": false,
  "webset_status": "verifying",
  "items_revision": 18,
  "stream_cursor": 289
}

分页与 SSE checkpoint

next_cursor 是不透明 REST 分页游标；stream_cursor 是数字 SSE 事件游标，不能混用。

多页读取时保存第一页的 stream_cursor + items_revision，沿 next_cursor 读完其余页面，再用第一页 checkpoint 连接 SSE。分页期间发生的更新会从该位置重放；客户端必须以 Item id 为唯一键合并重复项。

entity.name 是展示名称，不保证是唯一法人名称。母公司、地区子公司或同品牌不同法人可能同名；始终使用 Item id 作为唯一键，并结合官网判断企业实体。