Traffic Estimate
搜索流量估算给出一个网站每月从某个国家和语言的 Google 结果获得多少访问,分成自然访问和付费访问两部分,分别附上该网站有自然排名的关键词数和投放广告的关键词数。把几百个域名的这四个数字排在一起,就能按体量给潜在客户和合作方排序、补全客户资料,或者把整个品类的竞争对手放在一张表里比较。
Traffic Estimate API 主要特性
- 一次请求最多 1000 个域名targets 接受最多 1000 个域名的列表,每个域名各自返回一行,以 domain 作为标识。
- 每个域名四个数字organic_traffic 和 organic_keywords_count 衡量免费搜索带来的访问量和排名关键词,paid_traffic 和 paid_keywords_count 衡量搜索广告带来的访问量和投放关键词。
- 整批共用一个市场地区和语言参数为列表里的每个域名指定同一个 Google 国家和语言,默认美国和英语。
Traffic Estimate API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
targets | 必填 | 要估算的域名,最多 1000 个,例如 notion.so 或 figma.com,每行一个或用逗号分隔;https:// 和 www. 会被去掉。 |
location_code | 可选 | Google 国家的数字代码,作用于列表中所有域名;默认 2840(美国)。与 location_name 二选一。 |
location_name | 可选 | 国家名称,例如 United States,可代替 location_code;两者都填时必须指同一个国家。 |
language_code | 可选 | 搜索市场的语言代码,默认 en;必须是所选国家可用的语言。 |
language | 可选 | 语言名称,例如 English,可代替 language_code;两者都填时必须一致。 |
如何使用 Traffic Estimate API
提交域名列表和市场,每个域名读取一行流量数据。
- 向 /v1/seo/traffic-estimate 发送 {"targets": ["notion.so", "figma.com", "canva.com"], "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/traffic-estimate" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"targets":["notion.so","figma.com","canva.com"],"location_code":2840,"language_code":"en"}'
# 3 credits per request plus 0.1 per domain in targets.Traffic Estimate API 最佳使用场景
- 按搜索流量给潜在客户排序: 提交销售或合作名单,按 organic_traffic 排序,把搜索受众最多的网站排到最前面。
- 补全 CRM 客户资料: 把 organic_traffic 和 organic_keywords_count 写进每个客户的网站字段,销售就能按搜索体量给客户分组。
- 给整个品类做基准对比: 一次估算某个市场里的所有品牌,比较 organic_traffic 和 organic_keywords_count,看谁在这个品类的搜索体量最大。
- 从名单里找出投搜索广告的网站: 筛出 paid_keywords_count 大于零的行,再按 paid_traffic 排序,就能找到已经在买 Google 搜索广告的域名。
Traffic Estimate API 使用建议
- 提交前先清洗名单,只保留裸域名或站点根地址:只要有一条带路径或格式不对,整个请求都会被拒绝。
- example.com 和 www.example.com 这类重复项要先去掉:它们会合并成一行结果,但列表里的每一项都会按域名计费。
- 按 domain 字段把结果对回原名单,返回行的顺序可能与 targets 不同,按字段对应最稳妥。
- 名单涉及多个国家时,按市场拆开分别提交,因为地区和语言参数作用于同一请求里的所有域名。
- 名单缩小到几个重点域名后,如果还需要排名区间、流量价值和排名变化,再逐个用 Domain Overview API 查询。
相关 API
除了 Traffic Estimate API,需要其他类型的 SEO 公开数据时,可以使用以下 API。
- Google Organic SERP API — 按一个 query 和市场获取实时 Google 结果页,返回标准化目标地址、排名、元素类型和完整结果详情。
- Keyword Difficulty API — 比较一批输入关键词的自然排名难度,为每个有可用数据的关键词返回标准化分数。
- Keyword Overview API — 为一批输入关键词补充可用的需求、付费竞争、难度、月度搜索和搜索意图信息。
- Domain Overview API — 获取一个域名在指定国家和语言下的 Google 自然与付费搜索汇总,包括排名关键词数、预估流量及广告成本、排名区间和排名变化。
- Competitor Domains API — 找出在同一市场与某个网站争夺相同 Google 关键词的域名,返回共同关键词数、平均排名、重合流量和完整搜索数据。
- Domain Technologies API — 按域名识别网站使用的技术,返回技术类别、权威评分、社交主页和公开的联系方式。
- Keyword Search Volume API
- Keywords for Site API
- Keyword Suggestions API
- Ranked Keywords API
- Related Keywords API
- Relevant Pages API
- Search Intent API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API