Google Finance Explore 实时高级版

POST /v3/serp/google/finance_explore/live/advanced

接口说明

本接口用于实时获取 Google Finance「Explore」标签页的数据。返回结果会根据请求中指定的地区和语言参数而变化，适合抓取金融首页概览、市场走势、财经新闻、热门标的等信息。

请求方式：POST
接口地址：https://api.seermartech.cn/v3/serp/google/finance_explore/live/advanced

计费说明

本接口按请求计费。

参考价约 ¥0.0320 / 次
如果 news_type 指定为 local_market 或 world_markets，单次任务费用按 2 倍计
实扣费以响应头 X-SeerMarTech-Charge-CNY 为准

请求规则

所有 POST 数据使用 JSON 格式（UTF-8 编码）
请求体为 JSON 数组：[{ ... }]
每次 Live SERP 请求 只能 1 个任务
频率上限：2000 次 API 调用/分钟

请求参数

主要参数

字段名	类型	说明
`location_code`	integer	搜索引擎地区代码。不传 `location_name` 时填；传了该字段后无需再传 `location_name`。可通过 `/v3/serp/google/locations` 获取可用地区代码。示例：`2840`
`language_code`	string	搜索引擎语言代码。不传 `language_name` 时填；传了该字段后无需再传 `language_name`。可通过 `/v3/serp/google/languages` 获取可用语言代码。示例：`en`
`device`	string	设备类型，可选。当前支持值：`desktop`

附加参数

字段名	类型	说明
`location_name`	string	搜索引擎地区完整名称。不传 `location_code` 时填；传了该字段后无需再传 `location_code`。可通过 `/v3/serp/google/locations` 获取可用地区名称。示例：`London,England,United Kingdom`
`language_name`	string	搜索引擎语言完整名称。不传 `language_code` 时填；传了该字段后无需再传 `language_code`。可通过 `/v3/serp/google/languages` 获取可用语言名称。示例：`English`
`os`	string	设备操作系统，可选。当前支持值：`windows`
`tag`	string	自定义任务标识，可选，最长 255 个字符。可用于请求与结果的业务，响应的 `data` 对象中会原样返回该值
`news_type`	string	财经新闻过滤类型，可选。支持值：`top_stories`、`local_market`、`world_markets`。默认值：`top_stories`。注意：传 `local_market` 或 `world_markets` 时，该任务费用翻倍

响应结构

接口返回 JSON 数据，顶层 tasks 数组，每个任务对应一组执行结果。

顶层字段

字段名	类型	说明
`version`	string	当前 API 版本
`status_code`	integer	通用状态码，完整列表参考 `/v3/appendix/errors`
`status_message`	string	通用状态信息，完整列表参考 `/v3/appendix/errors`
`time`	string	执行耗时，单位秒
`cost`	float	本次请求总费用，单位 USD
`tasks_count`	integer	`tasks` 数组中的任务数量
`tasks_error`	integer	返回错误的任务数量
`tasks`	array	任务数组

任务级字段

字段名	类型	说明
`id`	string	任务唯一标识，UUID 格式
`status_code`	integer	任务状态码，范围通常为 `10000-60000`，完整列表参考 `/v3/appendix/errors`
`status_message`	string	任务状态信息
`time`	string	任务执行耗时，单位秒
`cost`	float	任务费用，单位 USD
`result_count`	integer	`result` 数组中的结果数量
`path`	array	URL 路径
`data`	object	请求中提交的参数，会原样回显
`result`	array	结果数组

结果级字段

字段名	类型	说明
`keyword`	string	POST 中接收的。若 `%##` 编码会被解码，`+` 会被解码为空格
`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 中出现的结果类型。可能值：`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`
`se_results_count`	integer	SERP 中结果总数
`items_count`	integer	`items` 数组返回的数量
`items`	array	SERP素列表

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 中可能出现以下类型：

A. `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	指定 `timestamp` 时刻相对变动值
`identifier`	string	完整标识，由 `ticker` 和 `market_identifier` 组成，例如 `PX1:INDEXDB`
`displayed_name`	string	页面展示名称，例如 `CAC 40`
`url`	string	金融页面链接
`location`	string	指数所在地区，例如 `Europe/Paris`
`trend`	string	趋势方向：`up`、`down`、`stable`
`timestamp`	string	数据时间，UTC 格式，例如 `2025-02-10 09:40:00 +00:00`
`percentage_delta`	float	百分比涨跌

B. `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	指定 `timestamp` 时刻的价格变化值
`identifier`	string	金融对标识，例如 `EUR-USD`
`displayed_name`	string	页面展示名称，例如 `EUR / USD`
`url`	string	金融对链接
`location`	string	所属市场地区
`trend`	string	趋势方向：`up`、`down`、`stable`
`timestamp`	string	数据时间，UTC 格式
`percentage_delta`	float	百分比变化

C. `google_finance_market_instrument_element`

字段名	类型	说明
`type`	string	固定为 `google_finance_market_instrument_element`
`ticker`	string	标的代码，例如 `YMW00`
`price`	float	指定 `timestamp` 时刻的价格
`price_delta`	float	指定 `timestamp` 时刻的价格变动值
`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_interested`

“你可能感”或基于近期搜索/行为生成的标的列表。

字段名	类型	说明
`type`	string	固定为 `google_finance_interested`
`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

字段定义同上，不再重复。

3) `google_finance_news`

财经新闻模块。

字段名	类型	说明
`type`	string	固定为 `google_finance_news`
`rank_group`	integer	同类型组排名
`rank_absolute`	integer	在整个 SERP 中的绝对排名
`title`	string	新闻模块标题，例如 `Today's financial news`
`sub_title`	string	子标题，可能为 `null`
`items`	array	新闻条目列表

`google_finance_news_element`

字段名	类型	说明
`type`	string	固定为 `google_finance_news_element`
`title`	string	新闻标题
`url`	string	新闻原文链接
`source`	string	新闻来源站点名称
`image_url`	string	特色图片链接
`timestamp`	string	抓取时间，UTC 格式
`quotes`	array	新闻中引用的市场标的列表，可能为 `null`

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	数组，可能为 `null`

quote 可能为以下类型之一：

google_finance_market_index_element
google_finance_market_instrument_element
google_finance_asset_pair_element

news 数组中类型为 google_finance_news_element，字段如下：

字段名	类型	说明
`type`	string	固定为 `google_finance_news_element`
`title`	string	新闻标题
`url`	string	新闻原文链接
`source`	string	新闻来源
`image_url`	string	特色图片链接
`timestamp`	string	抓取时间，UTC 格式
`quotes`	array	新闻中引用的市场标的

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

字段定义与前文一致。

请求示例

cURL

bash

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

Python

python

import requests

url = "https://api.seermartech.cn/v3/serp/google/finance_explore/live/advanced"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
data = [
 {
 "location_code": 2840,
 "language_name": "English"
 }
]

response = requests.post(url, headers=headers, json=data)
print(response.json)

TypeScript

typescript

import axios from "axios";

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

 console.log(response.data);
}

main.catch(console.error);

响应示例

以下为根据原始文档整理后的示例结构，字段已保留核心层级与型。

json

{
 "version": "0.1.20241227",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "4.1038 sec.",
 "cost": 0.002,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "serp",
 "function": "live",
 "se": "google",
 "se_type": "finance_explore",
 "language_name": "English",
 "location_code": 2840,
 "device": "desktop",
 "os": "windows"
 },
 "result": [
 {
 "se_results_count": 0,
 "items_count": 7,
 "items": [
 {
 "type": "google_finance_hero_groups",
 "markets": [
 { "market": "US", "items": [] },
 { "market": "Europe", "items": [] },
 { "market": "Asia", "items": [] },
 { "market": "Currencies", "items": [] },
 { "market": "Crypto", "items": [] },
 { "market": "Futures", "items": [] }
 ]
 },
 {
 "type": "google_finance_interested",
 "rank_group": 1,
 "rank_absolute": 2,
 "items": []
 },
 {
 "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": "Exclusive: JPMorgan CEO Dimon derides in-office work pushback, demands efficiency",
 "url": "https://www.reuters.com/business/finance/jpmorgan-ceo-dimon-derides-in-office-work-pushback-demands-efficiency-2025-02-13/",
 "source": "Reuters",
 "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTBCsiJ1RT68LluPPfeUus4mAMGqZaibXdhtkqqsteaGyW6YmNraem5-kme3OI",
 "timestamp": "2025-02-13 09:02:55 +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": 131.14,
 "price_delta": -1.6600037,
 "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": "down",
 "timestamp": "2025-02-13 10:15:40 +00:00",
 "percentage_delta": -1.2500027
 },
 "news": null
 }
 ],
 "gainers": [
 {
 "type": "google_finance_market_trends_element",
 "quote": {
 "type": "google_finance_market_instrument_element",
 "ticker": "BBAI",
 "price": 9.74,
 "price_delta": 1.7399998,
 "price_currency": "USD",
 "identifier": "BBAI:NYSE",
 "displayed_name": "BigBear.ai Holdings Inc",
 "url": "https://google.com/finance/quote/BBAI:NYSE?hl=en&gl=us",
 "location": "America/New_York",
 "trend": "up",
 "timestamp": "2025-02-13 10:15:36 +00:00",
 "percentage_delta": 21.749996
 },
 "news": []
 }
 ],
 "losers": [
 {
 "type": "google_finance_market_trends_element",
 "quote": {
 "type": "google_finance_market_instrument_element",
 "ticker": "LYFT",
 "price": 13.25,
 "price_delta": -1.1400003,
 "price_currency": "USD",
 "identifier": "LYFT:NASDAQ",
 "displayed_name": "LYFT Inc",
 "url": "https://google.com/finance/quote/LYFT:NASDAQ?hl=en&gl=us",
 "location": "America/New_York",
 "trend": "down",
 "timestamp": "2025-02-13 10:13:22 +00:00",
 "percentage_delta": -7.92217
 },
 "news": []
 }
 ]
 }
 },
 {
 "type": "google_finance_interested",
 "rank_group": 2,
 "rank_absolute": 7,
 "items": []
 }
 ]
 }
 ]
 }
 ]
}

错误处理

建议对以下两层状态进行处理：

顶层状态

status_code
status_message

任务层状态

tasks[].status_code
tasks[].status_message

完整错误码和消息列表参考 /v3/appendix/errors。由于实时 SERP 数据可能受地区、语言、页面结构和可见结果数量影响，建议在生产环境中做好以下容错设计：

对非 20000 状态码进行重试或告警
对 items 为空、quotes 为 null 的做容
对不同 item_types 动态解析，写死页面结构
以 cost 字段记录消耗，便于审计和预算控制

实用场景

监控市场首页模块变化：定时抓取 google_finance_hero_groups、market_trends 等模块，追踪不同地区金融首页的变化，帮助金融站或投研产品发现热点切换。
采集财经新闻与标的：提取 google_finance_news 及的 quotes，构建“新闻—股票/指数/汇率”数据，用于舆分析和推荐。
发现热门上涨下跌标的：利用 gainers、losers、most_active 数据快速识别异动资产，选题、快讯生成或投顾看板更新。
分析地区化金融差异：切换 location_code 与 language_code，比较不同国家/语言环境下财经首页展示差异，为 SEO、金融媒体本地化运营提供依据。
挖掘用户链路：结合 most_followed、interested、people_also_search 模块，识别资产之间的联动，为专题页搭建和链接策略提供数据支持。

Google Finance Explore 实时高级版 ​

接口说明 ​

计费说明 ​

请求规则 ​

请求参数 ​

主要参数 ​

附加参数 ​

响应结构 ​

顶层字段 ​

任务级字段 ​

结果级字段 ​

SERP素说明 ​

1) google_finance_hero_groups ​

markets 数组字段 ​

A. google_finance_market_index_element ​

B. google_finance_asset_pair_element ​

C. 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 实时高级版

接口说明

计费说明

请求规则

请求参数

主要参数

附加参数

响应结构

顶层字段

任务级字段

结果级字段

SERP素说明

1) `google_finance_hero_groups`

`markets` 数组字段

A. `google_finance_market_index_element`

B. `google_finance_asset_pair_element`

C. `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

响应示例