提交 Google Finance Quote SERP 任务

GET /v3/serp/google/finance_quote/task_post

接口说明

该接口用于提交 Google Finance 的 Quote 标签页抓取任务，可获取指定股票/证券代码在目标地区与语言环境下的实时报价结果。

接口返回的是任务提交结果，并不会直接返回抓取数据。任务创建成功后，你可以通过返回的任务 id 获取结果；如果在创建任务时设置了 postback_url 或 pingback_url，本平台也可以在任务完成后主动通知你的服务端。

请求地址

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

计费说明

该接口按请求计费。

参考价请以游结算为基础换算；
扣费以响应头 X-SeerMarTech-Charge-CNY 为准
若设置 priority=2，将按高优级执行，并产生额外费用
若 window 取值不是 1D，单任务费用会乘以 2

根据示例响应中的价格可推算：

示例总价：USD 0.0012
参考价约：¥0.0192 / 次

请求规则

请求体为 UTF-8 编码的 JSON
POST 请求体格式为 JSON 数组：[{ ... }]
每分钟最多可提交 2000 次 API 调用
每次 POST 最多 100 个任务
如果单次 POST 中任务数 100，出部分会返回错误 40006

结果获取方式

任务提交成功后，可通过唯一任务标识 id 获取结果。

如果你在创建任务时指定了：

pingback_url：任务完成后，本平台会向该地址发送 GET 通知
postback_url：任务完成后，本平台会向该地址发送结果的 POST 请求，数据为 gzip 压缩格式

回调说明

pingback_url 和 postback_url 中可使用 $id 作为任务 ID 占位符
可使用 $tag 作为你传的 tag 值占位符，发送前会自动替换为 URL 编码后的值
若你的服务端 10 秒未响应，连接会因时中断，任务将转 /v3/serp/google/organic/tasks_ready/ 列表中后续拉取
pingback_url、postback_url 中的特殊字符会进行 URL 编码，例如 # 会被编码为 %23

主要参数

字段名	类型	说明
`keyword`	string	填。股票代码或证券交易代码。用于传某只股票、指数或证券在特定交易所中的 ticker / symbol。最大长度 700 字符。 `%##` 会被解码，`+` 会被解码为空格；如果确实需要传 `%`，请写为 `%25`；如果需要传 `+`，请写为 `%2B`。
`location_code`	integer	若未提供 `location_name`，则填。搜索引擎地区代码。提供该字段时可不传 `location_name`。可通过 `/v3/serp/google/locations` 获取支持的地区及 `location_code`。示例：`2840`
`language_code`	string	若未提供 `language_name`，则填。搜索引擎语言代码。提供该字段时可不传 `language_name`。可通过 `/v3/serp/google/languages` 获取支持的语言及 `language_code`。示例：`en`
`device`	string	可选。设备类型。当前可选值：`desktop`
`pingback_url`	string	可选。任务完成通知地址。任务完成后，本平台会向该地址发送 GET 请求。可使用 `$id` 和 `$tag` 占位。示例：`http://your-server.com/pingscript?id=$id` 或 `http://your-server.com/pingscript?id=$id&tag=$tag`
`postback_url`	string	可选。任务结果回传地址。任务完成后，本平台会向该地址发送结果的 POST 请求，为 gzip 压缩格式。可使用 `$id` 和 `$tag` 占位。示例：`http://your-server.com/postbackscript?id=$id` 或 `http://your-server.com/postbackscript?id=$id&tag=$tag`
`postback_data`	string	指定 `postback_url` 时填。指定发送到你服务端的数据类型。可选值：`advanced`、`html`
`priority`	integer	可选。任务优级。`1` = 普通优级（默认）；`2` = 高优级。高优级会加快处理速度，但会产生额外费用。

附加参数

字段名	类型	说明
`location_name`	string	若未提供 `location_code`，则填。搜索引擎地区名。提供该字段时可不传 `location_code`。可通过 `/v3/serp/google/locations` 获取支持的地区名称。示例：`London,England,United Kingdom`
`language_name`	string	若未提供 `language_code`，则填。搜索引擎语言名。提供该字段时可不传 `language_code`。可通过 `/v3/serp/google/languages` 获取支持的语言名称。示例：`English`
`os`	string	可选。设备操作系统。当前可选值：`windows`
`tag`	string	可选。自定义任务标识，最大长度 255 字符。可用于业务侧任务与结果。该值会出现在响应的 `data` 对象中。
`window`	string	可选。`google_finance_quote` 图表时间窗口。可选值：`1D`、`5D`、`1M`、`6M`、`YTD`、`1Y`、`5Y`、`MAX`。默认值：`1D`。注意：若该值不是 `1D`，单任务费用会乘以 2。

请求示例

cURL

bash

curl --location --request POST "https://api.seermartech.cn/v3/serp/google/finance_quote/task_post" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "keyword": ".DJI:INDEXDJX",
 "location_code": 2840,
 "language_name": "English"
 },
 {
 "keyword": "CLW00:NYMEX",
 "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_quote/task_post"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

# POST 请求体为 JSON 数组
payload = [
 {
 "keyword": ".DJI:INDEXDJX",
 "location_code": 2840,
 "language_name": "English"
 },
 {
 "keyword": "CLW00:NYMEX",
 "location_code": 2840,
 "language_name": "English",
 "priority": 2,
 "tag": "some_string_123",
 "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
 }
]

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

TypeScript

typescript

import axios from "axios";

// POST 请求体为 JSON 数组
const payload = [
 {
 keyword: ".DJI:INDEXDJX",
 location_code: 2840,
 language_name: "English"
 },
 {
 keyword: "CLW00:NYMEX",
 location_code: 2840,
 language_name: "English",
 priority: 2,
 tag: "some_string_123",
 pingback_url: "https://your-server.com/pingscript?id=$id&tag=$tag"
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/serp/google/finance_quote/task_post",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 data: payload
})
 .then((response) => {
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

响应说明

接口返回 JSON 数据，任务提交状态及每个任务的详细信息。

顶层字段

字段名	类型	说明
`version`	string	当前 API 版本
`status_code`	integer	接口总体状态码
`status_message`	string	接口总体状态信息
`time`	string	执行耗时，单位秒
`cost`	float	本次请求总费用，单位 USD
`tasks_count`	integer	`tasks` 数组中的任务数量
`tasks_error`	integer	`tasks` 数组中执行出错的任务数量
`tasks`	array	任务数组

tasks 数组字段

字段名	类型	说明
`id`	string	任务唯一标识，UUID 格式
`status_code`	integer	任务状态码，范围通常为 `10000-60000`
`status_message`	string	任务状态信息
`time`	string	任务执行耗时，单位秒
`cost`	float	单任务费用，单位 USD
`result_count`	integer	`result` 数组中的数量
`path`	array	URL 路径
`data`	object	你在 POST 中提交的任务参数
`result`	array \| null	结果数组。对于任务提交接口，该值通常为 `null`

建议对 status_code、tasks_error 以及各任务级别的 status_code 建立完善的异常处理机制。错误码可参考 /v3/appendix/errors。

响应示例

json

{
 "version": "0.1.20241227",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0642 sec.",
 "cost": 0.0012,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "serp",
 "function": "task_post",
 "se": "google",
 "se_type": "finance_quote",
 "language_name": "English",
 "location_code": 2840,
 "keyword": ".DJI:INDEXDJX",
 "window": "1D",
 "priority": 2,
 "device": "desktop",
 "os": "windows"
 },
 "result": null
 }
 ]
}

状态码与错误处理

顶层 status_code=20000 通常表示请求成功
若单次 POST 中任务数量 100，出部分会返回 40006
单个任务也可能返回独立的 status_code 与 status_message
详细错误码请参考：/v3/appendix/errors

使用建议

批量提交时控制任务数：单次请求建议不 100 个任务。
优使用代码参数：location_code、language_code 比名称参数更稳定。
根据业务需要选择 window：在确实需要更长时间跨度图表时使用非 1D 值，以控制成本。
异步处理结果：若抓取量较大，建议结合 pingback_url 或 postback_url 使用，减少轮询压力。
保留业务标签：通过 tag 将任务与股票池、用户策略或监控规则进行。

实用场景

监控股票代码实时报价页：按 ticker 持续创建任务，及时获取指定证券在目标市场下的 Google Finance Quote 数据，用于监测或同步。
追踪不同地区下的金融搜索展示差异：通过切换 location_code 与 language_code，分析同一证券在不同国家/语言环境中的展示差异，支持化金融运营。
抓取指数与期货标的页面数据：使用如指数、期货合约等代码创建任务，统一采集金融资产 SERP 页面，便于建立跨品类金融信息库。
构建异步金融数据采集流程：结合 pingback_url 或 postback_url，将任务接自动化采集队列，在任务完成后自动回收结果，降低轮询成本。
分析不同时间窗口下的走势图展示：通过 window 参数抓取 1D、1M、1Y 等时间尺度的数据页面，用于金融分析、趋势对比和图表监测。

提交 Google Finance Quote SERP 任务 ​

接口说明 ​

计费说明 ​

请求规则 ​

结果获取方式 ​

回调说明 ​

主要参数 ​

附加参数 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应说明 ​

顶层字段 ​

tasks 数组字段 ​

响应示例 ​

状态码与错误处理 ​

使用建议 ​

实用场景 ​