Linkly 的分析 API

使用我们的分析 API 以编程方式从 Linkly 导出点击数据和流量报告。

相关： 链接缩短 API | Webhook

开始前

Linkly 在界面中为您生成 API 请求，您可以将其复制并粘贴到您的应用程序中。

节省时间并让我们完成繁重的工作。我们的 API 完全可由机器使用。

授权

您需要您的 API 密钥 和 工作区 ID。您可以从 Linkly 内获取这些详细信息。

流量报告 API

Linkly 在您的流量报告内自动为您生成 API 请求。

Linkly 的流量报告 自动为您生成 API 请求，基于屏幕上显示的数据。

这些链接包含您的 API 密钥，易于自定义，可在您自己的应用程序中使用。

输出格式

分析 API 支持三种输出格式：

数据透视模式（矩阵格式）

默认情况下，API 返回时间序列数据，每个日期一行。使用 数据透视模式，您可以在单个请求中获取所有链接的流量作为矩阵。

使用任何流量报告中的 导出数据 下拉菜单快速按链接导出数据，或将 pivot=link_id 添加到您的 API 请求。

将 pivot=link_id 添加到您的请求以获取具有以下内容的数据：

• 日期作为行（每天一行）
• 链接作为列（每个链接一列）

CSV/TSV 数据透视输出示例

JSON 数据透视输出示例

{
  "links": [
    {"id": 123, "name": "我的链接", "full_url": "https://linkly.link/abc"},
    {"id": 456, "name": "其他链接", "full_url": "https://linkly.link/xyz"}
  ],
  "data": [
    {"date": "2025-12-30", "clicks": {"123": 45, "456": 12}},
    {"date": "2025-12-31", "clicks": {"123": 52, "456": 8}}
  ]
}

数据透视模式适用于：

• 比较多个链接的流量
• 导入到电子表格进行分析
• 在一次调用中使用所有链接数据构建仪表板

原始点击数据

我们记录的原始点击数据（包括完整参数、时间戳和地理位置信息）可供使用。

要访问此数据，请从底部的选项卡中点击 导出 并选择您的格式。这些是完全形成的 API 请求，您可以直接在应用程序中使用。

有关数据导出的注意事项

• 考虑首先在视图中过滤数据以减少导出的数据量。此功能导出用于生成当前屏幕上报告的基础数据。
• 此数据缓存时间最长为 3 小时。对此端点的重复请求不会产生实时数据。

分组计数

/counters/{dimension} 端点返回按单个维度分组的点击总数——例如 country、platform、destination、referer、isp 或 link_id。结果按点击计数排序，最高的在前。

最多返回 10,000 个值。 高基数维度——destination、referer、remote_ip 和 isp——可以有远多于该数量的不同值，在繁忙的工作区中。当这样时，您会收到按点击计数排名前 10,000 的值，其余的不返回。

total 字段始终是 每个 组的总点击数，包括任何未返回的。因此在截断的结果中 count 值的总和将小于 total——这意味着计算为 count / total 的百分比仍然准确。

如果您需要完整的值集而不仅仅是前 10,000 个，请导出原始点击数据并自行汇总，或使用 BigQuery 集成。

实时点击通知

有关实时点击通知，请参见 Webhook。Webhook 在点击发生时立即向您指定的 URL 发送 POST 请求，并提供有关该点击的详细信息。

您也可以通过 API 管理 webhook——有关详细信息，请参见 OpenAPI 规范。

公平使用政策

速率限制

分析 API 限制为 每个工作区每小时 50 个请求。

使用限制

除了速率限制外，分析 API 还有在每个计费周期内重置的使用限制：

什么计为使用

• API 请求：对分析 API 端点（/clicks、/counters、/export）的每次调用计为一个请求。
• 数据扫描：我们的分析数据库处理以满足您的请求的数据量。较大的日期范围和更复杂的查询扫描更多数据。

超过限制时会发生什么

如果您超过使用限制：

1. 1
   API 请求将返回 429 Too Many Requests 错误
2. 2
   您的限制将在下一个计费周期开始时自动重置
3. 3
   您的链接将继续正常工作和跟踪点击

减少使用的提示

大多数用户可以在单个 API 请求中获取所有数据 使用数据透视模式（pivot=link_id），该模式在一次调用中以矩阵形式返回所有链接的流量。

• 使用数据透视模式：添加 pivot=link_id 以在单个请求中获取所有链接的流量，而不是分别查询每个链接
• 缓存响应：在本地存储 API 响应，而不是重复获取相同数据
• 使用较小的日期范围：仅查询您需要的日期
• 批量请求：使用 link_ids 参数将多个链接查询合并为单个请求

需要更多？

如果您需要更高的限制，请使用支持小部件与我们交谈。

BigQuery 集成

对于高容量分析需求，Linkly 提供 BigQuery 集成，提供对您点击数据的直接 SQL 访问。

• 实时数据访问 - 在 BigQuery 中直接查询您的点击数据，实时更新
• 无限查询 - 没有 API 速率限制；您只为 BigQuery 计算付费
• 自定义报告 - 使用 Looker、Data Studio 或 Tableau 构建仪表板
• 数据整合 - 将点击数据与其他业务指标结合

BigQuery 集成包含在企业计划中。详情请 联系我们。

了解更多有关 BigQuery 集成 →

相关

• 链接缩短 API - 以编程方式创建和更新链接
• Webhook - 实时点击通知
• BigQuery 集成 - 对点击数据的直接 SQL 访问
• Zapier 集成 - 无代码集成