Google V2 SERP：Finance Quote 概览

本接口用于获取 Google Finance「Quote（报价）」标签页中的金融数据。

通过 Google V2 SERP 接口，您可以获取指定股票或金融标的的实时市场趋势、价格、表现信息以及最新财经新闻。返回结果由 keyword 字段中的股票代码或金融标的、语言和地域参数决定。

本平台会尽可能准确地模拟指定地域和搜索引擎环境，使返回结果与任务创建时对应参数下的搜索结果保持一致。您可以通过响应中的 check_url 在无痕模式下访问并核验结果。

系统不会考虑用户偏好、搜索历史及个性化因素，因此这些因素不会反映在返回的 SERP 结果中。

Google V2 SERP 功能

Advanced 接口

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

HTTP 方法： POST
用途： 返回指定股票代码或金融标的、语言和地域对应的结构化搜索结果。
适用场景： 获取 Finance Quote 页面中的市场数据、股票价格、信息和财经新闻等。

HTML 接口

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

HTTP 方法： POST
用途： 返回指定股票代码或金融标的、语言和地域对应的 Google Finance 标签页原始 HTML。

数据获取方式

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

Live 实时方式

Live 方式适用于需要立即获得结果的场景。该方式通过单次请求直接返回数据，无需分别调用任务创建和任务查询接口。

主要接口：

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

Standard 标准方式

Standard 方式适用于不要求实时返回结果的场景。相比 Live 方式，该方式成本更低，但需要分步执行：

调用任务创建接口提交任务；
等任务处理完成；
调用任务查询接口获取结果。

主要接口：

POST /v3/serp/google/v2/task_post/
GET /v3/serp/google/v2/task_get/advanced/

如果任务创建时未指定 pingback_url 或 postback_url，可以通过以下接口获取所有已完成但尚未提取的任务 ID：

Tasks Ready： 用于获取已完成任务列表
Task GET： 用于根据任务 ID 获取任务结果

回调通知

创建任务时，可以指定以下字段：

pingback_url：任务完成后通知指定地址。
postback_url：任务完成后将结果发送到指定地址。

使用 postback_url 时，还需要指定数据获取类型：

advanced
html

请求限制

平台限流以认证说明中的 30/60/120 次/分钟规则为准POST 和 GET API 请求**，两类请求合计计算。

每次 POST 请求最多 100 个任务。
如需提高调用限额，请联系平台技术支持。

优级与计费

Google V2 SERP 接口的费用取决于数据获取方式和任务执行优级。

Live 方式

Live 方式会实时返回结果，因此通常更高的调用成本。

Standard 方式

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

Normal： 普通优级，执行速度和成本较为均衡。
High： 高优级，任务处理速度更快，费用相应更高。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求示例

以下示例使用 Live Advanced 接口。POST 请求体为 JSON 数组。

cURL

bash

curl -X POST 'https://api.seermartech.cn/v3/serp/google/v2/live/advanced/' \
  -H 'Authorization: Bearer smt_live_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '[
    {
      "keyword": "AAPL",
      "location_code": 2840,
      "language_code": "en",
      "device": "desktop",
      "os": "windows"
    }
  ]'

Python

python

import requests

url = "https://api.seermartech.cn/v3/serp/google/v2/live/advanced/"

headers = {
    "Authorization": "Bearer smt_live_YOUR_KEY",
    "Content-Type": "application/json",
}

payload = [
    {
        "keyword": "AAPL",
        "location_code": 2840,
        "language_code": "en",
        "device": "desktop",
        "os": "windows",
    }
]

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

TypeScript

typescript

const response = await fetch(
  "https://api.seermartech.cn/v3/serp/google/v2/live/advanced/",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify([
      {
        keyword: "AAPL",
        location_code: 2840,
        language_code: "en",
        device: "desktop",
        os: "windows",
      },
    ]),
  }
);

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

接口路径

功能	方法	路径
实时获取结构化结果	`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/`

实用场景

监控重点股票的实时价格与市场趋势，帮助投研团队及时掌握目标标的的市场变化。
批量采集上市 Finance Quote 信息，用于构建股票数据库或企业信息看板。
跟踪指定股票的最新财经新闻，品牌、投资机构或媒体团队进行舆监测。
比较不同地域和语言环境下的金融搜索结果，支持化 SEO、海外市场研究和本地化优化。
保存 Finance Quote 原始 HTML 页面，便于后续解析页面结构、审计展示或构建自定义数据提取流程。

Google V2 SERP：Finance Quote 概览 ​

Google V2 SERP 功能 ​

Advanced 接口 ​

HTML 接口 ​

数据获取方式 ​

Live 实时方式 ​

Standard 标准方式 ​

回调通知 ​

请求限制 ​

优级与计费 ​

Live 方式 ​

Standard 方式 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

接口路径 ​

实用场景 ​