Google Finance 证券代码搜索 SERP：概览

本接口用于检索 Google Finance 中可用的金融信息。实时查询使用 POST /v3/serp/google/finance_ticker_search/live/advanced/；标准异步查询通过 POST /v3/serp/google/finance_ticker_search/task_post/ 创建任务，再使用 GET /v3/serp/google/finance_ticker_search/task_get/advanced/ 获取结果。

通过指定名称、市场名称或金融名称，本接口可返回的股票、期货、资产货币对等金融列表，以及价格、涨跌趋势和标识符等附加数据。

返回结果由 keyword、语言和地区参数决定。本平台会按指定地区和搜索环境模拟查询，以尽可能匹任务创建时对应参数下的结果。可在浏览器无痕模式中访问响应中的 check_url 核验结果性。

> 系统不会纳用户偏好、搜索历史等个性化因素，因此返回结果不个性化搜索影响。

金融结果中返回的标识符可作为 keyword 参数，用于提交 Google Finance 报价查询请求：

POST /v3/serp/google/finance_quote/live/advanced/

功能说明

高级实时查询

POST /v3/serp/google/finance_ticker_search/live/advanced/

根据 keyword、语言和地区，实时搜索 Google Finance 中的金融。

适用于需要在一次请求中立即获得结果的场景，无需创建任务后再单独获取结果。

标准异步查询

标准方式以下两个步骤：

使用 POST /v3/serp/google/finance_ticker_search/task_post/ 提交查询任务。
在任务完成后，使用 GET /v3/serp/google/finance_ticker_search/task_get/advanced/ 获取查询结果。

标准方式适合对实时性要求不高、希望降低查询成本的批量任务场景。

数据获取方式

实时方式（Live）

实时方式会在请求处理完成后直接返回结果。

接口：POST /v3/serp/google/finance_ticker_search/live/advanced/
特点：即时返回结果
适用场景：搜索、用户侧交互查询、实时金融实体匹
计费特点：通常高于标准异步方式
实扣费以响应头 X-SeerMarTech-Charge-CNY 为准

标准方式（Standard）

标准方式创建任务，平台完成数据采集后再获取结果。

创建任务：POST /v3/serp/google/finance_ticker_search/task_post/
获取结果：GET /v3/serp/google/finance_ticker_search/task_get/advanced/
特点：异步处理，适合批量请求
支持优级：
1. 普通优级（Normal）
2. 高优级（High）
实扣费以响应头 X-SeerMarTech-Charge-CNY 为准

任务完成通知

使用标准方式创建任务时，可通过以下字段接收任务完成通知：

字段	说明
`pingback_url`	任务完成后，平台向指定 URL 发送完成通知。收到通知后，需调用 Task GET 接口获取结果。
`postback_url`	任务完成后，平台将结果直接推送至指定 URL。使用该字段时，还指定数据返回格式对应的功能类型：`advanced` 或 `html`。

如果未设置 pingback_url 和 postback_url，可通过“Tasks Ready”接口获取尚未领取结果的已完成任务 ID 列表，再调用 Task GET 接口获取每个任务的结果。

请求限制

限制项	说明
API 调用频率平台限流以认证说明中的 30/60/120 次/分钟规则为准/分钟
单次 POST 任务数	每次 POST 请求最多可 100 个任务

请求认证

所有请求均应在请求头中携带 Bearer Token：

http

Authorization: Bearer smt_live_YOUR_KEY

请求示例

实时查询金融

bash

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

Python 示例

python

import requests

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

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

# POST 请求体为 JSON 数组
payload = [
    {
        "keyword": "Apple",
        "language_code": "en",
        "location_code": 2840,
    }
]

response = requests.post(url, headers=headers, json=payload, timeout=60)
response.raise_for_status()

# 从响应头读取本次请求的人民币扣费
charge_cny = response.headers.get("X-SeerMarTech-Charge-CNY")
print("扣费（CNY）：", charge_cny)
print(response.json())

TypeScript 示例

typescript

const url =
  "https://api.seermartech.cn/v3/serp/google/finance_ticker_search/live/advanced/";

const response = await fetch(url, {
  method: "POST",
  headers: {
    Authorization: "Bearer smt_live_YOUR_KEY",
    "Content-Type": "application/json",
  },
  // POST 请求体为 JSON 数组
  body: JSON.stringify([
    {
      keyword: "Apple",
      language_code: "en",
      location_code: 2840,
    },
  ]),
});

if (!response.ok) {
  throw new Error(`请求失败：${response.status} ${response.statusText}`);
}

// 从响应头读取本次请求的人民币扣费
console.log(
  "扣费（CNY）：",
  response.headers.get("X-SeerMarTech-Charge-CNY"),
);

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

实用场景

检索上市证券代码：根据名称匹股票及交易所标识符，为证券搜索、投资组合管理或展示提供标准化代码。
识别同名金融资产：结合地区、语言和市场信息区分名称相同的股票、期货或资产对，降低金融实体匹错误率。
构建报价查询链路：搜索金融并获取标识符，再将标识符用于 Google Finance 报价查询，实现从名称搜索到获取的自动化流程。
监测金融趋势信息：获取金融的价格与涨跌趋势数据，为选题、财经 SEO 页面和市场观察模块提供数据支持。
批量补证券主数据：使用标准异步方式批量提交或资产名称，补证券代码、市场归属及类型等主数据字段。

Google Finance 证券代码搜索 SERP：概览 ​

功能说明 ​

高级实时查询 ​

标准异步查询 ​

数据获取方式 ​

实时方式（Live） ​

标准方式（Standard） ​

任务完成通知 ​

请求限制 ​

请求认证 ​

请求示例 ​

实时查询金融 ​

Python 示例 ​

TypeScript 示例 ​

实用场景 ​