API
公开读取 API
一个端点，返回 TriRank 对某个域名已经测到的东西。
这里写的是 signals 端点，它是你能从自己代码里调用的那一个。我们的免费工具端点刻意挡在人机验证之后——它们存在的目的就是拦住自动化客户端——所以把它们写进文档等于发布一份没人能照做的说明。
端点
GET https://trirankai.com/api/signals/<domain>
返回一个域名已存读数的 JSON 快照：哪些 AI 引擎引用它、可见度分数、Domain Rating、被引用的页面，以及与它一同出现的那些站点。域名会用产品其余部分所用的同一个函数归一化，归一化后的主机名会原样回给你。
鉴权
不需要。想提高每日额度，就在 x-api-key 请求头里带上 TriRank API key——与 MCP 服务器接受的是同一个 key。key 在账户设置里创建。
key 被拒绝不算错误：请求会按匿名档照常返回，回包里会写明它是按哪一档服务的。这样一来，key 轮换只会降低你的额度，而不会让你的集成直接坏掉。
限流
- 不带 key：每天 60 次，按 IP 计。
- 免费账户带 key：每天 200 次。
- 付费方案带 key：每天 1000 次。
每个回包都带着已用次数、上限与窗口重置时间，所以你不用猜自己还剩多少。超限会收到 429，带着同样这三个数。
回包永远遵守的三条规则
字段会随我们增加测量项而变化，这三条不会。它们是这个形状之所以如此的理由；知道它们，你读到一个没见过的字段时才不会猜错。
- 缺席永远不是零
- 没有存量读数的那一块会被标成「未测量」返回，一个数字都不带。它绝不会以 0 的形式返回。这是两个不同的事实——一个说我们看过、没找到，另一个说我们还没看过——而把后者当成前者，是调用方在这份数据上能犯的最贵的错。
- 每一块都自带来源与时间
- 每一块都带着它自己的来源和被检查的时间。回包不会为整个 payload 盖一个统一的新鲜度戳，因为各部分确实以不同的速度变旧。你永远不需要去推断某个数字有多新。
- 读不到不会触发一次测量
- 每次读取都是纯查询。问一个我们从未测过的域名，不会导致我们去测它——它会返回诚实的「未测量」。这正是这个端点可以公开且免费的原因：循环调用它花掉的是我们的数据库读取，永远不是 AI 服务商的钱。