seo/
domain-overview

按一个国家和语言获取域名在 Google 的自然与付费搜索汇总,返回排名关键词数、预估月流量和对应广告成本、排名区间分布以及排名变化。

Domain Overview API

自然与付费汇总
第 1–100 名区间
按国家和语言
每次请求 5 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

Domain Overview

一个域名的搜索盘面,是它在某个国家和语言的 Google 结果里的整体表现:有排名的关键词数、这些排名预计带来的月访问量、这些流量换成广告要花多少钱,按自然和付费拆开,再分摊到第 1 到 100 名的各个区间,并附上新增、上升、下降和掉出排名的数量。一行汇总就能估出竞品体量、按搜索表现筛选潜在客户,按月保存下来还能跟踪自己站点的可见度走势。

Domain Overview API 主要特性

  • 一个域名,一个 Google 市场target 填域名,地区和语言参数决定看哪个国家、哪种语言的搜索结果,默认美国和英语;结果会带回 location_code 和 language_code,存档时不会混淆市场。
  • 自然与付费结构一致organic 和 paid 两组汇总字段完全相同,免费排名和搜索广告可以逐项对照。
  • 流量连同广告价值keywords_count 是有排名的关键词数,estimated_traffic 是它们带来的预估月访问量,estimated_traffic_cost 按 Google Ads 价格把这部分流量折算成美元。
  • 十二个排名区间positions 把有排名的关键词分进 pos_1、pos_2_3、pos_4_10,一直到 pos_91_100,能看出域名是占住了首页还是排在更靠后的位置。
  • 自上次更新以来的排名变动new_count、up_count、down_count 和 lost_count 分别统计自上次数据更新以来新进入、上升、下降和掉出排名的关键词数量。

Domain Overview API 参数

参数必填描述
target必填要分析的域名或子域名,例如 notion.so;https:// 和 www. 会被去掉,带路径的链接会被拒绝。
location_code可选搜索国家的数字代码,例如美国为 2840,也是默认值。与 location_name 二选一。
location_name可选国家名称,例如 United States,可代替 location_code;两者同时填写时必须指向同一个国家。
language_code可选语言代码,例如默认的 en;必须是所选国家可用的语言之一。
language可选语言名称,例如 English,可代替 language_code;两者同时填写时必须一致。

如何使用 Domain Overview API

提交域名和市场,任务完成后读取一行概览数据。

  1. 向 /v1/seo/domain-overview 发送 {"target": "notion.so", "location_code": 2840, "language_code": "en"}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
  3. 从 results.items 读取这一行概览;只有 has_more 为 true 时才需要用到 results.next_cursor。
curl -X POST "https://api.socq.ai/v1/seo/domain-overview" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"notion.so","location_code":2840,"language_code":"en"}'

# One market per request, 5 credits.

Domain Overview API 最佳使用场景

  • 估算竞品的搜索体量: 看 organic.keywords_count 和 organic.estimated_traffic,就知道对手通过 Google 已经覆盖了这个市场的多大一块。
  • 按月跟踪自己的可见度: 每月保存 positions 各区间以及新增、上升、下降、掉出的数量,画出排名是否在往首页靠拢。
  • 筛选代理业务的潜在客户: 把 organic.estimated_traffic_cost 当作对方搜索流量值多少钱的美元数字,决定优先跟进哪些客户。
  • 确认一个网站有没有投搜索广告: paid.keywords_count 和 paid.estimated_traffic 说明该域名在这个市场是否投放 Google 搜索广告,以及广告带来多少流量。
  • 比较同一网站在不同国家的表现: 用同一个域名搭配不同的地区和语言参数分别提交,看它在哪些市场最强。

Domain Overview API 使用建议

  • 所选国家不提供英语时,要自己填 language_code 或 language,因为默认的 en 只在该国家可用语言里有英语时才会被接受。
  • 把 pos_1、pos_2_3 和 pos_4_10 相加就是首页关键词数,各区间互不重叠,可以直接相加。
  • 新增、上升、下降、掉出这几项是相对上一次数据更新的变化,而不是相对你上一次请求;每行连同 collected_at 一起存下来,才能攒出自己的历史曲线。
  • 提交裸域名即可;要看站内单个页面的数据,改用 Relevant Pages API,它按页面给出排名分布。

除了 Domain Overview API,需要其他类型的 SEO 公开数据时,可以使用以下 API。

  • Google Organic SERP API — 按一个 query 和市场获取实时 Google 结果页,返回标准化目标地址、排名、元素类型和完整结果详情。
  • Keyword Difficulty API — 比较一批输入关键词的自然排名难度,为每个有可用数据的关键词返回标准化分数。
  • Keyword Overview API — 为一批输入关键词补充可用的需求、付费竞争、难度、月度搜索和搜索意图信息。
  • Ranked Keywords API — 查找域名、子域名或页面已有排名的关键词,返回匹配 URL、位置、搜索指标、意图和完整来源元素。
  • Competitor Domains API — 找出在同一市场与某个网站争夺相同 Google 关键词的域名,返回共同关键词数、平均排名、重合流量和完整搜索数据。
  • Traffic Estimate API — 一次估算最多 1000 个域名在同一市场的 Google 自然与付费月访问量和关键词数量。

探索其他平台

还可以将 SEO 数据与其他已支持社交平台的公开数据结合使用。

Domain Overview API — 常见问题

Domain Overview API 是一个用于读取域名在指定国家和语言下 Google 搜索汇总数据的 API。它返回自然与付费两组关键词数、预估月流量及其广告成本、各排名区间的关键词数,以及新增、上升、下降和掉出排名的数量。

它查的是搜索流量:estimated_traffic 是域名在所选市场预计每月从 Google 结果获得的访问量,自然结果和付费结果分开给出。

用 location_code 或 location_name 指定国家,用 language_code 或 language 指定语言,语言必须是该国家提供的语言之一。都不填时默认美国和英语。

它是用 Google Ads 买到同样流量预计每月要花的美元金额,可以把自然搜索的可见度换算成能直接比较的金额。

每次请求查一个域名。要对一长串域名比较流量和关键词数,可以用 Traffic Estimate API,一次最多 1000 个域名。

每次请求固定计 5 积分,覆盖一个域名在一个市场的数据。