设置 Google Finance Ticker Search 任务

POST /v3/serp/google/finance_ticker_search/task_post

本接口使用 POST 方法，通过以下路径创建 Google Finance Ticker Search 任务：

POST https://api.seermartech.cn/v3/serp/google/finance_ticker_search/task_post

Google Finance Ticker Search 用于搜索 Google Finance 中可用的金融，并返回附加信息。搜索结果取决于请求中的以下参数：

keyword：名称或金融名称
location：搜索地区
language：搜索语言

请求限制与任务获取

所有 POST 请求体使用 UTF-8 编码的 JSON 格式。
请求体是 JSON 数组，每个代表一个任务。
每次请求最多 100 个任务。平台限流以认证说明中的 30/60/120 次/分钟规则为准。
如果单次请求 100 个任务，出部分将返回错误码 40006。
创建任务后，可通过返回的任务 id 获取结果。
也可以在创建任务时设置 pingback_url 或 postback_url，任务完成后由本平台主动通知。
如果通知服务器在 10 秒未响应，连接将因时中断，任务会转任务就绪列表。

计费说明

每个成功提交的任务都会产生费用。普通优级任务参考价约 ¥0.0086 / 次，价格可能因任务而变化。

使用高优级 priority=2 时会产生额外费用。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求参数

主要参数

参数	类型	填	说明
`keyword`	string	是	名称或金融名称。最多 700 个字符。百分号编码会被解码，字符 `+` 会被解码为空格。若中需要使用 `%`，请编码为 `%25`；若需要使用 `+`，请编码为 `%2B`。
`location_code`	integer	条件填	搜索地区代码。未指定 `location_name` 时填。使用该参数后无需再传 `location_name`。可通过 `GET https://api.seermartech.cn/v3/serp/google/locations` 获取可用地区及代码。例如：`2840`。
`language_code`	string	条件填	搜索语言代码。未指定 `language_name` 时填。使用该参数后无需再传 `language_name`。可通过 `GET https://api.seermartech.cn/v3/serp/google/languages` 获取可用语言及代码。例如：`en`。
`pingback_url`	string	否	任务完成通知地址。任务完成后，本平台会向该地址发送 GET 请求。URL 中可使用 `$id` 和 `$tag` 占位符，本平台发送请求时会替换为任务 ID 和 URL 编码后的标签值。
`postback_url`	string	否	任务结果回传地址。任务完成后，本平台会向该地址发送 POST 请求，并以 gzip 格式压缩结果。URL 中可使用 `$id` 和 `$tag` 占位符。
`postback_data`	string	条件填	指定 `postback_url` 时填，表示回传数据类型。可选值：`advanced`、`html`。
`priority`	integer	否	任务优级。`1`：普通优级，默认值；`2`：高优级。高优级任务会产生额外费用。

pingback_url 示例：

text

https://your-server.com/pingscript?id=$id
https://your-server.com/pingscript?id=$id&tag=$tag

postback_url 示例：

text

https://your-server.com/postbackscript?id=$id
https://your-server.com/postbackscript?id=$id&tag=$tag

注意：

pingback_url 和 postback_url 中的特殊字符会进行 URL 编码。
例如，字符 # 会被编码为 %23。

参数

参数	类型	填	说明
`location_name`	string	条件填	搜索地区的完整名称。未指定 `location_code` 时填。使用该参数后无需再传 `location_code`。例如：`London,England,United Kingdom`。
`language_name`	string	条件填	搜索语言的完整名称。未指定 `language_code` 时填。使用该参数后无需再传 `language_code`。例如：`English`。
`tag`	string	否	用户自定义任务标识，最多 255 个字符。可用于任务与结果。提交后可在响应的 `data` 对象中获取。
`category`	string	否	要搜索的金融类别。可选值：`all`、`stock`、`index`、`mutual_fund`、`currency`、`futures`。默认值：`all`。

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

请求示例

cURL

bash

curl --location --request POST \
  "https://api.seermartech.cn/v3/serp/google/finance_ticker_search/task_post" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '[
    {
      "keyword": "DJ",
      "location_code": 2840,
      "language_name": "English"
    },
    {
      "keyword": "DJ",
      "location_code": 2840,
      "language_name": "English",
      "priority": 2,
      "tag": "some_string_123",
      "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
    }
  ]'

Python

python

import requests

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

# 请求体是 JSON 数组
post_data = [
    {
        "keyword": "DJ",
        "location_code": 2840,
        "language_name": "English"
    },
    {
        "keyword": "DJ",
        "location_code": 2840,
        "language_name": "English",
        "priority": 2,
        "tag": "some_string_123",
        "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
    }
]

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

response = requests.post(url, json=post_data, headers=headers, 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 postData = [
  {
    keyword: "DJ",
    location_code: 2840,
    language_name: "English",
  },
  {
    keyword: "DJ",
    location_code: 2840,
    language_name: "English",
    priority: 2,
    tag: "some_string_123",
    pingback_url: "https://your-server.com/pingscript?id=$id&tag=$tag",
  },
];

axios
  .post(
    "https://api.seermartech.cn/v3/serp/google/finance_ticker_search/task_post",
    postData,
    {
      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	请求执行耗时，单位为秒。
`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`。

响应示例

json

{
  "version": "0.1.20241227",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.1108 sec.",
  "cost": 0.0086,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "ಿಸಲಾಗUUID-example-1234-5678-abcdef",
      "status_code": 20100,
      "status_message": "Task Created.",
      "time": "0.0250 sec.",
      "cost": 0.0086,
      "result_count": 0,
      "path": [
        "v3",
        "serp",
        "google",
        "finance_ticker_search",
        "task_post"
      ],
      "data": {
        "api": "serp",
        "function": "task_post",
        "se": "google",
        "se_type": "finance_ticker_search",
        "language_name": "English",
        "location_code": 2840,
        "category": "all",
        "keyword": "DJ",
        "priority": 2,
        "device": "desktop",
        "os": "windows"
      },
      "result": null
    }
  ]
}

> 示例中的费用值为人民币参考值；扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

错误处理

建议根据顶层 status_code、任务级 status_code 和对应的 status_message 实现异常处理。

20000：请求成功。
40006：单次请求中的任务数量 100 个，出限制的任务不会被正常创建。
状态码：请根据返回的错误信息进行处理，并对网络时、通知回调失败及任务创建失败等设计重试或告警机制。

实用场景

搜索或金融的交易代码：根据名称查询 Google Finance 中的股票、指数、基金、货币或期货标识，支持金融平台构建证券检索功能。
批量建立金融监测任务：一次提交多个或金融名称，集中获取任务 ID，提升金融市场数据采集效率。
按地区和语言开展金融搜索分析：组合 location_code 与 language_code，比较不同市场对同一金融的搜索结果差异。
按金融类别筛选搜索对象：使用 category 区分股票、指数、基金、货币和期货，便于构建分类数据库。
通过回调自动接收任务状态： pingback_url 或 postback_url，在任务完成后自动触发业务流程，减少轮询请求和系统资源消耗。

设置 Google Finance Ticker Search 任务 ​

请求限制与任务获取 ​

计费说明 ​

请求参数 ​

主要参数 ​

参数 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应说明 ​

顶层字段 ​

tasks 数组中的字段 ​

响应示例 ​

错误处理 ​

实用场景 ​