SeerMarTech API 文档

主题

Google Finance 市场实时高级接口 ​

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

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

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

本接口实时获取 Google Finance「市场」标签页中的金融市场数据。返回结果由请求中的 location、language 和 market_type 等参数决定。

所有请求体使用 UTF-8 编码的 JSON 格式，并以 JSON 数组提交任务。每次调用支持一个任务；平台限流以认证说明中的 30/60/120 次/分钟规则为准。

计费说明 ​

每次请求均会产生费用。

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

请求参数 ​

主要参数 ​

参数类型填说明
location_codeinteger条件填搜索引擎地区代码。如果未指定 location_name，则填写此参数。填写后无需再填写 location_name。可通过 /v3/serp/google/locations 获取可用地区及代码。示例：2840
language_codestring条件填搜索引擎语言代码。如果未指定 language_name，则填写此参数。填写后无需再填写 language_name。可通过 /v3/serp/google/languages 获取可用语言及代码。示例：en
devicestring否设备类型。可选值：desktop。

附加参数 ​

参数类型填说明
location_namestring条件填搜索引擎地区的完整名称。如果未指定 location_code，则填写此参数。填写后无需再填写 location_code。可通过 /v3/serp/google/locations 获取可用地区名称。示例：London,England,United Kingdom
language_namestring条件填搜索引擎语言的完整名称。如果未指定 language_code，则填写此参数。填写后无需再填写 language_code。可通过 /v3/serp/google/languages 获取可用语言名称。示例：English
osstring否设备操作系统。可选值：windows。
tagstring否自定义任务标识，最长 255 个字符。可用于识别任务并将请求与响应匹。提交的值会在响应的 data 对象中返回。
market_typestring否Google Finance 市场类型。可选值：most-active、indexes、indexes/americas、indexes/europe-middle-east-africa、indexes/asia-pacific、gainers、losers、climate-leaders、cryptocurrencies、currencies。默认值：most-active。

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

请求示例 ​

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

# 每次请求提交一个任务
payload = [
    {
        "location_code": 2840,
        "language_name": "English",
        "device": "desktop",
        "os": "windows",
        "market_type": "most-active",
    }
]

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

if result.get("status_code") == 20000:
    print(result)
else:
    print(
        "请求失败，状态码：%s，消息：%s"
        % (result.get("status_code"), result.get("status_message"))
    )

TypeScript ​

typescript
import axios from "axios";

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

const result = response.data;

if (result.status_code === 20000) {
  console.log(result);
} else {
  console.error(
    `请求失败，状态码：${result.status_code}，消息：${result.status_message}`
  );
}

响应结构 ​

接口返回 JSON 数据，顶层 tasks 数组。每个任务对应一个请求任务。

顶层字段 ​

字段类型说明
versionstring当前 API 版本。
status_codeinteger通用响应状态码。完整状态码列表请参考错误码文档。
status_messagestring通用响应说明。
timestring请求执行耗时，单位为秒。
costfloat平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
tasks_countintegertasks 数组中的任务数量。
tasks_errorinteger返回错误的任务数量。
tasksarray任务结果数组。

任务字段 ​

字段类型说明
idstring任务唯一标识，采用 UUID 格式。
status_codeinteger任务状态码，通常在 10000 至 60000 范围。
status_messagestring任务状态说明。
timestring任务执行耗时，单位为秒。
costfloat平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
result_countintegerresult 数组中的数量。
patharray请求 URL 路径信息。
dataobject请求中提交的参数。
resultarray当前任务的搜索结果。

result 字段 ​

字段类型说明
keywordstringPOST 数组中提交的。返回时会对编码后的 %## 进行解码，字符 + 会解码为空格。对于市场接口，该字段通常为空或不适用。
typestring搜索引擎类型。本接口固定为 finance_markets。
se_domainstring请求中指定的搜索引擎域名。
location_codestring请求中的地区代码。
language_codestring请求中的语言代码。
check_urlstring搜索结果页面的直接 URL，可用于核验返回结果。
datetimestring获取结果的 UTC 时间，格式为 yyyy-MM-dd hh-mm-ss +00:00。示例：2019-11-15 12:57:46 +00:00。
spellobject/null搜索引擎自动纠错信息。本接口通常为 null。
refinement_chipsobject/null搜索筛选标签。本接口通常为 null。
item_typesarraySERP 中的结果类型。可能：google_finance_hero_groups、google_finance_explore_market_trends、google_finance_news、google_finance_interested、google_finance_people_also_search。
se_results_countintegerSERP 中的结果总数。
items_countintegeritems 数组中的结果数量。
itemsarraySERP 中返回的结果。

SERP 结果 ​

市场概览：google_finance_hero_groups ​

该按市场区域组织的指数、资产对和金融数据。

字段类型说明
typestring固定为 google_finance_hero_groups。
rank_groupinteger同类型中的分组排名。不同类型不会用此排名。
rank_absoluteinteger所有 SERP素中的绝对排名。
marketsarray金融市场数据数组。

markets 中的字段：

字段类型说明
marketstring金融市场标识。可能值：US、Europe、Asia、Currencies、Crypto、Futures。
itemsarray当前市场下的指数、资产对或金融。
字段类型说明
typestring固定为 google_finance_explore_market_trends。
rank_groupinteger同类型中的分组排名。
rank_absoluteinteger所有 SERP素中的绝对排名。
titlestring市场趋势模块标题。示例：Europe, Middle East, and Africa。
sub_titlestring市场趋势模块副标题。
urlstring/null市场趋势页面 URL。
itemsarray与该市场趋势的市场数据。

财经新闻：google_finance_news ​

字段类型说明
typestring固定为 google_finance_news。
rank_groupinteger同类型中的分组排名。
rank_absoluteinteger所有 SERP素中的绝对排名。
titlestring新闻模块标题。示例：In the news。
sub_titlestring新闻模块副标题。示例：Based on most active。
itemsarray财经新闻文章数组。

新闻文章字段：

字段类型说明
typestring固定为 google_finance_news_element。
titlestring新闻标题。
urlstring新闻文章 URL。
sourcestring新闻来源名称，即发布文章的网站名称。
image_urlstring新闻文章的主图 URL。
timestampstring新闻时间，UTC 格式。
quotesarray新闻中提及的市场指数、金融或资产对。

个性化市场：google_finance_interested ​

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

字段类型说明
typestring固定为 google_finance_interested。
rank_groupinteger同类型中的分组排名。
rank_absoluteinteger所有 SERP素中的绝对排名。
itemsarray个性化市场数据数组。
字段类型说明
typestring通常为 google_finance_people_also_search。
itemsarray搜索市场数据数组。

市场数据项 ​

google_finance_hero_groups、google_finance_explore_market_trends、google_finance_interested、google_finance_people_also_search 以及新闻的 quotes 数组中，可能出现以下三类数据项：

  • google_finance_market_index_element：市场指数
  • google_finance_market_instrument_element：市场金融
  • google_finance_asset_pair_element：资产交易对

市场指数：google_finance_market_index_element ​

字段类型说明
typestring固定为 google_finance_market_index_element。
tickerstring市场指数代码。示例：DAX。
market_identifierstring市场标识。示例：INDEXDB。
index_valuefloat指定时间点的指数数值。
index_value_deltafloat指定时间点指数数值的变化量。
identifierstring素完整标识，由 ticker 和 market_identifier 组成。示例：PX1:INDEXDB。
displayed_namestring页面展示的市场指数名称。示例：CAC 40。
urlstringGoogle Finance 中该市场指数的页面 URL。
locationstring市场指数所属地区。示例：Europe/Paris。
trendstring指数趋势。可选值：up、down、stable。
timestampstring数值读取时间，UTC 格式。示例：2025-02-10 09:40:00 +00:00。
percentage_deltafloat指数数值的百分比变化。

金融：google_finance_market_instrument_element ​

字段类型说明
typestring固定为 google_finance_market_instrument_element。
tickerstring金融代码。示例：YMW00。
pricefloat指定时间点的金融价格。
price_deltafloat指定时间点的价格变化量。
price_currencystring价格货币。示例：USD。
identifierstring金融完整标识。示例：YMW00:CBOT。
displayed_namestring页面展示的金融名称。示例：E-mini Dow ($5)。
urlstringGoogle Finance 中该金融的页面 URL。
locationstring金融所属地区。
trendstring价格趋势。可选值：up、down、stable。
timestampstring价格读取时间，UTC 格式。
percentage_deltafloat价格的百分比变化。

资产交易对：google_finance_asset_pair_element ​

字段类型说明
typestring固定为 google_finance_asset_pair_element。
base_symbolstring基础资产代码。示例：EUR。
quote_symbolstring报价资产代码。示例：USD。
base_display_namestring基础资产名称。示例：Euro。
quote_display_namestring报价资产名称。
pricefloat基础资产相对于报价资产的价格。
price_deltafloat价格变化量。
identifierstring资产交易对标识。示例：EUR-USD。
displayed_namestring页面展示的交易对名称。示例：EUR / USD。
urlstringGoogle Finance 中该交易对的页面 URL。
locationstring资产交易对所属市场地区。
trendstring价格趋势。可选值：up、down、stable。
timestampstring价格读取时间，UTC 格式。
percentage_deltafloat价格的百分比变化。

响应示例 ​

json
{
  "version": "0.1.20241227",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "3.0950 sec.",
  "cost": 0.0144,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "3.0000 sec.",
      "cost": 0.0144,
      "result_count": 1,
      "path": [
        "v3",
        "serp",
        "google",
        "finance_markets",
        "live",
        "advanced"
      ],
      "data": {
        "api": "serp",
        "function": "live",
        "se": "google",
        "se_type": "finance_markets",
        "language_name": "English",
        "location_code": 2840,
        "device": "desktop",
        "os": "windows",
        "market_type": "most-active"
      },
      "result": [
        {
          "se_results_count": 0,
          "items_count": 4,
          "item_types": [
            "google_finance_hero_groups",
            "google_finance_explore_market_trends",
            "google_finance_news",
            "google_finance_interested"
          ],
          "items": [
            {
              "type": "google_finance_hero_groups",
              "rank_group": 1,
              "rank_absolute": 1,
              "markets": [
                {
                  "market": "US",
                  "items": [
                    {
                      "type": "google_finance_market_index_element",
                      "ticker": "DAX",
                      "market_identifier": "INDEXDB",
                      "index_value": 22130.58,
                      "index_value_delta": 35.21,
                      "identifier": "PX1:INDEXDB",
                      "displayed_name": "CAC 40",
                      "url": "https://www.google.com/finance",
                      "location": "Europe/Paris",
                      "trend": "up",
                      "timestamp": "2025-02-10 09:40:00 +00:00",
                      "percentage_delta": 0.16
                    }
                  ]
                }
              ]
            },
            {
              "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",
              "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": "示例财经新闻标题",
                  "url": "https://example.com/news",
                  "source": "示例新闻来源",
                  "image_url": "https://example.com/image.jpg",
                  "timestamp": "2025-02-07 08:10:00 +00:00",
                  "quotes": []
                }
              ]
            },
            {
              "type": "google_finance_interested",
              "rank_group": 1,
              "rank_absolute": 4,
              "items": []
            }
          ]
        }
      ]
    }
  ]
}

错误处理 ​

请根据顶层 status_code 和任务级 status_code 判断请求是否成功：

  • 20000：请求成功。
  • 非 20000：请求或任务处理失败，应结合对应的 status_message 定位问题。

建议在业务系统中同时处理以下：

  • HTTP 请求失败；
  • 顶层响应状态异常；
  • 单个任务处理失败；
  • result 为空；
  • 市场数据或新闻数据暂时缺失；
  • 搜索结果结构发生变化。

完整错误码和状态说明请参考错误码文档。

实用场景 ​

  • 监控目标市场指数与资产价格变化，及时发现上涨、下跌或横盘趋势，为财经和行业 SEO 选题提供实时依据。
  • 采集不同地区的热门市场与活跃资产，比较美国、欧洲、亚洲等市场的度，支持区域化规划和市场研究。
  • 追踪财经新闻及引用的指数或金融，建立“新闻—资产—市场”数据，用于舆分析和专题页面生成。
  • 对比货币、加密资产及期货交易对的价格变化，识别跨市场热点，为金融行业监测和竞争分析提供数据。
  • 按语言、地区和市场类型生成 SERP 快，评估不同本地化下的财经搜索结果差异，优化 SEO 和区域落地页策略。

统一入口：官网 · LLM API · 控制台

© 2026 SeerMarTech · GEO · SEO 营销数据 API