SeerMarTech API 文档

主题

获取 Google Finance Ticker Search 高级结果（按任务 ID） ​

接口说明 ​

通过任务 ID 获取 Google Finance Ticker Search 的高级搜索结果。

Google Finance Ticker Search 用于搜索 Google Finance 中可用的金融，并返回附加信息。结果与创建任务时提交的参数强，：

  • keyword：名称或金融名称
  • location
  • language

请求方式 ​

GET https://api.seermartech.cn/v3/serp/google/finance_ticker_search/task_get/advanced/$id

说明：

  • $id：任务唯一标识，UUID 格式
  • 任务结果可在任务创建后的 30 天重复获取

计费说明 ​

本接口在创建任务时计费，后续在 30 天按任务 ID 获取结果不重复收费。

本次结果查询接口通常返回 cost: 0；扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求参数 ​

路径参数 ​

字段类型说明
idstring任务唯一标识，UUID 格式；可在 30 天用于随时获取该任务结果

返回结构 ​

接口返回 JSON 数据，顶层 tasks 数组。

顶层字段 ​

字段类型说明
versionstring当前 API 版本
status_codeinteger通用状态码，完整列表参考 /v3/appendix/errors
status_messagestring通用状态信息，完整列表参考 /v3/appendix/errors
timestring执行耗时，单位秒
costfloat本次请求总成本，单位 USD
tasks_countintegertasks 数组中的任务数量
tasks_errorintegertasks 数组中返回错误的任务数量
tasksarray任务结果数组

tasks[] 字段 ​

字段类型说明
idstring任务 ID，UUID 格式
status_codeinteger任务状态码，范围通常为 10000-60000，完整列表参考 /v3/appendix/errors
status_messagestring任务状态信息
timestring任务执行耗时，单位秒
costfloat该任务成本，单位 USD
result_countintegerresult 数组中的结果数量
patharrayURL 路径
dataobject与创建任务时一致的请求参数
resultarray结果数组

result[] 字段 ​

字段类型说明
keywordstringPOST 提交时的；返回时会解码 %##，且 + 会被还原为空格
typestring搜索引擎类型，此处固定为 finance_ticker_search
se_domainstring创建任务时的搜索引擎域名
location_codestring创建任务时的地区代码
language_codestring创建任务时的语言代码
check_urlstring搜索结果直达链接，可用于核验结果准确性
datetimestring获取结果的时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00
spellobject搜索引擎自动纠错信息；若被纠正，会返回纠正后的词及纠错类型
refinement_chipsobject搜索细化标签；本接口中该值通常为 null
item_typesarray当前 SERP 中出现的结果类型
se_results_countintegerSERP 结果总数
items_countintegeritems 数组中的结果数量
itemsarray搜索结果项

item_types 可选值 ​

  • google_finance_market_index
  • google_finance_asset_pair
  • google_finance_market_instrument

items[] 结果项说明 ​

本接口返回的 items[] 中，可能出现以下 3 类结果。

1）google_finance_market_index ​

市场指数结果项。

字段类型说明
typestring固定为 google_finance_market_index
rank_groupinteger同类型结果组排名
rank_absoluteinteger在整个 SERP 中的绝对排名
tickerstring指数 ticker，例如 DAX
market_identifierstring市场标识，例如 INDEXDB
index_valuefloat指定 timestamp 时刻的指数值
index_value_deltafloat指定 timestamp 时刻的指数变动值
identifierstring完整标识，由 ticker 和 market_identifier 组成，例如 PX1:INDEXDB
displayed_namestringGoogle Finance 展示名称，例如 CAC 40
urlstringGoogle Finance 对应页链接
locationstring指数所属地区/时区，例如 Europe/Paris
trendstring走势方向：up、down、stable
timestampstring数值读取时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00
percentage_deltafloat指数变动百分比

2）google_finance_asset_pair ​

资产对结果项，常见于外汇或成对报价场景。

字段类型说明
typestring固定为 google_finance_asset_pair
rank_groupinteger同类型结果组排名
rank_absoluteinteger在整个 SERP 中的绝对排名
base_symbolstring基础资产标识，例如 EUR
quote_symbolstring计价资产标识，例如 USD
base_display_namestring基础资产称，例如 Euro
quote_display_namestring计价资产称
pricefloat基础资产相对计价资产的价格
price_deltafloat指定 timestamp 时刻的价格变动值
identifierstring金融资产对标识，例如 EUR-USD
displayed_namestring展示名称，例如 EUR / USD
urlstringGoogle Finance 对应页链接
locationstring市场位置/地区信息
trendstring走势方向：up、down、stable
timestampstring数值读取时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00
percentage_deltafloat价格变动百分比

3）google_finance_market_instrument ​

市场结果项，例如期货、商品或可交易。

字段类型说明
typestring固定为 google_finance_market_instrument
rank_groupinteger同类型结果组排名
rank_absoluteinteger在整个 SERP 中的绝对排名
tickerstring工 ticker，例如 YMW00
pricefloat指定 timestamp 时刻的价格
price_deltafloat指定 timestamp 时刻的价格变动值
price_currencystring价格币种，例如 USD
identifierstring完整标识，例如 YMW00:CBOT
displayed_namestring展示名称，例如 E-mini Dow ($5)
urlstringGoogle Finance 对应页链接
locationstring市场位置/地区信息
trendstring走势方向：up、down、stable
timestampstring数值读取时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00
percentage_deltafloat价格变动百分比

沙箱测试 ​

你可以使用以下沙箱地址查看本接口可返回的字段结构，沙箱不会产生费用：

https://sandbox.seermartech.cn/v3/serp/google/finance_ticker_search/task_get/advanced/00000000-0000-0000-0000-000000000000

沙箱响应会返回本接口支持的结果项结构，字段值为示例数据。

调用示例 ​

cURL ​

bash
id="02261816-2027-0066-0000-c27d02864073"

curl --location --request GET "https://api.seermartech.cn/v3/serp/google/finance_ticker_search/task_get/advanced/${id}" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw ""

Python ​

python
import requests

task_id = "02231256-2604-0066-2000-57133b8fc54e"

url = f"https://api.seermartech.cn/v3/serp/google/finance_ticker_search/task_get/advanced/{task_id}"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
result = response.json

# 输出结果 JSON
print(result)

TypeScript ​

typescript
import axios from "axios";

const taskId = "02231256-2604-0066-2000-57133b8fc54e";

axios({
 method: "get",
 url: `https://api.seermartech.cn/v3/serp/google/finance_ticker_search/task_get/advanced/${taskId}`,
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json",
 },
}).then((response) => {
 // 返回结果
 console.log(response.data);
}).catch((error) => {
 console.error(error.response?.data || error.message);
});

响应示例 ​

json
{
 "version": "0.1.20241227",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0926 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "serp",
 "function": "task_get",
 "se": "google",
 "se_type": "finance_ticker_search",
 "language_name": "English",
 "location_code": 2840,
 "category": "all",
 "keyword": "DJ",
 "priority": 2,
 "device": "desktop",
 "os": "windows"
 },
 "result": [
 {
 "se_results_count": 0,
 "items_count": 4,
 "items": []
 }
 ]
 }
 ]
}

说明：

  • cost 为 0 表示当前结果获取请求未产生额外费用；
  • 真实返回中通常还会 id、status_code、status_message、path、result_count 等任务级字段；
  • items 中的每个类型，需结合 type 字段解析。

错误处理建议 ​

建议对以下层级分别做校验：

  1. HTTP 状态码
  2. 顶层 status_code / status_message
  3. tasks[].status_code / tasks[].status_message
  4. result 是否为空
  5. items[].type 是否为预期类型

完整错误码与消息说明可参考：

  • /v3/appendix/errors

常见处理建议：

  • 当 tasks_error > 0 时，遍历 tasks 检查失败任务
  • 当 result_count = 0 时，表示该任务暂无可返回结果或结果为空
  • 当 items_count = 0 时，表示当前下未解析到可展示的金融对象

使用说明补 ​

通常推荐以下流程：

  1. 通过对应的任务提交接口创建搜索任务
  2. 再通过 /v3/serp/google/finance_ticker_search/tasks_ready 获取已完成任务列表
  3. 最后使用本接口 /v3/serp/google/finance_ticker_search/task_get/advanced/$id 按任务 ID 拉取详细结果

本接口适合在异步任务处理链路中使用，用于获取结构化的 Google Finance 搜索结果。

实用场景 ​

  • 检索股票/指数候选标的：名、简称或模糊金融，快速识别对应 ticker、交易市场和展示名称，提升金融类 SEO 页面建库效率。
  • 匹外汇与资产对结果：根据用户搜索词识别 EUR/USD 等资产对，补标准化标识与报价信息，便于构建汇率专题页或聚合页。
  • 识别期货与衍生品：提取 google_finance_market_instrument 结果中的 ticker、价格和币种，用于搭建商品、期货或衍生品库。
  • 监控 SERP 金融实体呈现方式：跟踪同一在不同地区和语言下返回的是指数、资产对还是市场，为化金融优化提供依据。
  • 校验金融映射准确性：结合 check_url、identifier、displayed_name 等字段，验证是否被正确映射到目标金融实体，降低自动化采集误匹风险。

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

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