Referring Domains
引用域名是链接到某个域名或页面的不同网站,每个网站只计一次,并带有权威评分、贡献的外链数和链接页面数、其中 nofollow 或指向失效页面的数量、垃圾分数,以及开始链接和撤掉链接的时间。按站点而不是按单条链接来数,最能公平地衡量链接受欢迎程度,外联名单、外链缺口对比、得失链接站点的报告都以这份数据为底。
Referring Domains API 主要特性
- 每个链接域名占一行每一行是一个链接到目标域名、子域名或页面的网站,哪怕某个博客给你放了 300 条链接也只出现一次;results_limit 控制返回 1 到 1000 个。
- 每个域名链接得有多深backlinks_count 和 referring_pages_count 说明该域名贡献了多少条链接、多少个页面,nofollow_referring_pages_count 和 broken_backlinks_count 说明其中多少是 nofollow、多少落在失效页面上。
- 逐站点的质量信号rank 是链接域名 0 到 1000 的权威分,spam_score 是 0 到 100 的垃圾分数,长名单不用逐个打开就能先排一遍序。
- 链接关系的起止时间first_seen_at 记录首次发现该域名链接的时间,lost_at 记录它不再链接的时间,链接仍然有效时为空。
Referring Domains API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
target | 必填 | 要查询引用域名的域名、子域名或完整页面链接,例如 notion.so 或 https://example.com/pricing。 |
results_limit | 可选 | 返回的引用域名数量,1 到 1000 之间的整数,默认 100。 |
如何使用 Referring Domains API
提交 target 和 results_limit,再一页一页取回引用域名。
- 向 /v1/seo/referring-domains 发送 {"target": "notion.so", "results_limit": 100},保存 task_id。
- 轮询 GET /v1/tasks/{task_id},status 为 succeeded 时域名列表就绪。
- 从 results.items 逐个读取域名;has_more 为 true 时,用 results.next_cursor 请求下一页。
curl -X POST "https://api.socq.ai/v1/seo/referring-domains" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"notion.so","results_limit":100}'
# Poll GET /v1/tasks/{task_id} for the linking domains.Referring Domains API 最佳使用场景
- 从竞品身上整理外联名单: 用竞品域名查询,留下 rank 高、spam_score 低的行,再去联系这些域名背后的网站。
- 对比两个站点的外链缺口: 分别拉取自己和竞品的引用域名,对比 domain 列,找出只链接竞品、没链接你的网站。
- 汇报流失的链接站点: 筛出 lost_at 有值的行并按 rank 排序,看清哪些有分量的网站在什么时候撤掉了链接。
- 排查在大量页面重复出现的链接: 按 referring_pages_count 排序,找出从成百上千个页面链过来的域名,例如页脚、侧栏或友情链接位,再逐个复核。
Referring Domains API 使用建议
- nofollow_referring_pages_count 等于 referring_pages_count 时,说明该域名上所有链接页面都是 nofollow,可以用这个条件区分传递权重和不传递权重的域名。
- 某个域名的 broken_backlinks_count 大于 0 时,用 Backlinks API 查同一个 target,找出具体失效的 target_url,再做重定向。
- 大批量拉取前先用 Backlinks Summary API 看一下 referring_domains_count:一次请求最多返回 1000 个域名,外链规模更大的站点只能覆盖其中一部分。
相关 API
除了 Referring Domains API,需要其他类型的 SEO 公开数据时,可以使用以下 API。
- Google Organic SERP API — 按一个 query 和市场获取实时 Google 结果页,返回标准化目标地址、排名、元素类型和完整结果详情。
- Keyword Difficulty API — 比较一批输入关键词的自然排名难度,为每个有可用数据的关键词返回标准化分数。
- Keyword Overview API — 为一批输入关键词补充可用的需求、付费竞争、难度、月度搜索和搜索意图信息。
- Backlinks Summary API — 用一行数据汇总一个域名、子域名或页面的外链概况,包括权威评分、外链与引用域名总数、垃圾分数和外链来源分布。
- Backlinks API — 按权重从高到低逐条列出指向域名或页面的最多 1000 条外链,附来源页面、锚文本、dofollow 状态、权威分以及首次和最近发现时间。
- Backlink Competitors API — 找出与某个站点或页面共享最多引用域名的网站,按共享数量排序并附权威评分。
- Keyword Search Volume API
- Keywords for Site API
- Keyword Suggestions API
- Ranked Keywords API
- Related Keywords API
- Relevant Pages API
- Search Intent API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API