提交 Google Finance Markets SERP 任务

接口说明

该接口用于提交 Google Finance 中 Markets 标签页的数据抓取任务，可获取与指定参数对应的实时市场结果。返回会受以下参数影响：

location
language
market_type

请求地址

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

计费说明

本接口按请求计费，每次创建任务都会产生费用。参考价约 ¥0.0192 / 次。

如使用高优级任务（priority=2），会产生额外费用。 扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求格式与调用限制

请求方法：POST
请求体格式：JSON 数组 [{ ... }]
编码：UTF-8
单次 POST 最多可提交 100 个任务
接口频率上限：2000 次 API 调用/分钟
若单次 POST 中任务数 100，出部分会返回错误 40006

任务提交成功后，你可以通过返回的唯一任务 ID id 获取结果。如果在创建任务时指定了 postback_url 或 pingback_url，本平台也可以在任务完成后主动通知你。

注意：
若你的回调服务器在 10 秒未响应，请求会因时被中止
此类任务会被转 /v3/serp/google/organic/tasks_ready/ 列表
错误码和错误信息取决于你的服务器

请求参数

主要参数

字段名	类型	说明
`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 请求。可使用 `$id` 作为任务 ID 变量，`$tag` 作为经过 URL 编码的标签变量。示例：`http://your-server.com/pingscript?id=$id` 或 `http://your-server.com/pingscript?id=$id&tag=$tag`。注意：`pingback_url` 中的特殊字符会被 URL 编码，例如 `#` 会编码为 `%23`
`postback_url`	string	结果回传地址，可选。任务完成后，本平台会向该地址发送 POST 请求，并以 `gzip` 压缩格式传送结果。可使用 `$id` 作为任务 ID 变量，`$tag` 作为经过 URL 编码的标签变量。示例：`http://your-server.com/postbackscript?id=$id` 或 `http://your-server.com/postbackscript?id=$id&tag=$tag`。注意：`postback_url` 中的特殊字符会被 URL 编码
`postback_data`	string	`postback_url` 返回数据类型。若传了 `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` 对象会该值
`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`

响应结构

接口返回 JSON 数据， tasks 数组，用于描述本次提交的任务信息。

顶层字段

字段名	类型	说明
`version`	string	当前 API 版本
`status_code`	integer	整体状态码。完整错误码请参考 `/v3/appendix/errors`
`status_message`	string	整体状态说明
`time`	string	执行耗时，单位秒
`cost`	float	本次请求总费用，单位 USD
`tasks_count`	integer	`tasks` 数组中的任务数量
`tasks_error`	integer	`tasks` 数组中返回错误的任务数量
`tasks`	array	任务数组

`tasks` 数组中的字段

字段名	类型	说明
`id`	string	平台唯一任务 ID，UUID 格式
`status_code`	integer	任务状态码，范围通常为 `10000-60000`
`status_message`	string	任务状态说明
`time`	string	任务执行耗时，单位秒
`cost`	float	单个任务费用，单位 USD
`result_count`	integer	`result` 数组中的数量
`path`	array	URL 路径
`data`	object	你在请求中提交的参数回显
`result`	array	结果数组；对于任务提交接口，此处通常为 `null`

建议在接时做好完整的异常和错误处理逻辑，非 20000 状态码。

请求示例

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"
 },
 {
 "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_markets/task_post"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

data = [
 {
 "location_code": 2840,
 "language_name": "English"
 },
 {
 "location_code": 2840,
 "language_name": "English",
 "priority": 2,
 "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
 }
]

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

TypeScript

typescript

import axios from "axios";

const postData = [
 {
 location_code: 2840,
 language_name: "English"
 },
 {
 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_markets/task_post",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 data: postData
}).then((response) => {
 console.log(response.data);
}).catch((error) => {
 console.error(error.response?.data || error.message);
});

响应示例

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": [
 {
 "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
 }
 ]
}

状态码与错误处理

20000：请求成功
40006：单次 POST 中任务数 100，出部分报错
错误码：请参考 /v3/appendix/errors

建议重点处理以下：

参数缺失或参数组合不合法 -出单次任务数量限制
回调地址时或不可达
任务状态码非成功值
接口整体成功但部分任务失败（检查 tasks_error）

使用建议

若已知标准化地理位置，优使用 location_code
若已知标准化语言代码，优使用 language_code
批量提交时建议每次控制在 100 个任务
需要更快返回时可使用 priority=2
需要异步处理结果时，优使用 postback_url 或 pingback_url

实用场景

监控热门市场板块：按 market_type=most-active、gainers、losers 持续采集市场页结果，帮助团队快速发现高金融主题
跟踪区域指数表现：使用 indexes/americas、indexes/asia-pacific 等类型，监控不同区域金融市场动向，为站选题提供依据
分析加密与汇率热度：抓取 cryptocurrencies 和 currencies 市场页数据，识别高搜索热度资产，支持金融资讯与专题页布局
构建金融 SERP 监测流程：结合 pingback_url 或 postback_url 实现异步回传，减少轮询压力，提升大规模任务处理效率
按语言和地区做市场对比：通过不同 location_code 与 language_code 组合，观察同一市场类型在不同地区与语言环境下的结果差异，化 SEO 策略制定

提交 Google Finance Markets SERP 任务 ​

接口说明 ​

请求地址 ​

计费说明 ​

请求格式与调用限制 ​

请求参数 ​

主要参数 ​

补参数 ​

响应结构 ​

顶层字段 ​

tasks 数组中的字段 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应示例 ​

状态码与错误处理 ​

使用建议 ​

实用场景 ​