Google Finance Markets SERP：概览

本接口用于获取 Google Finance「Markets」标签页中的市场数据。主要实时接口为 POST /v3/serp/google/v2/live/advanced/ 和 POST /v3/serp/google/v2/live/html/；异步标准接口 POST /v3/serp/google/v2/task_post/ 与 GET /v3/serp/google/v2/task_get/advanced/。返回结果取决于请求中指定的地区、语言和 market_type 参数。

通过本接口，您可以获取实时市场趋势、股票价格、表现信息以及最新财经新闻等数据。

数据范围

本平台会尽可能准确地模拟请求中指定的地区和搜索引擎环境，使返回结果与任务创建时对应参数下的搜索结果保持一致。

响应中通常会提供 check_url。您可以在无痕模式下访问该地址，对检查返回数据是否符合预期。

以下个性化因素不会影响本平台返回的 SERP 结果：

用户偏好
搜索历史
个性化搜索因素

请求结果主要由以下参数决定：

location：搜索地区
language：搜索语言
market_type：市场类型

Google V2 SERP 接口

Advanced 接口

POST /v3/serp/google/v2/live/advanced/

返回指定地区、语言和 market_type 下的结构化 Google Finance Markets 搜索结果市场、股票及财经信息。

HTML 接口

POST /v3/serp/google/v2/live/html/

返回指定地区、语言和 market_type 对应的 Google Finance 标签页原始 HTML。

数据获取方式

本平台提供两种 SERP 数据获取方式：Live 实时方式和Standard 标准方式。

Live 实时方式

Live 方式适用于需要即时获取结果的场景。提交请求后，接口会直接返回处理结果，无需分别调用任务创建和任务查询接口。

接口：

POST /v3/serp/google/v2/live/advanced/：获取结构化结果
POST /v3/serp/google/v2/live/html/：获取原始 HTML

示例：

bash

curl --request POST \
  --url https://api.seermartech.cn/v3/serp/google/v2/live/advanced/ \
  --header 'Authorization: Bearer smt_live_YOUR_KEY' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "location_code": 2840,
      "language_code": "en",
      "market_type": "stocks"
    }
  ]'

Standard 标准方式

Standard 方式适用于不要求实时返回结果的场景。该方式需要分两步完成：

调用任务创建接口提交任务；
调用任务获取接口读取已完成任务的结果。

接口：

POST /v3/serp/google/v2/task_post/：创建 SERP 任务
GET /v3/serp/google/v2/task_get/advanced/：获取结构化任务结果

Standard 方式通常比 Live 方式更经济。系统完成数据采集后，您可以读取对应任务的结果。

回调获取结果

创建任务时，可以指定以下回调地址：

pingback_url：任务完成后接收完成通知
postback_url：任务完成后接收结果

如果使用 postback_url，还需要指定要返回的数据类型或处理函数：

advanced
html

如果使用 Standard 方式时未设置 pingback_url 或 postback_url，可以通过 Tasks Ready 接口获取所有已完成但尚未读取的任务 ID，然后使用 Task GET 接口获取任务结果。

请求限制

当前接口的调用限制如下：

平台限流以认证说明中的 30/60/120 次/分钟规则为准- 每个 POST 请求最多 100 个任务

如需提高调用限制，请联系平台技术支持。

任务优级与计费

Google V2 SERP 接口的费用取决于以下因素：

所选数据获取方式
任务执行优级

Live 方式

Live 方式实时返回结果，因此通常对应更高的调用费用。

Standard 方式

Standard 方式支持两种任务优级：

Normal：普通优级
High：高优级

不同优级对应不同的执行速度和费用。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

认证方式

请求时使用 Bearer Token 认证：

http

Authorization: Bearer smt_live_YOUR_KEY

接口

功能	方法	路径
实时获取结构化结果	POST	`/v3/serp/google/v2/live/advanced/`
实时获取原始 HTML	POST	`/v3/serp/google/v2/live/html/`
创建标准任务	POST	`/v3/serp/google/v2/task_post/`
获取结构化任务结果	GET	`/v3/serp/google/v2/task_get/advanced/`

实用场景

监控目标市场的实时股票表现：按地区、语言和市场类型定期采集股票价格及涨跌信息，为投研看板和市场监测提供数据支持。
分析 Google Finance 市场趋势：获取 Markets 标签页中的市场板块和趋势数据，发现行业变化及潜在投资机会。
追踪上市表现信息：采集与表现数据，用于竞品研究、行业排名和企业报分析。
聚合最新财经新闻线索：从指定市场结果中提取财经信息，支持新闻聚合、舆监测和选题。
验证不同地区的金融搜索结果差异：使用不同 location、language 和 market_type 参数对比 SERP 展示，为化金融 SEO 和区域市场研究提供依据。

Google Finance Markets SERP：概览 ​

数据范围 ​

Google V2 SERP 接口 ​

Advanced 接口 ​

HTML 接口 ​

数据获取方式 ​

Live 实时方式 ​

Standard 标准方式 ​

回调获取结果 ​

请求限制 ​

任务优级与计费 ​

Live 方式 ​

Standard 方式 ​

认证方式 ​

接口 ​

实用场景 ​