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
提交域名和市场,任务完成后读取一行概览数据。
- 向 /v1/seo/domain-overview 发送 {"target": "notion.so", "location_code": 2840, "language_code": "en"}。
- 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
- 从 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,它按页面给出排名分布。
相关 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 自然与付费月访问量和关键词数量。
- Keyword Search Volume API
- Keywords for Site API
- Keyword Suggestions API
- Related Keywords API
- Relevant Pages API
- Search Intent API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API