Google Finance Markets 实时高级版

POST /v3/serp/google/finance_markets/live/advanced

接口概述

/v3/serp/google/finance_markets/live/advanced 用于实时获取 Google Finance「Markets」标签页的数据。返回会根据请求中指定的 location、language 和 market_type 变化。

该接口适合获取市场概览、板块趋势、以及金融标的信息。

请求方式：POST
接口地址：https://api.seermartech.cn/v3/serp/google/finance_markets/live/advanced
请求体格式：JSON
编码：UTF-8

计费与调用限制

本接口按请求计费。

参考价约 ¥0.0320 / 次
实扣费以响应头 X-SeerMarTech-Charge-CNY 为准

调用限制说明：

最大可发送 2000 次 API 请求/分钟
每个 Live SERP API 请求 1 个任务
POST 请求体为 JSON 数组格式：[{ ... }]

请求参数

主要参数

字段名	类型	说明
`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` 对象中原样返回
`market_type`	string	Google Finance 市场类型，可选。可用值：`most-active`、`indexes`、`indexes/americas`、`indexes/europe-middle-east-africa`、`indexes/asia-pacific`、`gainers`、`losers`、`climate-leaders`、`cryptocurrencies`、`currencies`。默认值：`most-active`

请求示例

cURL

bash

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

Python

python

import requests

url = "https://api.seermartech.cn/v3/serp/google/finance_markets/live/advanced"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
data = [
 {
 "location_code": 2840,
 "language_name": "English",
 "device": "desktop",
 "os": "windows",
 "market_type": "most-active"
 }
]

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

TypeScript

typescript

import axios from "axios";

async function fetchFinanceMarkets {
 const response = await axios.post(
 "https://api.seermartech.cn/v3/serp/google/finance_markets/live/advanced",
 [
 {
 location_code: 2840,
 language_name: "English",
 device: "desktop",
 os: "windows",
 market_type: "most-active"
 }
 ],
 {
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 }
 }
 );

 console.log(response.data);
}

fetchFinanceMarkets.catch(console.error);

响应结构

接口返回 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	任务数组

建议在接时对异常状态和错误码建立完整的重试、告警与容错机制。

`tasks[]` 字段

字段名	类型	说明
`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	与 POST 请求中提交的参数基本一致
`result`	array	结果数组

`result[]` 通用字段

字段名	类型	说明
`keyword`	string	POST 数组中接收的；若编码字符会自动解码，`+` 会被解码为空格
`type`	string	搜索引擎类型，此处固定为 `finance_markets`
`se_domain`	string	请求中的搜索引擎域名
`location_code`	string	请求中的地区代码
`language_code`	string	请求中的语言代码
`check_url`	string	可直接访问的搜索结果 URL，用于核验结果准确性
`datetime`	string	结果抓取时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`
`spell`	object	搜索引擎自动纠错信息；本接口通常为 `null`
`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_explore_market_trends
google_finance_news
google_finance_interested
google_finance_people_also_search

结果项说明

1. `google_finance_hero_groups`

Google Finance 市场概览模块。

字段名	类型	说明
`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	指定 `timestamp` 时刻的指数值
`index_value_delta`	float	相对上一读数的指数变化值
`identifier`	string	由 `ticker` 与 `market_identifier` 组成的完整标识，如 `PX1:INDEXDB`
`displayed_name`	string	页面展示名称，如 `CAC 40`
`url`	string	指向 Google Finance 指数页的 URL
`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	指定 `timestamp` 时刻的价格变化值
`identifier`	string	资产对标识，如 `EUR-USD`
`displayed_name`	string	展示名称，如 `EUR / USD`
`url`	string	资产对页 URL
`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	对应页 URL
`location`	string	所属市场位置
`trend`	string	趋势方向：`up`、`down`、`stable`
`timestamp`	string	数值读取时间，UTC 格式
`percentage_delta`	float	百分比变化值

2. `google_finance_explore_market_trends`

市场趋势探索模块。

字段名	类型	说明
`type`	string	固定为 `google_finance_explore_market_trends`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	SERP 中的绝对排名
`title`	string	模块标题，如 `Europe, Middle East, and Africa` 或 `Most active`
`sub_title`	string	模块副标题
`url`	string	对应市场趋势页 URL
`items`	array	与该趋势模块的指数、资产对或市场

items[] 子项结构与上文 google_finance_hero_groups 中的三类一致：

google_finance_market_index_element
google_finance_asset_pair_element
google_finance_market_instrument_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	模块副标题，如 `Based on Europe, Middle East, and Africa`
`items`	array	新闻文章列表

`google_finance_news.items[]`

字段名	类型	说明
`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_interested`

用户模块，通常由近期搜索、证券和用户活动生成。

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

items[] 可能以下类型：

google_finance_market_index_element
google_finance_market_instrument_element
google_finance_asset_pair_element

字段定义与前文相同。

5. `google_finance_people_also_search`

搜索金融标的模块。

字段名	类型	说明
`type`	string	固定为 `google_finance_people_also_search`
`items`	array	用户也会搜索的指数、或资产对

items[] 可能以下类型：

google_finance_market_index_element
google_finance_market_instrument_element
google_finance_asset_pair_element

字段定义与前文相同。

注意：示例响应中曾出现 google_finance_people_also_search_item 的写法，但字段说明中定义的标准类型为 google_finance_people_also_search。接时建议以返回值为准，并做好容处理。

响应示例

json

{
 "version": "0.1.20241227",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "3.0950 sec.",
 "cost": 0.002,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "serp",
 "function": "live",
 "se": "google",
 "se_type": "finance_markets",
 "language_name": "English",
 "location_code": 2840,
 "device": "desktop",
 "os": "windows"
 },
 "result": [
 {
 "se_results_count": 0,
 "items_count": 4,
 "items": [
 {
 "type": "google_finance_hero_groups",
 "markets": [
 { "market": "US", "items": [] },
 { "market": "Europe", "items": [] },
 { "market": "Asia", "items": [] },
 { "market": "Currencies", "items": [] },
 { "market": "Crypto", "items": [] }
 ]
 },
 {
 "type": "google_finance_explore_market_trends",
 "rank_group": 1,
 "rank_absolute": 2,
 "title": "Most active",
 "sub_title": "The stocks or funds with the highest trading volume (in shares) during the current trading session",
 "url": null,
 "items": []
 },
 {
 "type": "google_finance_news",
 "rank_group": 1,
 "rank_absolute": 3,
 "title": "In the news",
 "sub_title": "Based on most active",
 "items": [
 {
 "type": "google_finance_news_element",
 "title": "1 AI Stock to Buy Before It Soars 335% to $1 Trillion, According to a Wall nStreet Analyst",
 "url": "https://finance.yahoo.com/news/1-ai-stock-buy-soars-081000093.html",
 "source": "Yahoo Finance",
 "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRKC85EuzoaawfpMrY9qYJfX0e4gkZ3P22FIkUmzj_Ct6CSfwD02tZCK3zu4tA",
 "timestamp": "2025-02-07 08:10:00 +00:00",
 "quotes": []
 }
 ]
 },
 {
 "type": "google_finance_interested",
 "rank_group": 1,
 "rank_absolute": 4,
 "items": []
 },
 {
 "type": "google_finance_people_also_search_item",
 "items": []
 }
 ]
 }
 ]
 }
 ]
}

错误码说明

顶层 status_code 表示整次请求的处理状态
tasks[].status_code 表示单个任务状态
错误码与状态信息请参考：/v3/appendix/errors

建议重点处理以下场景：

参数缺失或参数格式错误
地区/语言代码无效
请求频率限
返回结果为空或结构变化
单任务成功但部分结果字段缺失

接说明

请求方法为 POST
请求体是 JSON 数组格式，且 Live 接口一次只能提交一个任务
location_code 与 location_name 二选一
language_code 与 language_name 二选一
若需核验采集结果，可使用响应中的 check_url
市场数据、新闻、搜索等模块未每次都完整返回，需按 item_types 和 items[].type 动态解析

实用场景

监控市场热点板块：按 market_type 拉取 most-active、gainers、losers 等模块，快速识别高市场主题，用于财经选题和舆预警。
跟踪区域市场表现：抓取 indexes/americas、indexes/europe-middle-east-africa、indexes/asia-pacific 等结果，对比不同地区指数波动，为市场分析提供依据。
提取新闻标的：读取 google_finance_news 中的 quotes 字段，将新闻与指数、期货或汇率对，提升聚类与事件归因能力。
构建金融趋势看板：解析 google_finance_hero_groups 和 google_finance_explore_market_trends，沉淀指数值、涨跌额和涨跌数据，用于可视化看板或日报自动生成。
发现金融链路：结合 google_finance_interested 与 google_finance_people_also_search，识别用户的资产，支持投研推荐和金融搜索需求扩展。

Google Finance Markets 实时高级版 ​

接口概述 ​

计费与调用限制 ​

请求参数 ​

主要参数 ​

附加参数 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应结构 ​

顶层字段 ​

tasks[] 字段 ​

result[] 通用字段 ​

item_types 可返回的结果类型 ​

结果项说明 ​

1. google_finance_hero_groups ​

markets[] ​

google_finance_market_index_element ​

google_finance_asset_pair_element ​

google_finance_market_instrument_element ​

2. google_finance_explore_market_trends ​

3. google_finance_news ​

google_finance_news.items[] ​

4. google_finance_interested ​

5. google_finance_people_also_search ​

响应示例 ​

错误码说明 ​

接说明 ​

实用场景 ​

Google Finance Markets 实时高级版

接口概述

计费与调用限制

请求参数

主要参数

附加参数

请求示例

cURL

Python

TypeScript

响应结构

顶层字段

`tasks[]` 字段

`result[]` 通用字段

`item_types` 可返回的结果类型

结果项说明

1. `google_finance_hero_groups`

`markets[]`

`google_finance_market_index_element`

`google_finance_asset_pair_element`

`google_finance_market_instrument_element`

2. `google_finance_explore_market_trends`

3. `google_finance_news`

`google_finance_news.items[]`

4. `google_finance_interested`

5. `google_finance_people_also_search`

响应示例

错误码说明

接说明

实用场景