基础 URL
所有 API 请求都发送到：/api/v2/ 为前缀。
身份验证
API 使用 API 密钥进行身份验证。请在每个请求的X-API-Key 请求头中包含你的密钥。
ll_live_ 开头，并与你的组织绑定。所有请求的作用范围都限定在密钥所属的组织内，因此大多数调用都无需单独传入组织 ID。
API 密钥只会在创建时显示一次。如果丢失，你需要重新生成一个。具体步骤请参见生成 API 密钥。
错误响应
所有 endpoint 都返回标准 HTTP 状态码。
错误响应的响应体中包含一个
error 字符串，用于描述问题。
资源组
API 按以下资源组组织，每个组对应 API 参考中的一个章节。工作区
在你的组织中列出、创建和重命名工作区。工作区是落地页、线索和域名的顶层容器。落地页
管理落地页：列出、创建、重命名、发布、取消发布和删除。发布需要指定域名和路径；如果超出套餐限制或路径已被占用，将返回400。
删除落地页会永久移除所有关联的变体、文件和集成。
A/B 测试（变体）
每个落地页都有一个或多个变体。主变体（master）是在 A/B 测试关闭时接收流量的变体。启用 A/B 测试后，流量会按照你设置的权重在各变体之间分配。
你无法删除主变体。请先将其他变体设为主变体。
编辑器
加载和保存特定变体的 HTML 内容和设置。保存 HTML 时会自动处理 base64 图片提取和版本管理。线索
按工作区或组织级别拉取线索。线索采用分页返回，可按日期范围、状态（complete 或 partial）、落地页和搜索关键词筛选。每次请求的最大分页大小为 1000。
线索 schema endpoint 会返回一个 Draft-07 JSON Schema，描述该落地页的线索可能包含的所有字段，包括表单字段、测验答案、系统字段和集成字段。
数据分析
一个灵活的 endpoint 即可满足所有数据分析需求。可按工作区、落地页或变体筛选。最具体的筛选条件优先：如果传入variantIds，工作区和落地页筛选条件将被忽略。
必填参数：
startDate、endDate、timezone（IANA 格式，例如 America/New_York）。
可选筛选条件： workspaceIds、landerIds、variantIds。
分组方式： date、lander、variant 或 workspace。默认为 date。
域名
按工作区或组织级别列出域名。文件夹
在工作区内将落地页整理到文件夹中。集成
创建并列出组织级集成，然后按落地页启用或停用。基于 OAuth 的集成（Mailchimp、HubSpot、Google Sheets、AWeber）需要交互式 OAuth 流程，无法直接通过 API 创建。OpenAPI 规范和交互式文档
完整的 OpenAPI 3.1 规范地址：通过 AI 助手使用 API（MCP）
如果你希望用自然语言而不是编写 API 调用来管理 LanderLab 账户，LanderLab MCP 服务器基于同一套 API 构建，并向任何兼容 MCP 的 AI 助手（包括 Claude、ChatGPT、Cursor 和 Windsurf）提供 30 多个工具。 MCP 服务器 URL 为：X-API-Key 请求头，因此无需 API 密钥。设置说明请参见通过 MCP 连接 AI 助手。