SeerMarTech API 文档

主题

Google Dataset Info 实时高级接口 ​

POST /v3/serp/google/dataset_info/live/advanced

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

/v3/serp/google/dataset_info/live/advanced

实时获取 Google Dataset Search 中指定数据集的详细信息。返回来自独立于常规 SERP 展示的数据集页，数据集、提供方、、许可证、覆盖范围、时间范围及描述等信息。

请求说明 ​

  • 请求地址：https://api.seermartech.cn/v3/serp/google/dataset_info/live/advanced
  • 请求方法：POST
  • 请求格式：JSON，使用 UTF-8 编码
  • 请求体格式：JSON 数组，例如 [{ ... }]
  • 每个请求最多 1 个任务 平台限流以认证说明中的 30/60/120 次/分钟规则为准### 计费

每个请求单独计费。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求参数 ​

主要参数 ​

字段类型说明
dataset_idstring填。 数据集 ID。可从数据集 URL 或 Google Dataset Search 结果中的 dataset 项获取。例如：L2cvMTFqbl85ZHN6MQ==
language_codestring搜索引擎语言代码，可选。传此字段后无需传 language_name。可选值：en
devicestring设备类型，可选。用于返回指定设备类型下的结果。可选值：desktop

附加参数 ​

字段类型说明
language_namestring搜索引擎语言称，可选。传此字段后无需传 language_code。可选值：English
osstring设备操作系统，可选。可选值：windows、macos。默认值：windows
tagstring用户自定义任务标识，可选。最长 255 个字符，可用于识别任务并与结果进行匹。提交的值会原样返回在响应的 data 对象中。

请求示例 ​

curl ​

bash
curl --location --request POST \
  "https://api.seermartech.cn/v3/serp/google/dataset_info/live/advanced" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '[
    {
      "dataset_id": "L2cvMTFqbl85ZHN6MQ==",
      "language_code": "en",
      "device": "desktop",
      "os": "windows",
      "tag": "dataset-detail-check"
    }
  ]'

Python ​

python
import requests

url = "https://api.seermartech.cn/v3/serp/google/dataset_info/live/advanced"

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

# 每个请求最多提交一个任务
payload = [
    {
        "dataset_id": "L2cvMTFqbl85ZHN6MQ==",
        "language_code": "en",
        "device": "desktop",
        "os": "windows",
        "tag": "dataset-detail-check",
    }
]

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

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 response = await axios.post(
  "https://api.seermartech.cn/v3/serp/google/dataset_info/live/advanced",
  [
    {
      dataset_id: "L2cvMTFqbl85ZHN6MQ==",
      language_code: "en",
      device: "desktop",
      os: "windows",
      tag: "dataset-detail-check",
    },
  ],
  {
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
  }
);

const result = response.data;

if (result.status_code === 20000) {
  console.log(result);
} else {
  console.error(
    `请求失败。错误码：${result.status_code}，错误信息：${result.status_message}`
  );
}

响应说明 ​

接口返回 JSON 对象 tasks 数组。每个任务对应一个提交的请求任务。

顶层字段 ​

字段类型说明
versionstring当前 API 版本
status_codeinteger通用响应状态码。完整状态码列表请参考错误码文档。
status_messagestring通用响应说明
timestring请求执行耗时，单位为秒
costfloat平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
tasks_countintegertasks 数组中的任务数量
tasks_errorintegertasks 数组中返回错误的任务数量
tasksarray任务结果数组

任务字段 ​

字段类型说明
idstring任务唯一标识，UUID 格式
status_codeinteger任务状态码，通常处于 10000 至 60000 范围
status_messagestring任务状态说明
timestring任务执行耗时，单位为秒
costfloat平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
result_countintegerresult 数组中的数量
patharrayURL 路径
dataobject创建任务时提交的参数
resultarray搜索结果数组

result 字段 ​

字段类型说明
keywordstringPOST 请求中的。返回时会对 %## 编码进行解码，字符 + 会解码为空格。
se_domainstringPOST 请求中的搜索引擎域名
language_codestringPOST 请求中的语言代码
check_urlstring搜索引擎结果页的直接 URL，可用于核验返回结果
datetimestring获取结果的日期和时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00
spellobject搜索引擎自动纠错信息。当搜索引擎对进行纠正后，返回纠正后的及纠错类型。
refinement_chipsobject搜索筛选或细化选项
item_typesarraySERP 中出现的结果类型。该接口可能返回：dataset
se_results_countintegerSERP 中的结果总数
items_countintegeritems 数组中的结果数量
itemsarraySERP 中的数据集结果

items 字段 ​

字段类型说明
typestring素类型，固定为 dataset
rank_groupinteger组排名。在相同 type素组成的分组计算；不同类型之间的位置不会计此字段。
rank_absoluteintegerSERP 中的绝对排名，即在所有结果中的位置
positionstring素在 SERP 中的对齐位置。可选值：left、right
xpathstring结果的 XPath
dataset_idstring数据集 ID
titlestringSERP 中展示的数据集标题
image_urlstring图片 URL。可能指向原始资源中的图片，也可能指向本平台存储的图片（原始来源不可用时）。
scholarly_citations_countinteger引用该数据集的文章数量
linksarray/null站点链接。显示在部分 Google Dataset 结果下方；没有链接时为 null
dataset_providersarray提供该数据集的机构列表
formatsarray数据集文件格式列表
authorsarray/null数据集列表
licensesarray数据集许可证列表
updated_datestring结果最后更新时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00
area_coveredarray/null数据集覆盖区域，例如 Africa、Global
period_coveredobject数据集覆盖的时间范围
dataset_descriptionobject数据集描述信息
字段类型说明
typestring素类型，固定为 link_element
titlestringSERP 中展示的链接标题
descriptionstring链接描述
urlstring站点链接 URL
domainstringSERP 中展示的域名

dataset_providers 字段 ​

字段类型说明
typestring素类型，固定为 dataset_providers_element
titlestring数据集提供方名称
urlstring数据集提供方网站 URL
domainstring数据集提供方网站域名

formats 字段 ​

字段类型说明
typestring素类型，固定为 formats_element
formatstring文件格式，例如 zip、html、csv
sizestring文件大小，单位为字节

authors 字段 ​

字段类型说明
typestring素类型，固定为 authors_element
namestring数据集名称
urlstring链接 URL
domainstring链接域名

licenses 字段 ​

字段类型说明
typestring素类型，固定为 licenses_element
titlestring许可证名称
urlstring许可证 URL
domainstring许可证链接指向的域名

period_covered 字段 ​

字段类型说明
start_datestring覆盖时间范围起始时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00
end_datestring覆盖时间范围结束时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00
displayed_datestringSERP 中展示的时间范围，例如 Jan 1, 2002 - Dec 31, 2017

dataset_description 字段 ​

字段类型说明
textstring数据集描述文本
linksarray描述文本中的链接列表

dataset_description.links 中的字段如下：

字段类型说明
typestring素类型，固定为 link_element
titlestring链接锚文本
descriptionstring链接描述
urlstring链接 URL
domainstring链接域名

响应示例 ​

json
{
  "version": "0.1.20221214",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "12.0954 sec.",
  "cost": 0.002,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": " task-uuid-example ",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "12.0954 sec.",
      "cost": 0.002,
      "result_count": 1,
      "data": {
        "api": "serp",
        "function": "live",
        "se": "google",
        "se_type": "dataset_info",
        "dataset_id": "L2cvMTFqbl85ZHN6MQ==",
        "device": "desktop",
        "os": "windows"
      },
      "result": [
        {
          "se_results_count": 1,
          "items_count": 1,
          "items": [
            {
              "type": "dataset",
              "dataset_id": "L2cvMTFqbl85ZHN6MQ==",
              "title": "Canadian Environmental Sustainability Indicators",
              "dataset_providers": [],
              "formats": [],
              "authors": null,
              "licenses": [],
              "updated_date": "2019-06-24 03:00:00 +00:00",
              "area_covered": null,
              "period_covered": {
                "start_date": "2002-01-01 02:00:00 +00:00",
                "end_date": "2017-12-31 02:00:00 +00:00",
                "displayed_date": "Jan 1, 2002 - Dec 31, 2017"
              },
              "dataset_description": {
                "text": "The Canadian Environmental Sustainability Indicators program provides data and information about environmental sustainability issues.",
                "links": []
              }
            }
          ]
        }
      ]
    }
  ]
}

状态码与异常处理 ​

响应中的 status_code 和 tasks[].status_code 用于表示请求及任务执行状态。建议客户端：

  1. 同时检查顶层 status_code 与任务级 status_code；
  2. 根据 status_message 记录错误原因；
  3. 根据 tasks_error 判断是否存在失败任务；
  4. 对时、限流及临时性错误实现重试机制；
  5. 对返回字段为空或为 null 的进行容处理。

完整错误码请参考错误码文档。

实用场景 ​

  • 核验数据集信息：批量获取数据集标题、、许可证和更新时间，帮助团队判断数据来源是否可靠、是否适合引用。
  • 监控数据集更新状态：定期检查 updated_date、period_covered 和数据格式变化，及时发现数据源更新并触发分析流程。
  • 构建数据集目录：提取数据集提供方、覆盖区域、文件格式和描述，建立可搜索的数据资源目录。
  • 评估数据集引用价值：读取 scholarly_citations_count，筛选学术引用量较高的数据集，为研究型和权威资源建设提供依据。
  • 分析 SERP 数据集展示结果：结合排名、站点链接和数据集描述字段，研究 Google Dataset Search 的结果展示特征，优化数据集页面的结构化信息。

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

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