Competitor Domains
搜索竞争对手是指在某个国家和语言下,和一个网站在 Google 上为同一批关键词排名的域名,衡量它的是双方共同关键词的数量、对方在这些词上的平均排名和预估月访问量,以及它完整的自然与付费汇总、排名区间和排名变化。名单来自真实排名而不是凭印象列出的对手,所以能用来发现竞品、研究内容缺口、梳理定位,并按体量画出市场版图。
Competitor Domains API 主要特性
- 按共同排名找出对手每一行都是一个与目标在相同关键词上有排名的域名,shared_keywords_count 给出重合的关键词数;目标域名本身不会出现在名单里。
- 在重合关键词上的表现avg_position 是竞争对手在共同关键词上的平均排名,shared_keywords_traffic 是它预计每月从这些词获得的访问量。
- 每个对手的完整搜索档案organic 和 paid 两组字段给出每个竞争对手的关键词数、预估流量及其美元成本、十二个排名区间,以及新增、上升、下降、掉出的数量。
- 每个市场最多 1000 个对手results_limit 控制返回 1 到 1000 个域名,国家和语言由地区与语言参数指定,默认美国和英语。
Competitor Domains API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
target | 必填 | 要查找搜索竞争对手的域名或子域名,例如 notion.so;https:// 和 www. 会被去掉,带路径的链接会被拒绝。 |
location_code | 可选 | 搜索国家的数字代码,默认 2840(美国);与 location_name 二选一即可。 |
location_name | 可选 | 国家名称,例如 Germany 或 United States,用来代替 location_code;两者都填时必须是同一个国家。 |
language_code | 可选 | 搜索语言代码,默认 en;请选择所选国家提供的语言。 |
language | 可选 | 语言名称,例如 German 或 English,用来代替 language_code;两者都填时必须对应。 |
results_limit | 可选 | 返回的竞争域名数量,1 到 1000 之间的整数,默认 100。 |
如何使用 Competitor Domains API
提交域名、市场和 results_limit,然后读取竞争域名。
- 向 /v1/seo/competitor-domains 发送 {"target": "notion.so", "location_code": 2840, "language_code": "en", "results_limit": 100}。
- 轮询 GET /v1/tasks/{task_id},等待状态变为 succeeded。
- 从 results.items 读取竞争对手;has_more 为 true 时,用 results.next_cursor 加载后面的页。
curl -X POST "https://api.socq.ai/v1/seo/competitor-domains" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"notion.so","location_code":2840,"language_code":"en","results_limit":100}'
# 0.1 credits per competitor, at least 3 credits per request.Competitor Domains API 最佳使用场景
- 发现意料之外的竞争对手: 在 domain 列里找 shared_keywords_count 很高、又在你的竞品清单之外的网站,比如内容站、电商平台或细分工具。
- 决定先研究谁的内容: 挑出共同关键词多、avg_position 又比你靠前的对手,再拉取它们的排名关键词,找出自己还没覆盖的话题。
- 按搜索体量给市场分层: 按 organic.estimated_traffic 和 organic.keywords_count 排序,把对手分成头部、同级和小体量三档,画进市场版图。
- 看清谁在你的关键词上投广告: 筛出 paid.keywords_count 不为零的对手,再比较 paid.estimated_traffic,就知道哪些对手同时在买 Google 搜索广告。
Competitor Domains API 使用建议
- avg_position 是竞争对手自己在共同关键词上的平均排名,拿它和你的排名对比,不要当成你的排名。
- 名单里不含目标自身,所以要用同样的地区和语言再跑一次 Domain Overview API,拿到目标自己的汇总数据,放在同一把尺子上比较。
- 用 shared_keywords_traffic 除以 organic.estimated_traffic,可以看出对手的搜索流量有多大比例依赖你们共同的关键词:比例高是正面对手,比例低则是只沾到你这个话题的综合型网站。
相关 API
除了 Competitor Domains API,需要其他类型的 SEO 公开数据时,可以使用以下 API。
- Google Organic SERP API — 按一个 query 和市场获取实时 Google 结果页,返回标准化目标地址、排名、元素类型和完整结果详情。
- Keyword Difficulty API — 比较一批输入关键词的自然排名难度,为每个有可用数据的关键词返回标准化分数。
- Keyword Overview API — 为一批输入关键词补充可用的需求、付费竞争、难度、月度搜索和搜索意图信息。
- Ranked Keywords API — 查找域名、子域名或页面已有排名的关键词,返回匹配 URL、位置、搜索指标、意图和完整来源元素。
- Domain Overview 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