SeerMarTech API 文档

主题

Google Finance Explore 任务创建 ​

接口说明 ​

该接口用于创建 Google Finance「Explore」标签页的实时抓取任务。返回结果会根据你在请求中指定的 location 和 language 参数而变化。

  • 请求方法：POST
  • 请求地址：https://api.seermartech.cn/v3/serp/google/finance_explore/task_post

你可以在任务创建后，通过返回的唯一任务标识 id 获取结果；也可以在创建任务时指定 postback_url 或 pingback_url，由本平台在任务完成后主动通知你的服务端。

计费与限流 ​

  • 每次请求都会产生费用。
  • 参考价请以响应中的 cost 字段为准，扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
  • 若原始普通任务参考成本为 USD 0.0024，则参考价约 ¥0.0384 / 次
  • 高优级任务会额外收费。
  • 当 news_type 设为 local_market 或 world_markets 时，单任务费用会翻倍。

请求限制：

  • 每分钟最多 2000 次 API 调用
  • 单次 POST 最多提交 100 个任务 -过 100 个任务时，出部分会返回错误 40006

回调说明 ​

你可以通过以下两种方式接收任务完成通知：

  • pingback_url：任务完成后，本平台向该地址发起 GET 请求
  • postback_url：任务完成后，本平台向该地址发起 POST 请求，并以 gzip 压缩格式发送结果

说明：

  • postback_url 与 pingback_url 中可使用 $id 和 $tag 变量
  • 实发送时，本平台会自动替换为真实任务值
  • URL 中的特殊字符会进行 URL 编码，例如 # 会被编码为 %23
  • 如果你的服务器在 10 秒未响应，连接会因时中断，任务将被转 /v3/serp/google/organic/tasks_ready/ 列表拉取

请求体格式 ​

所有 POST 数据使用 UTF-8 编码的 JSON，并且请求体格式为 JSON 数组：

json
[
 {
 "location_code": 2840,
 "language_name": "English"
 }
]

主要参数 ​

字段名类型说明
location_codeinteger搜索引擎地区代码。如果未指定 location_name，则此字段填。使用该字段时无需再传 location_name。可通过 /v3/serp/google/locations 获取可用地区代码。示例：2840
language_codestring搜索引擎语言代码。如果未指定 language_name，则此字段填。使用该字段时无需再传 language_name。可通过 /v3/serp/google/languages 获取可用语言代码。示例：en
devicestring设备类型，可选。可选值：desktop
pingback_urlstring任务完成通知地址，可选。任务完成后，本平台会向该地址发送 GET 请求。可使用 $id 和 $tag 变量。示例：http://your-server.com/pingscript?id=$id、http://your-server.com/pingscript?id=$id&tag=$tag
postback_urlstring任务结果回传地址，可选。任务完成后，本平台会向该地址发送 POST 请求，并以 gzip 压缩传输结果。可使用 $id 和 $tag 变量。示例：http://your-server.com/postbackscript?id=$id、http://your-server.com/postbackscript?id=$id&tag=$tag
postback_datastringpostback_url 的结果数据类型。若指定了 postback_url，则此字段填。可选值：advanced、html
priorityinteger任务优级，可选。1 = 普通优级（默认），2 = 高优级。高优级任务会额外收费

附加参数 ​

字段名类型说明
location_namestring搜索引擎地区名。如果未指定 location_code，则此字段填。使用该字段时无需再传 location_code。可通过 /v3/serp/google/locations 获取可用地区名称。示例：London,England,United Kingdom
language_namestring搜索引擎语言名。如果未指定 language_code，则此字段填。使用该字段时无需再传 language_code。可通过 /v3/serp/google/languages 获取可用语言名称。示例：English
osstring设备操作系统，可选。可选值：windows
tagstring自定义任务标识，可选，最长 255 个字符。可用于在结果中识别和任务；设置后会出现在响应的 data 对象中
news_typestring财经新闻筛选类型，可选。可选值：top_stories、local_market、world_markets。默认值：top_stories。注意： 当取值为 local_market 或 world_markets 时，单任务费用翻倍

响应结构 ​

接口返回 JSON 格式数据，顶层 tasks 数组，用于描述本次创建的任务。

顶层字段 ​

字段名类型说明
versionstring当前 API 版本
status_codeinteger通用状态码。完整错误码见 /v3/appendix/errors
status_messagestring通用状态说明
timestring执行耗时，单位秒
costfloat本次请求总费用，单位 USD
tasks_countintegertasks 数组中的任务数量
tasks_errorintegertasks 数组中返回错误的任务数量
tasksarray任务数组

tasks[] 字段 ​

字段名类型说明
idstring任务唯一标识，UUID 格式
status_codeinteger任务状态码，范围通常为 10000-60000
status_messagestring任务状态说明
timestring任务处理耗时，单位秒
costfloat单个任务费用，单位 USD
result_countintegerresult 数组数量
patharrayURL 路径信息
dataobject任务参数回显，即你在 POST 中提交的参数
resultarray | null结果数组。对于任务创建接口，此处通常为 null

错误处理建议 ​

建议你在接时对以下做好处理：

  • 顶层 status_code 非成功
  • tasks_error 大于 0
  • 单个任务 status_code 异常
  • 回调时或服务端响应失败
  • 单次请求任务数 100，导致返回 40006

完整错误码与状态说明可参考 /v3/appendix/errors。

请求示例 ​

cURL ​

bash
curl --location --request POST "https://api.seermartech.cn/v3/serp/google/finance_explore/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_explore/task_post"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

# 请求体为 JSON 数组
payload = [
 {
 "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, json=payload, headers=headers)
print(response.json)

TypeScript ​

typescript
import axios from "axios";

const payload = [
 {
 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_explore/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": "0.1.20241227",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0546 sec.",
 "cost": 0.0024,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "serp",
 "function": "task_post",
 "se": "google",
 "se_type": "finance_explore",
 "language_name": "English",
 "location_code": 2840,
 "news_type": "local_market",
 "priority": 2,
 "device": "desktop",
 "os": "windows"
 },
 "result": null
 }
 ]
}

字段解读补 ​

  • result 在任务创建阶段通常为 null，表示任务已受理但结果尚未返回。
  • 后续你可以使用返回的 id 调用对应结果接口进行查询。
  • 如果已设置 pingback_url 或 postback_url，则可本平台主动通知。

实用场景 ​

  • 监控区域财经热点：按国家或城市抓取 Google Finance Explore，识别本地市场主题，支持金融选题和地区化 SEO 策略制定。
  • 跟踪市场新闻差异：切换 news_type 为 world_markets，对比不同市场环境下的财经信息分布，站布局。
  • 搭建实时舆采集流程：结合 pingback_url 或 postback_url 自动接收任务完成通知，减少轮询成本，加快数据库。
  • 细分语言市场策略：通过不同 language_code / language_name 获取多语言财经结果，支持海外 SEO 与本地化优化。
  • 提升高时效任务处理速度：为热点监控任务设置 priority=2，更快获取结果，用于市场异动、突发新闻或竞品动态追踪。

统一入口：官网 · LLM API · 控制台

© 2026 SeerMarTech · GEO · SEO 营销数据 API