设置 Google Finance Markets SERP 任务

POST /v3/serp/google/finance_markets/task_post

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

/v3/serp/google/finance_markets/task_post

Google Finance Markets API 用于获取 Google Finance「市场」标签页中的实时数据。返回结果由请求中的 location、language 和 market_type 参数决定。

计费与请求限制

每个任务请求都会产生费用。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求体使用 UTF-8 编码的 JSON 格式，并以 JSON 数组提交：

平台限流以认证说明中的 30/60/120 次/分钟规则为准。

单次 POST 请求最多 100 个任务。 -过 100 个任务的部分将返回错误码 40006。
任务创建成功后，可通过响应中的任务 id 获取结果。
也可以在创建任务时 pingback_url 或 postback_url，在任务完成后接收通知或结果。

如果通知服务器在 10 秒未返回响应，连接将因时中断，任务会转移到任务就绪列表。建议为回调接口实现时处理、幂等处理和异常重试机制。

请求参数

主要参数

字段名	类型	说明
`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`。
`pingback_url`	string	任务完成通知地址，可选。任务完成后，本平台将向该地址发送 GET 请求。URL 中可使用 `$id` 作为任务 ID 占位符，使用 `$tag` 作为经过 URL 编码的标签占位符。例如：`https://your-server.com/pingscript?id=$id&tag=$tag`。特殊字符会进行 URL 编码，例如 `#` 会编码为 `%23`。
`postback_url`	string	任务结果接收地址，可选。任务完成后，本平台将以 POST 方式向该地址发送结果，结果使用 gzip 压缩。URL 中可使用 `$id` 和 `$tag` 占位符。例如：`https://your-server.com/postbackscript?id=$id&tag=$tag`。特殊字符会进行 URL 编码。
`postback_data`	string	`postback_url` 返回数据类型。当指定 `postback_url` 时提供。可选值：`advanced`、`html`。
`priority`	integer	任务优级，可选。`1`：普通优级，默认值；`2`：高优级。高优级任务可能产生额外费用，扣费以响应头 `X-SeerMarTech-Charge-CNY` 为准。

附加参数

字段名	类型	说明
`location_name`	string	搜索引擎地区的完整名称。如果未指定 `location_code`，则提供此字段。提供此字段后无需再提供 `location_code`。例如：`London,England,United Kingdom`。
`language_name`	string	搜索引擎语言的完整名称。如果未指定 `language_code`，则提供此字段。提供此字段后无需再提供 `language_code`。例如：`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`。

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

请求示例

cURL

bash

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

Python

python

import requests

url = "https://api.seermartech.cn/v3/serp/google/finance_markets/task_post"

headers = {
    "Authorization": "Bearer smt_live_YOUR_KEY",
    "Content-Type": "application/json",
}

# 请求体是 JSON 数组
payload = [
    {
        "location_code": 2840,
        "language_name": "English",
        "market_type": "most-active",
        "device": "desktop",
        "os": "windows",
    },
    {
        "location_code": 2840,
        "language_name": "English",
        "priority": 2,
        "tag": "finance_markets_demo",
        "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag",
    },
]

response = requests.post(url, headers=headers, json=payload, timeout=30)
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 url =
  "https://api.seermartech.cn/v3/serp/google/finance_markets/task_post";

const payload = [
  {
    location_code: 2840,
    language_name: "English",
    market_type: "most-active",
    device: "desktop",
    os: "windows",
  },
];

axios
  .post(url, payload, {
    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	请求的通用状态码。成功时通常为 `20000`。完整状态码列表请参考错误码文档。
`status_message`	string	请求的通用说明信息。
`time`	string	请求执行耗时，例如：`0.0690 sec.`。
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`tasks_count`	integer	`tasks` 数组中的任务数量。
`tasks_error`	integer	`tasks` 数组中返回错误的任务数量。
`tasks`	array	任务信息数组。

`tasks` 数组字段

字段名	类型	说明
`id`	string	任务唯一标识，UUID 格式。可使用该 ID 查询已完成任务的结果。
`status_code`	integer	当前任务的状态码，通常在 `10000` 至 `60000` 范围。
`status_message`	string	当前任务的状态说明。
`time`	string	任务执行耗时。
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`result_count`	integer	`result` 数组中的数量。任务创建接口通常为 `0`。
`path`	array	请求路径信息。
`data`	object	创建任务时提交的参数。
`result`	array \| null	任务结果数组。任务创建成功时通常为 `null`，需要通过任务 ID 查询结果，或回调通知。

响应示例

json

{
  "version": "0.1.20241227",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0690 sec.",
  "cost": 0.0012,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "status_code": 20100,
      "status_message": "Task Created.",
      "time": "0.0100 sec.",
      "cost": 0.0012,
      "result_count": 0,
      "path": [
        "v3",
        "serp",
        "google",
        "finance_markets",
        "task_post"
      ],
      "data": {
        "api": "serp",
        "function": "task_post",
        "se": "google",
        "se_type": "finance_markets",
        "language_name": "English",
        "location_code": 2840,
        "market_type": "most-active",
        "priority": 2,
        "device": "desktop",
        "os": "windows"
      },
      "result": null
    }
  ]
}

错误处理

当单次请求提交 100 个任务时，出限制的任务将返回错误码 40006。

建议在客户端至少处理以下：

检查顶层 status_code 是否为 20000。
检查 tasks_error 是否大于 0。
逐项检查 tasks 数组中每个任务的 status_code 和 status_message。
保存任务 id，用于后续查询结果或排查失败任务。
对回调请求实现时、签名校验、幂等和重试机制。

实用场景

监控不同地区的热门股票：按地区、语言和 most-active 市场类型定时采集热门股票数据，市场趋势分析和选题。
追踪主要指数表现：使用 indexes 及地区细分类型获取 Google Finance 中的指数信息，为财经 SEO 页面和行业报告提供实时数据。
识别涨与跌资产：分别采集 gainers 和 losers 数据，快速生成市场动态摘要，提升财经资讯的时效性。
分析加密货币与汇率市场：使用 cryptocurrencies 和 currencies 类型监测数字资产、货币对及搜索市场变化，支持跨境业务和金融研究。
构建多地区市场数据看板：批量提交不同 location_code、language_code 和 market_type 任务，统一汇总多市场数据，为 SEO规划和竞品分析提供依据。

设置 Google Finance Markets SERP 任务 ​

计费与请求限制 ​

请求参数 ​

主要参数 ​

附加参数 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应说明 ​

顶层响应字段 ​

tasks 数组字段 ​

响应示例 ​

错误处理 ​

实用场景 ​