POST AI agent ready /v1/short-url/stats

短网址统计 API - 免费点击分析

提交缩短的 URL 的 slug 并接收其点击计数、原始 URL 和创建时间戳。使用它来跟踪通过 /v1/short-url/create 端点创建的链接的参与度。当用户点击短链接时，统计数据会实时更新。

Endpoint

curl -X POST https://api.botoi.com/v1/short-url/stats \
  -H "Content-Type: application/json" \
  -d '{"slug":"getting-started"}'

When to use this API

轮询每个营销活动链接的统计端点，并显示点击计数和转化数据。这可以让您的营销团队清楚地了解哪些渠道可以带来流量。

定期检查点击计数。当链接超过阈值（例如 1000 次点击）时，触发通知、旋转链接或更新排行榜。

向链接创建者显示他们的短网址收到了多少次点击。在简单的分析视图中显示原始 URL、创建日期和总点击次数。

点击次数会实时更新吗？

是的。每次重定向时计数器都会递增。由于键值存储中的最终一致性，可能会出现亚秒级的延迟，但出于实际目的，它是即时的。

我可以重置点击计数器吗？

不。没有可以重置点击计数的端点。如果您需要新的计数器，请使用不同的段创建一个新的短链接。

如果蛞蝓不存在会发生什么？

API 返回 404 错误，代码为 NOT_FOUND。仔细检查 slug 拼写或创建新的短链接。

统计端点是否单独统计机器人流量？

不会。点击计数器会跟踪所有重定向请求，包括机器人、爬网程序和预览提取程序。如果需要，过滤您这边的机器人流量。

我可以获得其他用户创建的链接的统计信息吗？

是的。任何了解该蛞蝓的人都可以访问统计数据。对各个短链接没有所有权或访问控制。

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.