按任务 ID 获取 Google Finance Ticker Search 高级结果

GET /v3/serp/google/finance_ticker_search/tasks_ready

本接口使用 GET 方法，通过以下路径获取指定任务的 Google Finance Ticker Search 高级结果：

text

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

Google Finance Ticker Search 用于查询 Google Finance 中可用的金融及附加信息。返回结果取决于创建任务时指定的以下参数：

keyword：名称或金融名称
location：查询地区
language：查询语言

，$id 为任务创建后返回的唯一任务标识符。

计费说明

创建任务时产生费用。
任务完成后，可在 30 天获取结果。
本接口本身不会因重复获取同一任务结果而重复计费。
实扣费以响应头 X-SeerMarTech-Charge-CNY 为准。平台限流以认证说明中的 30/60/120 次/分钟规则为准；每次实时 SERP API 调用只能一个任务。
所有 POST 请求体均须使用 UTF-8 编码的 JSON 数组格式，例如：

json

[
  {
    "keyword": "DJ",
    "location_code": 2840,
    "language_code": "en",
    "device": "desktop",
    "os": "windows"
  }
]

请求参数

路径参数如下：

参数	类型	说明
`id`	string	任务唯一标识符，UUID 格式。任务创建后返回，可在 30 天用于获取任务结果。

请求示例

cURL

bash

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

curl --location --request GET \
  "https://api.seermartech.cn/v3/serp/google/finance_ticker_search/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 = (
    "https://api.seermartech.cn/v3/serp/google/"
    "finance_ticker_search/task_get/advanced/" + task_id
)

response = requests.get(
    url,
    headers={
        "Authorization": "Bearer smt_live_YOUR_KEY",
        "Content-Type": "application/json",
    },
)

print(response.json())

TypeScript

typescript

import axios from "axios";

const taskId = "02231256-2604-0066-0000-c27d02864073";

axios
  .get(
    `https://api.seermartech.cn/v3/serp/google/finance_ticker_search/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 对象 tasks 数组。每个任务对象对应一个任务的执行状态及结果。

顶层响应字段

字段	类型	说明
`version`	string	当前 API 版本。
`status_code`	integer	通用响应状态码。建议根据状态码处理异常。
`status_message`	string	通用状态说明。
`time`	string	请求执行耗时，单位为秒。
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`tasks_count`	integer	`tasks` 数组中的任务数量。
`tasks_error`	integer	`tasks` 数组中返回错误的任务数量。
`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	请求路径信息。
`data`	object	创建任务时提交的参数。
`result`	array	SERP 结果数组。

`result` 字段

字段	类型	说明
`keyword`	string	创建任务时提交的。返回时会对经过 URL 编码的进行解码；加号 `+` 会解码为空格。
`type`	string	搜索类型。本接口固定为 `finance_ticker_search`。
`se_domain`	string	创建任务时使用的搜索引擎域名。
`location_code`	string	创建任务时使用的地区代码。
`language_code`	string	创建任务时使用的语言代码。
`check_url`	string	对应搜索引擎结果页的直接 URL，可用于核验结果准确性。
`datetime`	string	获取结果的 UTC 时间，格式为 `yyyy-mm-dd hh-mm-ss +00:00`。例如：`2019-11-15 12:57:46 +00:00`。
`spell`	object	搜索引擎自动纠错信息。如果搜索引擎对进行了纠正，该字段会记录纠正后的及纠错类型。
`refinement_chips`	object	搜索细化选项。本接口中通常为 `null`。
`item_types`	array	SERP 中的结果类型。可能：`google_finance_market_index`、`google_finance_asset_pair`、`google_finance_market_instrument`。
`se_results_count`	integer	SERP 中的结果总数。
`items_count`	integer	`items` 数组中的结果数量。
`items`	array	SERP 中返回的金融结果项目。

`items` 项目类型

`google_finance_market_index`

表示市场指数项目。

字段	类型	说明
`type`	string	项目类型，固定为 `google_finance_market_index`。
`rank_group`	integer	同类型项目中的分组排名。不同类型项目不会参与该排名。
`rank_absolute`	integer	项目在整个 SERP 中的绝对排名。
`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	Google Finance 市场指数页面 URL。
`location`	string	市场指数所属地区。例如：`Europe/Paris`。
`trend`	string	市场指数趋势。可能值：`up`、`down`、`stable`。
`timestamp`	string	指数值的读取时间，使用 UTC 格式。例如：`2025-02-10 09:40:00 +00:00`。
`percentage_delta`	float	市场指数的百分比变化。

`google_finance_asset_pair`

表示资产交易对项目。

字段	类型	说明
`type`	string	项目类型，固定为 `google_finance_asset_pair`。
`rank_group`	integer	同类型项目中的分组排名。
`rank_absolute`	integer	项目在整个 SERP 中的绝对排名。
`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	Google Finance 展示的交易对名称。例如：`EUR / USD`。
`url`	string	Google Finance 资产交易对页面 URL。
`location`	string	市场所在地区。
`trend`	string	价格趋势。可能值：`up`、`down`、`stable`。
`timestamp`	string	价格读取时间，使用 UTC 格式。例如：`2025-02-10 09:40:00 +00:00`。
`percentage_delta`	float	价格的百分比变化。

`google_finance_market_instrument`

表示市场金融项目。

字段	类型	说明
`type`	string	项目类型，固定为 `google_finance_market_instrument`。
`rank_group`	integer	同类型项目中的分组排名。
`rank_absolute`	integer	项目在整个 SERP 中的绝对排名。
`ticker`	string	金融代码。例如：`YMW00`。
`price`	float	指定时间点的金融价格。
`price_delta`	float	指定时间点的价格变化量。
`price_currency`	string	价格货币。例如：`USD`。
`identifier`	string	金融完整标识符。例如：`YMW00:CBOT`。
`displayed_name`	string	Google Finance 展示的金融名称。例如：`E-mini Dow ($5)`。
`url`	string	Google Finance 金融页面 URL。
`location`	string	金融所属地区。
`trend`	string	价格趋势。可能值：`up`、`down`、`stable`。
`timestamp`	string	价格读取时间，使用 UTC 格式。例如：`2025-02-10 09:40:00 +00:00`。
`percentage_delta`	float	价格的百分比变化。

响应示例

json

{
  "version": "0.1.20241227",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0926 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "02261816-2027-0066-0000-c27d02864073",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0812 sec.",
      "cost": 0,
      "result_count": 1,
      "path": [
        "v3",
        "serp",
        "google",
        "finance_ticker_search",
        "task_get",
        "advanced"
      ],
      "data": {
        "api": "serp",
        "function": "task_get",
        "se": "google",
        "se_type": "finance_ticker_search",
        "language_name": "English",
        "location_code": 2840,
        "category": "all",
        "keyword": "DJ",
        "priority": 2,
        "device": "desktop",
        "os": "windows"
      },
      "result": [
        {
          "keyword": "DJ",
          "type": "finance_ticker_search",
          "se_domain": "google.com",
          "location_code": 2840,
          "language_code": "en",
          "check_url": "https://www.google.com/finance",
          "datetime": "2025-02-10 09:40:00 +00:00",
          "spell": null,
          "refinement_chips": null,
          "item_types": [
            "google_finance_market_index",
            "google_finance_asset_pair",
            "google_finance_market_instrument"
          ],
          "se_results_count": 0,
          "items_count": 4,
          "items": []
        }
      ]
    }
  ]
}

任务结果获取流程

如果使用异步任务模式，可调用以下接口获取已完成任务列表：

text

GET /v3/serp/google/finance_ticker_search/tasks_ready

随后，从返回结果中读取任务 ID，并调用本接口：

text

GET /v3/serp/google/finance_ticker_search/task_get/advanced/$id

建议在任务状态为成功且 result 不为空时处理结果；对于状态码大于或等于 40000 的任务，应记录 status_code 和 status_message 并执行异常处理。

错误处理

接口响应中的以下字段用于判断请求和任务状态：

顶层 status_code：判断整体请求是否成功。
任务级 tasks[].status_code：判断单个任务是否成功。
status_message：获取对应的状态说明。
tasks_error：统计返回错误的任务数量。

建议客户端实现以下处理逻辑：

检查 HTTP 状态码及顶层 status_code。
遍历 tasks 数组，单独判断每个任务的状态。
对状态码大于或等于 40000 的任务记录错误信息。
在 result 为空时直接解析 items。
对网络时、限流和服务端错误执行重试，并设置最大重试次数。

实用场景

监控市场指数的 SERP 展示：定期查询行业指数及排名变化，金融团队评估搜索和布局。
追踪货币交易对价格趋势：获取指定资产交易对的价格、涨跌和趋势，为财经资讯、投资或市场看板提供数据。
识别金融搜索结果：提取股票、期货及金融的代码、价格和展示名称，支持金融垂直站点自动生成结构化信息。
对比不同地区和语言的金融搜索结果：使用不同 location 与 language 参数分析本地化 SERP 差异，优化多地区金融策略。
构建财经 SERP 监测报表：结合 rank_group、rank_absolute、item_types 和 percentage_delta，分析金融搜索结果构成及市场变化。

按任务 ID 获取 Google Finance Ticker Search 高级结果 ​

计费说明 ​

请求参数 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应结构 ​

顶层响应字段 ​

任务字段 ​

result 字段 ​

items 项目类型 ​

google_finance_market_index ​

google_finance_asset_pair ​

google_finance_market_instrument ​

响应示例 ​

任务结果获取流程 ​

错误处理 ​

实用场景 ​

按任务 ID 获取 Google Finance Ticker Search 高级结果

计费说明

请求参数

请求示例

cURL

Python

TypeScript

响应结构

顶层响应字段

任务字段

`result` 字段

`items` 项目类型

`google_finance_market_index`

`google_finance_asset_pair`

`google_finance_market_instrument`

响应示例

任务结果获取流程

错误处理

实用场景