已索引 7985 亿个 Backlinks
从 CMS 在发布时触发的 Webhook 中调用它。您将获取来自我们 1.81 亿域名索引的 JSON 数据，享受免费概览调用，并获得无需绑卡的 $100 额度。
$ curl "https://contentin.app/api.php?action=overview&q=example.com&key=sk_live_..."
适用对象
发布是一个事件。Contentful、Sanity 和 Strapi 均可在条目上线时触发 Webhook。该钩子后的小型函数可以在构建或缓存刷新之前，向我们的 API 询问关于链接的一个问题。
Contentin 是为已运行此类流程的团队构建的，因此无需任何人打开仪表盘。overview 调用是免费的且无需密钥，这意味着您可以在今天下午将其接入测试环境钩子，并在消耗额度之前读取 JSON 数据。
将检查视为一道关卡，而非报告。短记忆有助于提升效率。它读取的链接图每月刷新一次，因此它告诉您某个域名是否已知及其评分情况，而非链接是否在昨天上线。请考虑到这一时间差，并从 Webhook 运行手册 开始。
我们的观点
使用数据来警告编辑者、标记条目或驱动夜间扫描。它无法保证页面的排名位置，在您需要关键词套件时，它也不会取代关键词套件。
对比
| 站点 | 每月发布次数 | 每次发布的调用次数 | 额度 | 美元 |
|---|---|---|---|---|
| 文档站点 | 200 | 1 次 refdomains（2 个额度） | 400 | $0.04 |
| 产品营销站点 | 3,000 | overview（免费）+ 1 次 backlinks（2 个额度） | 6,000 | $0.60 |
| 编辑网络 | 50,000 | refdomains + backlinks（4 个额度） | 200,000 | $20.00 |
条目中的字段名为本草图虚构。请将其替换为您自己的内容模型。
// runs when the CMS reports that an entry went live
export async function onPublish(entry) {
const host = new URL(entry.fields.canonicalUrl).hostname;
const res = await fetch(
`https://contentin.app/api.php?action=overview&q=${host}`
);
const data = await res.json();
if (!data.ok) {
console.warn('link check failed, publish continues');
return null;
}
return data; // keep only what you need in your own field
}用途
一旦钩子存在，有四件事至关重要：什么是免费的，什么是便宜的，什么可以批量运行，以及失败时的表现。
适用对象
大多数首次集成都会卡在同样的三个问题上。答案虽短，但每一项都会影响钩子在繁忙日子的行为表现。
不需要，免费操作无需密钥。overview、domain、stats 和 suggest 无需密钥即可运行，因此测试环境的钩子可以针对普通 URL 长时间运行。付费操作需要密钥，可通过查询参数或 Bearer 头传递。
将密钥置于前端代码之外。浏览器预览可以直接调用免费操作，但若将密钥放置在页面源码中，任何查看页面的人都能看到。
假设一个钩子每天触发 300 次，并在每第十次发布时发起一次消耗 2 个积分的调用。这意味着 30 次付费调用，即 60 个积分，当天成本为 $0.006。
三十天内累计 1,800 个积分，即 $0.18。在选择规则前，请根据 费用明细表 自行核算用量。
索引大约每月刷新一次。上次刷新后添加的链接尚未进入数据，而自上次刷新后移除的链接可能仍会显示一段时间。
将结果视为趋势数据，并连同检查日期一起存储。这样日后就不会有人将某次读数误认为是实时数据流。
常见问题
它是一个查询接口，返回指向特定域名或页面的链接。在无头 CMS 架构中，它通常位于发布 Webhook 或 CI 步骤之后，针对每个条目运行一次，并将简短结果写回该条目。
可以。两者都可以向您的 URL 发送请求，您的函数随后使用查询字符串或 Bearer 头中的密钥调用我们的 REST API。CORS 已开放，因此浏览器端的预览也可以调用免费操作。重试机制由您负责，因此请确保处理程序具备幂等性（可安全重复执行）。
如果您仅使用免费操作，则无需额外成本。backlinks 或 refdomains 调用消耗 2 个积分，即 $0.0002。若每月发布 3,000 次，每次进行一次此类调用，总成本为 $0.60。
我们的索引大约每月刷新一次，因此新建立的链接可能会暂时缺失。请将结果视为一种趋势。如果您需要每日更新的抓取数据，Ahrefs 或 Semrush 等更全面的套件能更好地满足这一需求。
API 会返回 HTTP 402 状态码。请提前决定您的网关是“放行”还是“拦截”。我们建议对于链接检查采用放行策略：记录日志，跳过检查，让编辑器直接发布。
是的。domain、overview、stats 和 suggest 是免费的，无需 API 密钥。使用 Google 账号登录可获赠 $100 额度（无需绑定信用卡），相当于 1,000,000 个积分。无需其他操作即可开始使用。
不能。那些是功能更全面的工具，用于关键词研究、排名追踪和每日抓取。Contentin 专注于一个更细分的领域：通过 API 提供链接数据，价格低廉，并以 JSON 格式输出，方便您将其集成到工作流中。
