Google 数据概览 API：概览

本组接口采用 POST 方法，通过即时返回模式获取 Google 搜索数据。 API 路径格式为：

text

POST /v3/dataforseo_labs/google/{endpoint}/live/

请求体使用 JSON 数组格式，例如：

json

[
  {
    "target": "example.com",
    "language_code": "zh_CN",
    "location_code": 203
  }
]

请求时请在 Authorization 请求头中使用 API 密钥：

http

Authorization: Bearer smt_live_YOUR_KEY

Google 接口基于本平台维护的 Google SERP 数据库、数据库和域名数据库，适用于研究、搜索分析、竞争对手研究及市场细分分析。数据库 48 亿条记录。

研究

用于挖掘机会、识别搜索趋势和评估竞争。

Keywords For Site：获取与目标域名的。
Related Keywords：获取 Google SERP“搜索”区域中的。
Keyword Suggestions：获取在指定种子前后或添加词语后形成的建议。
Keyword Ideas：获取与指定种子属于同一类别的创意。
Bulk Keyword Difficulty：批量评估自然搜索结果前 10 名的难度。
Search Intent：批量获取最多 1,000 个的搜索意图。
Keyword Overview：获取当前 CPC、付费搜索竞争度、搜索量、搜索意图、SERP 及外链数据。
Historical Keyword Data：获取自 2019 年初以来的搜索量及历史指标。

市场细分分析

基于 Google Ads 的市场类别，获取创意、排名和流量数据。

Categories For Domain：获取目标域名涉及的市场类别，以及各类别的总体排名和流量数据。
Keywords For Categories：获取指定类别的上月搜索量、过去 12 个月的搜索量趋势、当前 CPC 和竞争度。
Domain Metrics By Categories：获取按类别划分的历史排名、当前及历史 ETV、展示 ETV、预估付费流量成本等指标。
Top Searches：获取热门搜索词、Google Ads 指标、产品类别及 Google SERP 数据。

竞争对手研究

用于获取任意网站的、排名和搜索流量数据。

Ranked Keywords：获取指定域名或 URL 在 SERP 中获得排名的。
SERP Competitors：识别 SERP 竞争对手及在指定上的排名。
Competitors Domain：获取竞争域名在自然搜索和付费搜索中的排名及流量概览。
Domain Intersection：获取两个指定域名在相同 SERP 中同时排名的。
Subdomains：获取目标域名的子域名，以及这些子域名在自然搜索和付费搜索中的排名分布。
Relevant Pages：获取指定域名的页面及排名和流量数据。
Domain Rank Overview：获取指定域名在自然搜索和付费搜索中的排名及流量数据。
Historical SERPs：获取指定日期范围的历史 SERP 完整概览精选摘要及特殊搜索结果。
Historical Rank Overview：获取指定域名在自然搜索和付费搜索中的历史排名与流量数据。
Page Intersection：获取多个指定页面在相同 SERP 中同时排名的。
Bulk Traffic Estimation：批量估算最多 1,000 个域名的月度流量。

请求方式与限制

本组接口支持 Live 数据获取方式，不需要提交任务、再通过 GET 请求查询结果。接口会直接返回即时结果。

调用限制如下：

每分钟最多发送 2,000 次 API 请求。
同时进行的请求数量最多为 30 个。
如需提高调用频率限制，请联系本平台技术支持。

cURL 请求示例

bash

curl --request POST \
  --url https://api.seermartech.cn/v3/dataforseo_labs/google/keyword_overview/live/ \
  --header 'Authorization: Bearer smt_live_YOUR_KEY' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "keywords": ["seo", "研究"],
      "language_code": "zh_CN",
      "location_code": 203
    }
  ]'

Python 请求示例

python

import requests

url = "https://api.seermartech.cn/v3/dataforseo_labs/google/keyword_overview/live/"
headers = {
    "Authorization": "Bearer smt_live_YOUR_KEY",
    "Content-Type": "application/json",
}
payload = [
    {
        "keywords": ["seo", "研究"],
        "language_code": "zh_CN",
        "location_code": 203,
    }
]

response = requests.post(url, headers=headers, json=payload)
print(response.json())

TypeScript 请求示例

typescript

const response = await fetch(
  "https://api.seermartech.cn/v3/dataforseo_labs/google/keyword_overview/live/",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify([
      {
        keywords: ["seo", "研究"],
        language_code: "zh_CN",
        location_code: 203,
      },
    ]),
  }
);

const result = await response.json();
console.log(result);

计费说明

本页未提供统一固定单价。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

账户余额及调用消耗可通过以下接口查询：

User Data

开发测试可使用沙盒环境：

Sandbox

实用场景

挖掘目标网站尚未覆盖的，扩展选题和 SEO 词库。
评估批量的搜索量、搜索意图和排名难度，确定生产与优化优级。
对比自身域名与竞争域名的交集，发现竞争对手已获得排名而自身缺失的机会词。
追踪目标域名的历史排名与流量变化，分析 SEO 项目阶段性效果及流量波动原因。
估算多个竞品网站的月度自然搜索流量，为市场规模评估、竞品分析和预算规划提供依据。

Google 数据概览 API：概览 ​

研究 ​

市场细分分析 ​

竞争对手研究 ​

请求方式与限制 ​

cURL 请求示例 ​

Python 请求示例 ​

TypeScript 请求示例 ​

计费说明 ​

实用场景 ​