获取 Google Finance Quote 高级结果（按任务 ID）

接口说明

通过任务 ID 获取 Google Finance「Quote」标签页的高级结果。该接口返回的是此前已创建任务的抓取结果，结果与创建任务时设置的参数一致，主要：

• keyword 中的 ticker
• location
• language

这是一个按任务 ID 获取结果的接口，适用于异步任务流程：创建任务，再通过本接口读取结果。

请求方式

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

说明：

• $id：任务 ID，UUID 格式

计费说明

本接口本身不重复收费。扣费发生在创建任务时；任务结果在生成后的 30 天 可反复获取。

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

请求参数

路径参数

字段	类型	说明
id	string	任务唯一标识，UUID 格式。任务结果可在 30 天随时通过该 ID 获取。

返回结果说明

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

顶层字段

字段	类型	说明
version	string	当前 API 版本。
status_code	integer	通用状态码。建议在系统中统一处理异常和错误状态。
status_message	string	通用状态信息。
time	string	执行耗时，单位秒。
cost	float	本次请求总成本，单位 USD。获取结果通常为 0。
tasks_count	integer	tasks 数组中的任务数量。
tasks_error	integer	返回错误的任务数量。
tasks	array	任务结果数组。

tasks[] 字段

字段	类型	说明
id	string	任务 ID，UUID 格式。
status_code	integer	任务级状态码，范围通常为 10000-60000。
status_message	string	任务级状态说明。
time	string	任务执行耗时。
cost	float	任务成本，单位 USD。
result_count	integer	result 数组中的结果数量。
path	array	请求路径。
data	object	含你在 POST 创建任务时传的参数。
result	array	结果数组。

result[] 字段

字段	类型	说明
keyword	string	POST 任务中提交的。返回时会解码 %##，+ 会被还原为空格。
type	string	搜索引擎类型，此处固定为 finance_quote。
se_domain	string	POST 请求中的搜索域名。
location_code	string	POST 请求中的地区编码。
language_code	string	POST 请求中的语言编码。
check_url	string	结果页直达链接，可用于人工校验结果准确性。
datetime	string	抓取结果时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00。
spell	object	搜索引擎自动纠错信息；如发生纠错，返回纠正后的及纠错类型。
refinement_chips	object	搜索细化 chips；该接口中通常为 null。
item_types	array	本次 SERP 中出现的结果类型列表。
se_results_count	integer	SERP 结果总数。
items_count	integer	items 数组中的数量。
items	array	SERP 中解析出的结果。

item_types 可能值

• google_finance_hero_groups
• google_finance_quote
• google_finance_compare_to
• google_finance_news
• google_finance_financial
• google_finance_futures_chain
• google_finance_details
• google_finance_about
• google_finance_interested
• google_finance_people_also_search

---

SERP素说明

以下为 items[] 中可能出现的结构。

1）google_finance_hero_groups

金融市场概览数据。

字段	类型	说明
type	string	固定为 google_finance_hero_groups
rank_group	integer	同类型分组排名。
rank_absolute	integer	在整个 SERP 中的绝对排名。
markets	array	金融市场数据数组。

markets[]

字段	类型	说明
market	string	市场标识，可选值：US、Europe、Asia、Currencies、Crypto、Futures
items	array	市场指数/金融品种数据。

markets[].items[] 可能类型

• google_finance_asset_pair_element
• google_finance_market_instrument_element
• google_finance_market_index_element

google_finance_market_index_element

字段	类型	说明
type	string	固定为 google_finance_market_index_element
ticker	string	指数代码，例如 DAX
market_identifier	string	市场标识，例如 INDEXDB
index_value	float	指数值。
index_value_delta	float	指数变动值。
identifier	string	完整标识，例如 PX1:INDEXDB
displayed_name	string	页面展示名称，例如 CAC 40
url	string	Google Finance 页链接。
location	string	所在地区，例如 Europe/Paris
trend	string	趋势：up、down、stable
timestamp	string	读数时间，UTC 格式。
percentage_delta	float	百分比涨跌。

google_finance_asset_pair_element

字段	类型	说明
type	string	固定为 google_finance_asset_pair_element
base_symbol	string	资产对中的基础资产代码，例如 EUR
quote_symbol	string	计价资产代码，例如 USD
base_display_name	string	基础资产名，例如 Euro
quote_display_name	string	计价资产名。
price	float	基础资产相对于计价资产的价格。
price_delta	float	价格变动值。
identifier	string	资产对标识，例如 EUR-USD
displayed_name	string	展示名称，例如 EUR / USD
url	string	资产对页链接。
location	string	地区信息。
trend	string	趋势：up、down、stable
timestamp	string	读数时间，UTC 格式。
percentage_delta	float	百分比变动。

google_finance_market_instrument_element

字段	类型	说明
type	string	固定为 google_finance_market_instrument_element
ticker	string	品种代码，例如 YMW00
price	float	当前价格。
price_delta	float	价格变动值。
price_currency	string	价格币种，例如 USD
identifier	string	完整标识，例如 YMW00:CBOT
displayed_name	string	展示名称，例如 E-mini Dow ($5)
url	string	页链接。
location	string	地区信息。
trend	string	趋势：up、down、stable
timestamp	string	读数时间，UTC 格式。
percentage_delta	float	百分比变动。

---

2）google_finance_quote

核心报价模块。

字段	类型	说明
type	string	固定为 google_finance_quote
rank_group	integer	同类型分组排名。
rank_absolute	integer	绝对排名。
quote	object	当前报价对象。可能是指数、金融或资产对。
graph_items	array	图表数据点。

quote

可能为以下三种结构之一：

• google_finance_market_index_element
• google_finance_market_instrument_element
• google_finance_asset_pair_element

字段定义与上文一致。

graph_items[]

字段	类型	说明
timestamp	string	数据点时间，UTC 格式。
value	float	图表点位值。
volume	float	图表成交量。

---

3）google_finance_compare_to

对比标的模块。

字段	类型	说明
type	string	固定为 google_finance_compare_to
rank_group	integer	同类型分组排名。
rank_absolute	integer	绝对排名。
items	array	用于对比的指数/品种/资产对列表。

items[] 可能类型：

• google_finance_market_index_element
• google_finance_market_instrument_element
• google_finance_asset_pair_element

字段定义同上。

---

4）google_finance_news

财经新闻模块。

字段	类型	说明
type	string	固定为 google_finance_news
rank_group	integer	同类型分组排名。
rank_absolute	integer	绝对排名。
title	string	新闻模块标题，例如 Top news、In the news
sub_title	string	新闻模块副标题。
items	array	新闻文章列表。

google_finance_news_element

字段	类型	说明
type	string	固定为 google_finance_news_element
title	string	新闻标题。
url	string	新闻链接。
source	string	新闻来源站点名称。
image_url	string	特色图片 URL。
timestamp	string	时间戳，UTC 格式。
quotes	array	该新闻中提及的金融标的。

quotes[] 可能类型同上：

• google_finance_market_index_element
• google_finance_market_instrument_element
• google_finance_asset_pair_element

---

5）google_finance_financial

财务指标模块，可能季度和年度指标。

字段	类型	说明
type	string	固定为 google_finance_financial
rank_group	integer	同类型分组排名。
rank_absolute	integer	绝对排名。
quarterly_metrics	array	季度财务指标。
annual_metrics	array	年度财务指标。

google_finance_financial_element

字段	类型	说明
type	string	固定为 google_finance_financial_element
timestamp	string	时间戳，UTC 格式。
revenue	float	营收。
revenue_delta	float	营收变化。
operating_expense	float	运营费用。
operating_expense_delta	float	运营费用变化。
net_income	float	净利润。
net_income_delta	float	净利润变化。
net_profit_margin	float	净利率。
net_profit_margin_delta	float	净利率变化。
earnings_per_share	float	每股收益。
earnings_per_share_delta	float	每股收益变化。
ebitda	float	EBITDA。
ebitda_delta	float	EBITDA 变化。
effective_tax_rate	float	实税率。
cash_and_short_term_investments	float	现金及短期投资。
cash_and_short_term_investments_delta	float	现金及短期投资变化。
total_assets	float	总资产。
total_assets_delta	float	总资产变化。
total_liabilities	float	总负债。
total_liabilities_delta	float	总负债变化。
total_equity	float	股东权益。
shares_outstanding	float	流通股数。
price_to_book	float	市净率。
return_on_assets	float	资产回报率。
return_on_capital	float	资本回报率。
cash_from_operations	float	经营现金流。
cash_from_operations_delta	float	经营现金流变化。
cash_from_investing	float	投资现金流。
cash_from_investing_delta	float	投资现金流变化。
cash_from_financing	float	融资现金流。
cash_from_financing_delta	float	融资现金流变化。
net_change_in_cash	float	现金净变动。
net_change_in_cash_delta	float	现金净变动变化。
free_cash_flow	float	自由现金流。
free_cash_flow_delta	float	自由现金流变化。

---

6）google_finance_futures_chain

期货链模块。

字段	类型	说明
type	string	固定为 google_finance_futures_chain
rank_group	integer	同类型分组排名。
rank_absolute	integer	绝对排名。
markets	array	期货合约列表。

google_finance_futures_chain_element

字段	类型	说明
type	string	固定为 google_finance_futures_chain_element
expiration_timestamp	string	到期时间，UTC 格式。
symbol	string	期货代码。
price	float	期货价格。
price_currency	string	价格币种。
price_delta	float	价格变动值。
percentage_delta	float	涨跌百分比。
trend	string	趋势：up、down、stable

---

7）google_finance_details

标的模块。

字段	类型	说明
type	string	固定为 google_finance_details
rank_group	integer	同类型分组排名。
rank_absolute	integer	绝对排名。
badges	array	标签列表，例如 Futures Contract
previous_close	float	前收盘价。
start_day_range	float	日区间起始值。
end_day_range	float	日区间结束值。
start_year_range	float	年区间起始值。
end_year_range	float	年区间结束值。
market_cap	float	市值。
volume	float	成交量。
avg_volume	float	平均成交量。
pe_ratio	float	市盈率。
dividend_yield	float	股息率。
primary_exchange	string	主要交易所。
ytd_return	float	年初至今回报。
expense_ratio	float	费用率。
category	string	类别名。
net_asset	float	净资产。
yield	float	收益率。
front_load	float	前端收费。
market_segment	string	市场细分名称。
open_interest	float	未平仓合约数。
settlement_price	float	结算价。
cdp_climate_change_score	string	按 CDP 方法论给出的气候变化评分。
metrics_currency	string	指标币种。

---

8）google_finance_about

标的/简介模块。

字段	类型	说明
type	string	固定为 google_finance_about
rank_group	integer	同类型分组排名。
rank_absolute	integer	绝对排名。
displayed_name	string	页面展示名称。
description	string	或标的描述。
description_source_url	string	描述来源链接。
ceo	string	首席执行官。
founded	string	成立时间，格式：yyyy-mm-ddThh-mm-ssZ
headquarters	string	总部所在地。
website	string	官方网站。
employees	integer	员工人数。

---

9）google_finance_interested

你可能感模块，通常基于近期搜索、证券或行为生成。

字段	类型	说明
type	string	固定为 google_finance_interested
rank_group	integer	同类型分组排名。
rank_absolute	integer	绝对排名。
items	array	市场指数/品种/资产对。

items[] 可能类型同上：

• google_finance_market_index_element
• google_finance_market_instrument_element
• google_finance_asset_pair_element

---

10）google_finance_people_also_search

用户也会搜索模块。

字段	类型	说明
type	string	固定为 google_finance_people_also_search
rank_group	integer	同类型分组排名。
rank_absolute	integer	绝对排名。
items	array	市场指数/品种/资产对。

items[] 可能类型同上：

• google_finance_market_index_element
• google_finance_market_instrument_element
• google_finance_asset_pair_element

---

沙箱调试

如需查看该类高级 SERP 结果的完整字段结构，可使用沙箱接口测试。沙箱返回的是模拟数据，不会产生费用。

示例沙箱路径：

https://api.seermartech.cn/v3/serp/google/ads_search/task_get/advanced/00000000-0000-0000-0000-000000000000

注意：该沙箱示例路径用于展示高级结果结构，返回字段为模拟值。

---

调用示例

cURL

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

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

Python

import requests

task_id = "02231256-2604-0066-2000-57133b8fc54e"
url = f"https://api.seermartech.cn/v3/serp/google/finance_quote/task_get/advanced/{task_id}"

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

response = requests.get(url, headers=headers)
print(response.status_code)
print(response.json)

TypeScript

import axios from "axios";

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

axios({
 method: "get",
 url: `https://api.seermartech.cn/v3/serp/google/finance_quote/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);
 });

---

结合 tasks_ready 获取已完成任务

在异步模式下，通常查询已完成任务列表，再按任务 ID 获取高级结果。

Python 示例

import requests

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

# 1. 获取已完成任务
ready_resp = requests.get(
 "https://api.seermartech.cn/v3/serp/google/finance_quote/tasks_ready",
 headers=headers
)
ready_data = ready_resp.json

results = []

if ready_data.get("status_code") == 20000:
 for task in ready_data.get("tasks", []):
 for result_item in task.get("result", []) or []:
 endpoint = result_item.get("endpoint_advanced")
 task_id = result_item.get("id")

 # 2. 通过 endpoint_advanced 直接获取结果
 if endpoint:
 resp = requests.get(
 f"https://api.seermartech.cn{endpoint}",
 headers=headers
 )
 results.append(resp.json)

 # 3. 或通过 task id 手动拼接接口地址
 elif task_id:
 resp = requests.get(
 f"https://api.seermartech.cn/v3/serp/google/finance_quote/task_get/advanced/{task_id}",
 headers=headers
 )
 results.append(resp.json)

print(results)

---

响应示例

{
 "version": "0.1.20241227",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0895 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "serp",
 "function": "task_get",
 "se": "google",
 "se_type": "finance_quote",
 "language_name": "English",
 "location_code": 2840,
 "keyword": ".DJI:INDEXDJX",
 "window": "1D",
 "priority": 2,
 "device": "desktop",
 "os": "windows"
 },
 "result": [
 {
 "se_results_count": 0,
 "items_count": 11,
 "items": [
 {
 "type": "google_finance_quote",
 "rank_group": 1,
 "rank_absolute": 2,
 "quote": {
 "type": "google_finance_market_instrument_element",
 "ticker": "CLW00",
 "price": 70.33000183105469,
 "price_delta": -0.90999603,
 "price_currency": "USD",
 "identifier": "CLW00:NYMEX",
 "displayed_name": "Crude Oil",
 "url": "https://google.com/finance/quote/CLW00:NYMEX?hl=en&gl=us",
 "location": null,
 "trend": "down",
 "timestamp": "2025-02-13 13:58:12 +00:00",
 "percentage_delta": -1.2773668
 },
 "graph_items": []
 },
 {
 "type": "google_finance_compare_to",
 "rank_group": 1,
 "rank_absolute": 3,
 "items": []
 },
 {
 "type": "google_finance_news",
 "rank_group": 1,
 "rank_absolute": 4,
 "title": "Top news",
 "sub_title": null,
 "items": []
 },
 {
 "type": "google_finance_futures_chain",
 "rank_group": 1,
 "rank_absolute": 7,
 "markets": []
 },
 {
 "type": "google_finance_details",
 "rank_group": 1,
 "rank_absolute": 8,
 "badges": [],
 "previous_close": 71.24,
 "start_day_range": 70.16,
 "end_day_range": 71.18,
 "start_year_range": 70.16,
 "end_year_range": 71.18,
 "market_cap": null,
 "volume": 72805,
 "avg_volume": null,
 "pe_ratio": null,
 "dividend_yield": null,
 "primary_exchange": "NYMEX",
 "ytd_return": null,
 "expense_ratio": null,
 "category": null,
 "net_assets": null,
 "yield": null,
 "front_load": null,
 "market_segment": "ENRGY",
 "open_interest": 256985,
 "settlement_price": 71.24,
 "cdp_climate_change_score": null,
 "metrics_currency": "USD"
 },
 {
 "type": "google_finance_about",
 "rank_group": 1,
 "rank_absolute": 9,
 "displayed_name": "NYMEX:CLW00",
 "description": null,
 "description_source_url": null,
 "ceo": null,
 "founded": null,
 "headquarters": null,
 "website": null,
 "employees": null
 },
 {
 "type": "google_finance_interested",
 "rank_group": 1,
 "rank_absolute": 10,
 "items": []
 },
 {
 "type": "google_finance_people_also_search",
 "rank_group": 1,
 "rank_absolute": 11,
 "items": []
 }
 ]
 }
 ]
 }
 ]
}

---

错误处理建议

• 检查顶层 status_code 是否为 20000
• 再检查 tasks[].status_code 是否为成功状态
• 如果 tasks[].result 为空，通常表示任务尚未完成、任务 ID 无效，或结果已过保留期
• 建议合 /v3/serp/google/finance_quote/tasks_ready 筛选已完成任务，再逐个获取结果

实用场景

• 监控标的报价变化：抓取股票、指数、期货或汇率的实时 Quote 数据，用于构建市场监控面板和价格异动提醒。
• 提取图表时序数据：读取 graph_items 中的时间序列点位与成交量，支持趋势分析、可视化展示和策略回测。
• 跟踪影响：解析 google_finance_news 模块及引用的报价标的，评估新闻事件对目标资产的影响。
• 分析财务与估值指标：提取 google_finance_financial、google_finance_details 中的营收、净利润、市盈率、成交量等指标，投研与横向对比。
• 挖掘标的：利用 compare_to、interested、people_also_search 模块发现相似或资产，支持选题、竞品观察和投资主题拓展。