Skip to main content
本指南介绍多数 Lensmor 集成都会使用的基础流程：
  1. 从企业 Profile、目标客户描述、关键词或市场范围开始。
  2. 发现相关展会。
  3. 查看参展商和参会人员，包括 Exhibitor、Social Signals 与 Visitor 来源标签。
  4. 只在数据可行动时解锁基础 Event Access、Visitor Access、Full Access 或联系人字段。

​
开始前准备

你需要有效的用户 API Key 和能够发送 HTTPS 请求的环境。

​
1. 检查 Credits 余额

该响应包含订阅 Credits、Add-On Credits、Gift Credits、总余额和可用的重置时间。API 与 Lensmor SaaS 共用同一 Credits 余额。

​
2. 搜索展会

使用响应中的 eventId 调用后续展会范围接口。

​
3. 获取展会详情

在查看人员或进行解锁前，先确认展会名称、日期、场地、地区和来源 URL。

​
4. 查看 Exhibitors 或 Personnel

Personnel 记录可能包含多值 sourceType：
映射关系为：
  • Exhibitor → exhibitor
  • Social Signals → social
  • Visitor → visitors
一个人可以拥有多个标签。完整说明见参会人员来源类型。 当响应包含 semantics.accessMode: "preview" 时，应读取 semantics.counts.visibleTotal 和 semantics.unlock.requiredForMoreResults。这些字段描述基础 Event Access。 Visitor 是独立的注册参会访客数据层。执行 Visitor 或 Full Access 解锁前，调用 POST /external/actions/precheck，分别使用 unlock_event_visitors 或 unlock_event_full_access，并检查 Visitor 数据是否可用以及预计消耗的 Credits。

​
5. 处理错误和限流

  • 401 Unauthorized：API Key 缺失或无效。
  • 402 Payment Required：余额或访问状态不足以完成付费操作。
  • 404 Not Found：目标展会、企业、人员或任务不存在。
  • 429 Too Many Requests：应退避后重试。

​
下一步

构建参会人员洞察

使用三类来源标签构建 Field Marketing、ABM 和销售触达工作流。

查找并解锁展会

理解 Preview、基础 Event Access、Visitor Access 和 Full Access。

解锁联系人邮箱

发起异步邮箱解锁任务并轮询结果。