Linkly的分析API

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

相关内容： 链接缩短API | Webhooks

开始之前

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集成。

实时点击通知

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

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

公平使用政策

速率限制

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

使用限制

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

计入使用情况的内容

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

超过限制时会发生什么

当付费计划上的工作区使用完所有API请求时，我们会自动向其订阅添加API包，以便您的集成继续工作，并向工作区成员发送电子邮件通知。API包在您移除它之前，每个计费周期都会添加额外的API请求。

API请求在以下情况下返回429 Too Many Requests错误：

1. 1
   工作区在免费或入门计划中，无法添加API包
2. 2
   工作区的订阅设为取消，或付款逾期
3. 3
   工作区已使用完所有数据扫描额度——API包添加请求，而不是数据

使用限制在每个计费周期开始时重置，您的链接继续正常工作和跟踪点击。

减少使用的提示

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

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

需要更多？

您可以随时在账单页面的Add-ons下自行添加API包。每个包在每个计费周期添加额外的API请求；该页面显示您计划的价格。

API包不会改变速率限制。如果您需要更高的速率限制，请使用支持小部件与我们交谈。

BigQuery集成

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

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

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

详细了解BigQuery集成→

相关内容

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