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

接口说明

用于根据任务 id 获取 Google Finance「Explore」页的高级结果。该接口返回实时抓取的数据，结果与您在创建任务时指定的参数一致，例如：

keyword 中的股票/指数代码（ticker）
location
language

请求地址

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

计费说明

该接口本身不重复计费，在创建任务时扣费。任务提交成功后，可在 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
`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	创建任务时传的参数回显
`result`	array	结果数组

result 数组中的字段

字段	类型	说明
`keyword`	string	创建任务时的；返回时会对 `%##` 进行解码，`+` 会被还原为空格
`type`	string	搜索类型，固定为 `finance_explore`
`se_domain`	string	创建任务时的搜索引擎域名
`location_code`	string	创建任务时的位置编码
`language_code`	string	创建任务时的语言编码
`check_url`	string	对应搜索结果的直达链接，可用于人工核验
`datetime`	string	结果采集时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`
`spell`	object	搜索引擎自动纠错信息；若被修正，会返回修正后的词及纠错类型
`refinement_chips`	object	搜索细分建议；该接口中通常为 `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_interested
google_finance_news
google_finance_earnings_calendar
google_finance_most_followed
google_finance_market_trends
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 中可能出现的 type：

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	指数在指定 `timestamp` 的数值
`index_value_delta`	float	指数变动值
`identifier`	string	完整标识，通常由 `ticker` 和 `market_identifier` 组成，如 `PX1:INDEXDB`
`displayed_name`	string	Google Finance 展示名称，如 `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	Google Finance 页链接
`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	指定 `timestamp` 的价格
`price_delta`	float	价格变动值
`price_currency`	string	价格币种，如 `USD`
`identifier`	string	完整标识，如 `YMW00:CBOT`
`displayed_name`	string	展示名称，如 `E-mini Dow ($5)`
`url`	string	Google Finance 页链接
`location`	string	市场位置
`trend`	string	趋势：`up`、`down`、`stable`
`timestamp`	string	数值时间戳，UTC 格式
`percentage_delta`	float	涨跌百分比

2) `google_finance_interested`

根据近期搜索、证券及用户行为生成的感市场列表。

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

items 中可能出现的类型与 google_finance_hero_groups 中一致：

google_finance_asset_pair_element
google_finance_market_instrument_element
google_finance_market_index_element

这些子项字段结构与前文定义相同。

3) `google_finance_news`

财经新闻模块。

字段	类型	说明
`type`	string	固定为 `google_finance_news`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	SERP 绝对排名
`title`	string	新闻模块标题，如 `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

字段结构与前文一致。

4) `google_finance_earnings_calendar`

财报日历模块。

字段	类型	说明
`type`	string	固定为 `google_finance_earnings_calendar`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	SERP 绝对排名
`items`	array	财报日历条目列表

`google_finance_earnings_calendar_element`

字段	类型	说明
`type`	string	固定为 `google_finance_earnings_calendar_element`
`title`	string	财报日历标题
`url`	string	指向 Google Calendar 的链接
`timestamp`	string	时间戳，UTC 格式

5) `google_finance_most_followed`

最受模块。

字段	类型	说明
`type`	string	固定为 `google_finance_most_followed`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	SERP 绝对排名
`items`	array	条目数组

items 中可能出现：

google_finance_asset_pair_element
google_finance_market_instrument_element
google_finance_market_index_element

字段结构与前文一致。

6) `google_finance_market_trends`

市场趋势模块，通常按活跃度、涨、跌分类展示。

字段	类型	说明
`type`	string	固定为 `google_finance_market_trends`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	SERP 绝对排名
`items`	object	分类结果对象

`items` 对象结构

以下数组字段：

most_active
gainers
losers

这些数组中的每一项均为 google_finance_market_trends_element。

`google_finance_market_trends_element`

字段	类型	说明
`type`	string	固定为 `google_finance_market_trends_element`
`quote`	object	对应金融标的，可能为指数、金融或资产对
`news`	array	数组

quote 可能为：

google_finance_market_index_element
google_finance_market_instrument_element
google_finance_asset_pair_element

news 中为 google_finance_news_element， quotes 结构与前文相同。

7) `google_finance_people_also_search`

“用户还搜索”模块。

字段	类型	说明
`type`	string	固定为 `google_finance_people_also_search`
`items`	array	市场指数//资产对

items 中可能出现：

google_finance_asset_pair_element
google_finance_market_instrument_element
google_finance_market_index_element

字段结构与前文一致。

沙箱测试

如需查看该接口可能返回的 SERP素结构，可请求以下沙箱地址：

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

沙箱返回的是带有模拟数据的完整结构，不会产生扣费。

错误处理建议

顶层使用 status_code 和 status_message 判断请求是否成功
逐个检查 tasks[].status_code 与 tasks[].status_message
建议对异常状态、空结果、时、任务未完成等建立完整处理逻辑

请求示例

cURL

bash

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

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

Python

python

import requests

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

url = f"https://api.seermartech.cn/v3/serp/google/finance_explore/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

# 输出结果
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_explore/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.0663 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "serp",
 "function": "task_get",
 "se": "google",
 "se_type": "finance_explore",
 "language_name": "English",
 "location_code": 2840,
 "keyword": "NASDAQ-100",
 "news_type": "local_market",
 "priority": 2,
 "device": "desktop",
 "os": "windows"
 },
 "result": [
 {
 "se_results_count": 0,
 "items_count": 7,
 "items": [
 {
 "type": "google_finance_hero_groups"
 },
 {
 "type": "google_finance_interested",
 "rank_group": 1,
 "rank_absolute": 2
 },
 {
 "type": "google_finance_news",
 "rank_group": 1,
 "rank_absolute": 3,
 "title": "Today's financial news",
 "sub_title": null,
 "items": [
 {
 "type": "google_finance_news_element",
 "title": "1 Index Fund to Buy That Could Produce Total Returns 5 Times Better Than the S&P 500, According to Certain Wall Street Analysts",
 "url": "https://www.fool.com/investing/2025/02/17/1-index-fund-to-buy-that-could-produce-returns-5-t/",
 "source": "The Motley Fool",
 "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTrO_sLuW3WLJutRxaydcoWlKpPt10x_ulUWUEqVe8prLZC_aIxvTdh_vIXIO0",
 "timestamp": "2025-02-17 10:19:00 +00:00",
 "quotes": []
 }
 ]
 },
 {
 "type": "google_finance_earnings_calendar",
 "rank_group": 1,
 "rank_absolute": 4,
 "items": []
 },
 {
 "type": "google_finance_most_followed",
 "rank_group": 1,
 "rank_absolute": 5,
 "items": []
 },
 {
 "type": "google_finance_market_trends",
 "rank_group": 1,
 "rank_absolute": 6,
 "items": {
 "most_active": [
 {
 "type": "google_finance_market_trends_element",
 "quote": {
 "type": "google_finance_market_instrument_element",
 "ticker": "NVDA",
 "price": 138.85,
 "price_delta": 3.5600128,
 "price_currency": "USD",
 "identifier": "NVDA:NASDAQ",
 "displayed_name": "NVIDIA Corp",
 "url": "https://google.com/finance/quote/NVDA:NASDAQ?hl=en&gl=us",
 "location": "America/New_York",
 "trend": "up",
 "timestamp": "2025-02-15 01:30:00 +00:00",
 "percentage_delta": 2.6313941
 },
 "news": []
 }
 ],
 "gainers": [
 {
 "type": "google_finance_market_trends_element",
 "quote": {
 "type": "google_finance_market_instrument_element",
 "ticker": "GT",
 "price": 9.58,
 "price_delta": 1.4099998,
 "price_currency": "USD",
 "identifier": "GT:NASDAQ",
 "displayed_name": "Goodyear Tire & Rubber Co",
 "url": "https://google.com/finance/quote/GT:NASDAQ?hl=en&gl=us",
 "location": "America/New_York",
 "trend": "up",
 "timestamp": "2025-02-15 01:30:00 +00:00",
 "percentage_delta": 17.25826
 },
 "news": []
 }
 ],
 "losers": [
 {
 "type": "google_finance_market_trends_element",
 "quote": {
 "type": "google_finance_market_instrument_element",
 "ticker": "INFA",
 "price": 19.75,
 "price_delta": -5.42,
 "price_currency": "USD",
 "identifier": "INFA:NYSE",
 "displayed_name": "Informatica Inc",
 "url": "https://google.com/finance/quote/INFA:NYSE?hl=en&gl=us",
 "location": "America/New_York",
 "trend": "down",
 "timestamp": "2025-02-15 01:04:00 +00:00",
 "percentage_delta": -21.533571
 },
 "news": []
 }
 ]
 }
 },
 {
 "type": "google_finance_interested",
 "rank_group": 2,
 "rank_absolute": 7,
 "items": []
 }
 ]
 }
 ]
 }
 ]
}

使用建议

通常可合以下接口一起使用：

通过任务提交接口创建采集任务；
再通过 /v3/serp/google/finance_explore/tasks_ready 获取已完成任务；
最后通过本接口按 id 拉取高级结果。

实用场景

监控指数与板块动态：抓取 market_trends、hero_groups 等模块，快速识别上涨、下跌和活跃标的，为金融选题或舆追踪提供依据。
跟踪财经新闻标的：利用 google_finance_news 与 quotes 字段，将新闻与指数、股票、汇率对，提升热点解读和聚合效率。
分析用户市场方向：通过 most_followed、interested、people_also_search 模块识别市场焦点，用于投资类栏目策划或需求洞察。
采集财报节点信息：使用 earnings_calendar 提前识别财报时间点，排期、预警提醒和事件流分析。
校验特定 ticker 的展示结果：结合 check_url 与返回的结构化字段，验证指定股票、指数或货币对在 Google Finance Explore 页中的。

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

接口说明 ​

请求地址 ​

计费说明 ​

路径参数 ​

返回结果说明 ​

顶层字段 ​

tasks 数组中的字段 ​

result 数组中的字段 ​

item_types 可选值 ​

SERP 结果项说明 ​

1) google_finance_hero_groups ​

markets 字段 ​

google_finance_market_index_element ​

google_finance_asset_pair_element ​

google_finance_market_instrument_element ​

2) google_finance_interested ​

3) google_finance_news ​

google_finance_news_element ​

4) google_finance_earnings_calendar ​

google_finance_earnings_calendar_element ​

5) google_finance_most_followed ​

6) google_finance_market_trends ​

items 对象结构 ​

google_finance_market_trends_element ​

7) google_finance_people_also_search ​

沙箱测试 ​

错误处理建议 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

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

接口说明

请求地址

计费说明

路径参数

返回结果说明

顶层字段

tasks 数组中的字段

result 数组中的字段

item_types 可选值

SERP 结果项说明

1) `google_finance_hero_groups`

markets 字段

`google_finance_market_index_element`

`google_finance_asset_pair_element`

`google_finance_market_instrument_element`

2) `google_finance_interested`

3) `google_finance_news`

`google_finance_news_element`

4) `google_finance_earnings_calendar`

`google_finance_earnings_calendar_element`

5) `google_finance_most_followed`

6) `google_finance_market_trends`

`items` 对象结构

`google_finance_market_trends_element`

7) `google_finance_people_also_search`

沙箱测试

错误处理建议

请求示例

cURL

Python

TypeScript