Google Finance Explore 实时高级接口

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

本接口使用 POST 方法，请求路径为：

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

Live Google Finance Explore Advanced 用于实时获取 Google Finance「探索」页中的金融市场数据、财经新闻、市场趋势、财报日历以及用户可能感的金融资产。返回结果取决于请求中的位置和语言参数。

接口信息

请求方法：POST
请求地址：https://api.seermartech.cn/v3/serp/google/finance_explore/live/advanced
请求格式：JSON，字符编码为 UTF-8
任务数量：每次请求支持 1 个任务平台限流以认证说明中的 30/60/120 次/分钟规则为准/分钟
认证方式：Bearer Token
参考价：约 ¥0.0144 / 次
当 news_type 为 local_market 或 world_markets 时，单任务费用乘以 2。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

> 请求体是 JSON 数组，数组中任务对象。

认证

请求头示例：

http

Authorization: Bearer smt_live_YOUR_KEY
Content-Type: application/json

请求参数

主要参数

参数	类型	填	说明
`location_code`	integer	条件填	搜索引擎位置代码。未指定 `location_name` 时填。使用此参数后无需再传 `location_name`。示例：`2840`。
`language_code`	string	条件填	搜索引擎语言代码。未指定 `language_name` 时填。使用此参数后无需再传 `language_name`。示例：`en`。
`device`	string	否	设备类型。可选值：`desktop`。

位置和语言代码可通过以下接口获取：

/v3/serp/google/locations
/v3/serp/google/languages

附加参数

参数	类型	填	说明
`location_name`	string	条件填	搜索引擎位置的完整名称。未指定 `location_code` 时填。示例：`London,England,United Kingdom`。
`language_name`	string	条件填	搜索引擎语言的完整名称。未指定 `language_code` 时填。示例：`English`。
`os`	string	否	设备操作系统。可选值：`windows`。
`tag`	string	否	自定义任务标识，最长 255 个字符。可用于请求和响应，返回在任务的 `data` 对象中。
`news_type`	string	否	财经新闻筛选方式。可选值：`top_stories`、`local_market`、`world_markets`。默认值：`top_stories`。使用 `local_market` 或 `world_markets` 时，单任务费用乘以 2。

location_code 与 location_name 二选一；language_code 与 language_name 二选一。

请求示例

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",
      "device": "desktop",
      "os": "windows",
      "news_type": "top_stories",
      "tag": "finance-explore-demo"
    }
  ]'

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",
}

# 每次请求只能提交一个任务
payload = [
    {
        "location_code": 2840,
        "language_name": "English",
        "device": "desktop",
        "os": "windows",
        "news_type": "top_stories",
        "tag": "finance-explore-demo",
    }
]

response = requests.post(url, headers=headers, json=payload)
result = response.json()

if result.get("status_code") == 20000:
    print(result)
else:
    print(
        f"请求失败，错误码：{result.get('status_code')}，"
        f"错误信息：{result.get('status_message')}"
    )

TypeScript

typescript

import axios from "axios";

const response = await axios.post(
  "https://api.seermartech.cn/v3/serp/google/finance_explore/live/advanced",
  [
    {
      location_code: 2840,
      language_name: "English",
      device: "desktop",
      os: "windows",
      news_type: "top_stories",
      tag: "finance-explore-demo",
    },
  ],
  {
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
  }
);

console.log(response.data);

响应结构

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

顶层字段

字段	类型	说明
`version`	string	当前 API 版本。
`status_code`	integer	通用响应状态码。成功通常为 `20000`。
`status_message`	string	通用状态信息。
`time`	string	请求执行耗时，例如 `4.1038 sec.`。
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`tasks_count`	integer	`tasks` 数组中的任务总数。
`tasks_error`	integer	返回错误的任务数量。
`tasks`	array	任务结果数组。

任务字段

字段	类型	说明
`id`	string	任务唯一标识，UUID 格式。
`status_code`	integer	任务状态码，通常在 `10000` 至 `60000` 范围。
`status_message`	string	任务状态信息。
`time`	string	任务执行耗时。
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`result_count`	integer	`result` 数组中的数量。
`path`	array	请求 URL 路径。
`data`	object	请求中提交的参数。
`result`	array	SERP 结果数组。

结果字段

字段	类型	说明
`keyword`	string	POST 数组中的。返回时会对编码进行解码，`+` 会被解码为空格。
`type`	string	搜索引擎类型，本接口固定为 `finance_explore`。
`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	搜索引擎自动纠错信息。若被纠正，将返回纠正后的和纠错类型。
`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 结果项

所有结果项通常以下通用字段：

字段	类型	说明
`type`	string	结果项类型。
`rank_group`	integer	同类型结果中的组排名。不同类型结果不会影响该字段。
`rank_absolute`	integer	在整个 SERP 中的绝对排名。

`google_finance_hero_groups`

金融市场概览分组，不同市场的指数、资产对和金融。

字段	类型	说明
`markets`	array	金融市场数据数组。
`markets[].market`	string	市场标识，可选值：`US`、`Europe`、`Asia`、`Currencies`、`Crypto`、`Futures`。
`markets[].items`	array	市场指数、资产对或金融数据。

`google_finance_interested`

根据近期搜索、的证券及活动生成的感市场指数列表。

字段	类型	说明
`items`	array	市场资产列表。
`items[].type`	string	可为 `google_finance_asset_pair_element`、`google_finance_market_instrument_element` 或 `google_finance_market_index_element`。

`google_finance_news`

财经新闻模块。

字段	类型	说明
`title`	string	新闻模块标题，例如 `In the news`。
`sub_title`	string	新闻模块副标题。
`items`	array	财经新闻文章列表。

新闻文章字段：

字段	类型	说明
`type`	string	固定为 `google_finance_news_element`。
`title`	string	新闻标题。
`url`	string	新闻文章 URL。
`source`	string	新闻来源网站名称。
`image_url`	string	新闻主图 URL。
`timestamp`	string	新闻时间，UTC 格式。
`quotes`	array / null	新闻中引用的市场指数、金融或资产对。

`google_finance_earnings_calendar`

财报日历模块。

字段	类型	说明
`items`	array	财报日历项目列表。
`items[].type`	string	固定为 `google_finance_earnings_calendar_element`。
`items[].title`	string	财报日历项目标题。
`items[].url`	string	财报日历页面 URL。
`items[].timestamp`	string	数据读取时间，UTC 格式。

`google_finance_most_followed`

度最高的金融资产列表。

字段	类型	说明
`items`	array	资产列表。
`items[].type`	string	可为资产对、金融或市场指数类型。

`google_finance_market_trends`

市场趋势模块，活跃度最高、上涨和下跌资产。

字段	类型	说明
`items`	object	含 `most_active`、`gainers`、`losers` 三个数组。
`items.most_active`	array	活跃度最高的资产。
`items.gainers`	array	涨最大的资产。
`items.losers`	array	跌最大的资产。
`items.*[].type`	string	固定为 `google_finance_market_trends_element`。
`items.*[].quote`	object	被引用的资产、金融或市场指数。
`items.*[].news`	array / null	与该市场趋势项目的财经新闻。

`google_finance_people_also_search`

用户也搜索的金融资产列表。

字段	类型	说明
`items`	array	市场指数、资产对或金融列表。
`items[].type`	string	可为 `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	素完整标识，由 `ticker` 和 `market_identifier` 组成，例如 `PX1:INDEXDB`。
`displayed_name`	string	Google Finance 展示的指数名称，例如 `CAC 40`。
`url`	string	市场指数页 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	指定时间点的价格变化量。
`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	指定时间点的金融价格。
`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	价格变化百分比。

新闻引用数据

财经新闻中的 quotes 数组，以及市场趋势中的 quote 对象，可以以下三类：

google_finance_market_index_element
google_finance_market_instrument_element
google_finance_asset_pair_element

字段结构与金融数据章节一致。部分新闻或趋势项目没有引用数据时，字段值为 null。

响应示例

json

{
  "version": "0.1.20241227",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "4.1038 sec.",
  "cost": 0.0144,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "4.1038 sec.",
      "cost": 0.0144,
      "result_count": 1,
      "path": [
        "v3",
        "serp",
        "google",
        "finance_explore",
        "live",
        "advanced"
      ],
      "data": {
        "api": "serp",
        "function": "live",
        "se": "google",
        "se_type": "finance_explore",
        "language_name": "English",
        "location_code": 2840,
        "device": "desktop",
        "os": "windows"
      },
      "result": [
        {
          "keyword": "",
          "type": "finance_explore",
          "se_domain": "google.com",
          "location_code": "2840",
          "language_code": "en",
          "check_url": "https://www.google.com/finance",
          "datetime": "2025-02-13 10:15:40 +00:00",
          "spell": null,
          "refinement_chips": null,
          "item_types": [
            "google_finance_hero_groups",
            "google_finance_news",
            "google_finance_market_trends"
          ],
          "se_results_count": 0,
          "items_count": 3,
          "items": [
            {
              "type": "google_finance_market_trends",
              "rank_group": 1,
              "rank_absolute": 1,
              "items": {
                "most_active": [],
                "gainers": [],
                "losers": []
              }
            },
            {
              "type": "google_finance_news",
              "rank_group": 1,
              "rank_absolute": 2,
              "title": "Today's financial news",
              "sub_title": null,
              "items": [
                {
                  "type": "google_finance_news_element",
                  "title": "示例财经新闻标题",
                  "url": "https://example.com/news",
                  "source": "Example News",
                  "image_url": "https://example.com/image.jpg",
                  "timestamp": "2025-02-13 09:02:55 +00:00",
                  "quotes": null
                }
              ]
            },
            {
              "type": "google_finance_earnings_calendar",
              "rank_group": 1,
              "rank_absolute": 3,
              "items": []
            }
          ]
        }
      ]
    }
  ]
}

错误处理

请同时检查以下状态字段：

顶层 status_code
任务级 tasks[].status_code
顶层 tasks_error
status_message

成功状态码通常为 20000。完整错误码和状态信息请参考错误码文档。

建议在业务系统中针对以下进行处理：

HTTP 请求失败或时；
顶层状态码异常；
单个任务返回错误；
result 为空或部分结果字段为 null；
平台金融数据暂时不可用。

实用场景

监测目标市场的指数、货币对和金融趋势，为金融行业 SEO更新和市场专题页提供实时数据。
采集财经新闻标题、来源和引用资产，构建金融资讯聚合页面并提升新闻覆盖率。
追踪涨最大、跌最大和交易最活跃的资产，生成市场热点报告，选题和运营。
整理财报日历与度最高的资产，规划企业、行业和投资主题的搜索。
比较不同位置与语言下的 Google Finance 结果，评估区域化金融展示差异并优化本地 SEO 策略。

Google Finance Explore 实时高级接口 ​

接口信息 ​

认证 ​

请求参数 ​

主要参数 ​

附加参数 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应结构 ​

顶层字段 ​

任务字段 ​

结果字段 ​

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 ​

金融数据 ​

市场指数：google_finance_market_index_element ​

资产对：google_finance_asset_pair_element ​

金融：google_finance_market_instrument_element ​

新闻引用数据 ​

响应示例 ​

错误处理 ​

实用场景 ​