SeerMarTech API 文档

主题

Google Finance 股票代码搜索（实时高级版） ​

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

本接口使用 POST 方法，请求路径为：

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

实时查询 Google Finance 中可用的金融及详细信息。查询结果由以下请求参数决定：keyword（或金融名称）、搜索地区和搜索语言。本接口每次请求支持提交一个任务。

计费说明 ​

每次成功提交请求都会产生费用。参考价约 ¥0.0144 / 次。

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

所有 POST 数据使用 UTF-8 编码的 JSON 格式，并将任务参数放 JSON 数组中。平台限流以认证说明中的 30/60/120 次/分钟规则为准；每次 Live SERP API 请求只能一个任务。

请求参数 ​

###填参数

参数类型说明
keywordstring或金融名称。填。用于搜索股票代码或金融。最多支持 700 个字符。请求中的百分号编码会被解析，字符 + 会被解码为空格。若中需要使用 %，请编码为 %25；若需要使用 +，请编码为 %2B。
location_codeinteger搜索引擎地区代码。当未指定 location_name 时填。指定此参数后无需再指定 location_name。可通过 /v3/serp/google/locations 获取可用地区及代码。例如：2840。
language_codestring搜索引擎语言代码。当未指定 language_name 时填。指定此参数后无需再指定 language_name。可通过 /v3/serp/google/languages 获取可用语言及代码。例如：en。

> location_code 与 location_name 至少指定一个；language_code 与 language_name 至少指定一个。

可选参数 ​

参数类型说明
location_namestring搜索引擎地区的完整名称。当未指定 location_code 时填。指定此参数后无需再指定 location_code。例如：London,England,United Kingdom。可通过 /v3/serp/google/locations 获取可用地区名称。
language_namestring搜索引擎语言的完整名称。当未指定 language_code 时填。指定此参数后无需再指定 language_code。例如：English。可通过 /v3/serp/google/languages 获取可用语言名称。
tagstring用户自定义任务标识。可选，最多 255 个字符。可用于识别任务并与响应结果进行匹。提交的值会原样返回在响应任务的 data 对象中。
categorystring要搜索的金融类别。可选。可选值：all、stock、index、mutual_fund、currency、futures。默认值：all。

请求示例 ​

cURL ​

bash
curl --location --request POST \
  "https://api.seermartech.cn/v3/serp/google/finance_ticker_search/live/advanced" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '[
    {
      "keyword": "DJ",
      "location_code": 2840,
      "language_name": "English",
      "category": "all"
    }
  ]'

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",
}

# 每次请求只能提交一个任务
payload = [
    {
        "keyword": "DJ",
        "location_code": 2840,
        "language_name": "English",
        "category": "all",
    }
]

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

if result.get("status_code") == 20000:
    print(result)
else:
    print(
        "请求失败，错误码：{}，错误信息：{}".format(
            result.get("status_code"),
            result.get("status_message"),
        )
    )

TypeScript ​

typescript
import axios from "axios";

const response = await axios.post(
  "https://api.seermartech.cn/v3/serp/google/finance_ticker_search/live/advanced",
  [
    {
      keyword: "DJ",
      location_code: 2840,
      language_name: "English",
      category: "all",
    },
  ],
  {
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
  }
);

const result = response.data;

if (result.status_code === 20000) {
  console.log(result);
} else {
  console.error(
    `请求失败，错误码：${result.status_code}，错误信息：${result.status_message}`
  );
}

响应结构 ​

接口返回 JSON 数据，主要 tasks 任务数组。

顶层字段 ​

字段类型说明
versionstring当前 API 版本。
status_codeinteger通用响应状态码。详细错误码请参考错误码文档。
status_messagestring通用响应说明。
timestring请求执行耗时，单位为秒。
costfloat平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
tasks_countintegertasks 数组中的任务数量。
tasks_errorintegertasks 数组中返回错误的任务数量。
tasksarray任务结果数组。

任务字段 ​

字段类型说明
idstring任务唯一标识，UUID 格式。
status_codeinteger任务状态码，通常位于 10000–60000 范围。
status_messagestring任务状态说明。
timestring任务执行耗时，单位为秒。
costfloat平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
result_countintegerresult 数组中的数量。
patharray请求 URL 路径。
dataobject创建任务时提交的参数。
resultarray当前任务的查询结果。

结果字段 ​

字段类型说明
keywordstring请求中提交的。返回时会对百分号编码进行解码，字符 + 会被解码为空格。
typestring搜索引擎类型。本接口固定为 finance_ticker_search。
se_domainstring请求中使用的搜索引擎域名。
location_codestring请求中使用的地区代码。
language_codestring请求中使用的语言代码。
check_urlstring搜索引擎结果页的直接 URL，可用于核验返回结果。
datetimestring获取结果的时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00。例如：2019-11-15 12:57:46 +00:00。
spellobject搜索引擎自动纠错信息。如果搜索引擎对进行了纠正，将返回纠正后的及纠错类型。
refinement_chipsobject搜索细化选项。本接口中通常为 null。
item_typesarraySERP 中的结果类型。可能：google_finance_market_index、google_finance_asset_pair、google_finance_market_instrument。
se_results_countintegerSERP 中结果总数。
items_countintegeritems 数组中的结果数量。
itemsarraySERP 中返回的金融结果项目。

金融结果项目 ​

items 数组中的项目根据 type 区分为以下三类。

google_finance_market_index ​

表示市场指数项目。

字段类型说明
typestring固定为 google_finance_market_index。
rank_groupinteger组排名。在相同 type 的项目之间计算排名。
rank_absoluteintegerSERP 中的绝对排名。
tickerstring市场指数代码。例如：DAX。
market_identifierstring市场标识。例如：INDEXDB。
index_valuefloat指定时间点的市场指数值。
index_value_deltafloat指定时间点市场指数值的变化量。
identifierstring项目完整标识，由 ticker 和 market_identifier 组成。例如：PX1:INDEXDB。
displayed_namestringGoogle Finance 展示的市场指数名称。例如：CAC 40。
urlstringGoogle Finance 市场指数页 URL。
locationstring市场指数所在地区。例如：Europe/Paris。
trendstring市场指数趋势。可选值：up、down、stable。
timestampstring指数值的读取时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00。
percentage_deltafloat市场指数值的百分比变化。

google_finance_asset_pair ​

表示资产交易对项目，例如货币对。

字段类型说明
typestring固定为 google_finance_asset_pair。
rank_groupinteger组排名。在相同 type 的项目之间计算排名。
rank_absoluteintegerSERP 中的绝对排名。
base_symbolstring交易对基础资产代码。例如：EUR。
quote_symbolstring交易对报价资产代码。例如：USD。
base_display_namestring基础资产完整名称。例如：Euro。
quote_display_namestring报价资产完整名称。
pricefloat基础资产相对于报价资产的价格。
price_deltafloat指定时间点的价格变化量。
identifierstring金融交易对标识。例如：EUR-USD。
displayed_namestringGoogle Finance 展示的交易对名称。例如：EUR / USD。
urlstringGoogle Finance 交易对页 URL。
locationstring市场所在地区。
trendstring价格趋势。可选值：up、down、stable。
timestampstring价格读取时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00。
percentage_deltafloat价格的百分比变化。

google_finance_market_instrument ​

表示股票、期货等市场金融项目。

字段类型说明
typestring固定为 google_finance_market_instrument。
rank_groupinteger组排名。在相同 type 的项目之间计算排名。
rank_absoluteintegerSERP 中的绝对排名。
tickerstring金融代码。例如：YMW00。
pricefloat指定时间点的金融价格。
price_deltafloat指定时间点的价格变化量。
price_currencystring价格货币。例如：USD。
identifierstring金融完整标识。例如：YMW00:CBOT。
displayed_namestringGoogle Finance 展示的金融名称。例如：E-mini Dow ($5)。
urlstringGoogle Finance 金融页 URL。
locationstring市场所在地区。
trendstring价格趋势。可选值：up、down、stable。
timestampstring价格读取时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00。
percentage_deltafloat价格的百分比变化。

响应示例 ​

json
{
  "version": "0.1.20241227",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "1.7881 sec.",
  "cost": 0.002,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "1.7000 sec.",
      "cost": 0.002,
      "result_count": 1,
      "path": [
        "v3",
        "serp",
        "google",
        "finance_ticker_search",
        "live",
        "advanced"
      ],
      "data": {
        "api": "serp",
        "function": "live",
        "se": "google",
        "se_type": "finance_ticker_search",
        "language_name": "English",
        "location_code": 2840,
        "category": "all",
        "keyword": "DJ",
        "device": "desktop",
        "os": "windows"
      },
      "result": [
        {
          "keyword": "DJ",
          "type": "finance_ticker_search",
          "location_code": "2840",
          "language_code": "en",
          "check_url": "https://www.google.com/finance",
          "datetime": "2025-02-10 09:40:00 +00:00",
          "spell": null,
          "refinement_chips": null,
          "item_types": [
            "google_finance_market_index",
            "google_finance_market_instrument"
          ],
          "se_results_count": 4,
          "items_count": 4,
          "items": [
            {
              "type": "google_finance_market_index",
              "rank_group": 1,
              "rank_absolute": 1,
              "ticker": "DAX",
              "market_identifier": "INDEXDB",
              "index_value": 21800.12,
              "index_value_delta": 120.34,
              "identifier": "DAX:INDEXDB",
              "displayed_name": "DAX",
              "url": "https://www.google.com/finance",
              "location": "Europe/Berlin",
              "trend": "up",
              "timestamp": "2025-02-10 09:40:00 +00:00",
              "percentage_delta": 0.56
            }
          ]
        }
      ]
    }
  ]
}

错误处理 ​

请根据顶层或任务级别的 status_code 和 status_message 判断请求是否成功：

  • 顶层 status_code 表示整个 API 请求的处理状态。
  • 任务级 status_code 表示单个任务的处理状态。
  • tasks_error 表示返回错误的任务数量。
  • 成功响应通常使用状态码 20000。
  • 发生错误时，应记录任务 id、状态码和错误信息，并根据业务需要执行重试或异常处理。

实用场景 ​

  • 查询股票代码，根据名称获取股票代码、展示名称和页 URL，支持证券研究与竞品监测。
  • 抓取市场指数，获取指数当前值、涨跌和趋势，构建 SEO 金融中的实时模块。
  • 监测货币交易对，查询基础资产与报价资产的价格变化，支持跨境业务和外汇分析。
  • 识别金融类别，按股票、指数、基金、货币或期货筛选结果，提升金融垂直搜索数据的分类准确性。
  • 核验搜索结果展示，结合 check_url、排名字段和结果类型，分析 Google Finance 对金融的展现。

统一入口：官网 · LLM API · 控制台

© 2026 SeerMarTech · GEO · SEO 营销数据 API