Linkly 的分析 API

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

相关：链接缩短 API | Webhooks

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

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

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

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

Linkly 的流量报告会根据屏幕上显示的数据自动为您构建 API 请求。

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

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

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

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

在您的请求中添加 pivot=link_id 以获取以下格式的数据：

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

{
  "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 小时。对此端点的重复请求不会生成实时数据。

有关实时点击通知，请参阅 Webhooks。当发生点击时，Webhooks 会立即向您指定的 URL 发送 POST 请求，其中包含有关点击的详细信息。

您还可以通过 API 管理 webhook - 详情请参阅 OpenAPI 规范。

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

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

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

如果您超出使用限制：

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

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

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

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

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

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

BigQuery 集成对无限制计划客户免费，或作为 100 美元/月的附加项提供给其他计划。

了解更多关于 BigQuery 集成 →

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