创建潜客名单

POST/api/v2/websets

根据自然语言目标创建企业或人物名单。接口返回 HTTP 202；后续条件生成、搜索和核验异步执行。

请求

需要 websets:write 权限。建议传入 Idempotency-Key，网络超时重试时复用原值。

cURL复制
curl -X POST "https://revor.ai/api/v2/websets"   -H "Authorization: Bearer sk-revor-REPLACE_ME"   -H "Idempotency-Key: webset-create-001"   -H "Content-Type: application/json"   -d '{
    "query": "北美地区的挖掘机制造商、经销商和租赁服务商",
    "title": "北美挖掘机公司",
    "count": 25,
    "target_kind": "company",
    "locale": "zh"
  }'

响应

JSON复制
{
  "ok": true,
  "request_id": "req_xxx",
  "webset": {
    "id": "webset-uuid",
    "status": "generating_criteria",
    "count": 25,
    "target_kind": "company"
  },
  "preparation_job": {
    "id": "job-uuid",
    "status": "queued"
  }
}

保存 webset.id。202 和 preparation_job.status=queued 只表示任务已接受，不代表名单完成。建议立即获取 Items 快照，再连接 Items SSE。

错误