Google Dataset 信息实时查询（高级版）

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

接口概述

Live Google Dataset Info Advanced 用于实时获取指定数据集在 Google Dataset 结果页中的信息。

与普通 SERP 列表结果不同，本接口返回的是某个数据集的独立页，通常：

数据集标题
数据集图片
提供机构
文件格式 -信息
许可证信息
更新时间
覆盖区域
覆盖时间范围
数据集描述
SERP 中展示的附加链接

请求方式

POST https://api.seermartech.cn/v3/serp/google/dataset_info/live/advanced

计费说明

本接口按请求计费，每次请求都会产生费用。

参考价约 ¥0.0320 / 次 扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求限制

所有 POST 数据使用 JSON（UTF-8 编码）
请求体为 JSON 数组：[{ ... }]
每分钟最多可发送 2000 次 API 调用
每个 Live SERP 请求 只能 1 个任务

请求参数

主要参数

字段名	类型	说明
`dataset_id`	string	填。数据集 ID。可从数据集 URL 或 Google Dataset Search 接口返回的 `dataset` 项中获取。示例：`L2cvMTFqbl85ZHN6MQ==`
`language_code`	string	可选。搜索引擎语言代码。设置该字段时无需再传 `language_name`。可选值：`en`
`device`	string	可选。设备类型。用于返回指定设备下的结果。可选值：`desktop`

附加参数

字段名	类型	说明
`language_name`	string	可选。搜索引擎语言称。设置该字段时无需再传 `language_code`。可选值：`English`
`os`	string	可选。设备操作系统。可选值：`windows`、`macos`。默认值：`windows`
`tag`	string	可选。自定义任务标识，最长 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=="
 }
]'

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=="
 }
]

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

TypeScript

typescript

const response = await fetch("https://api.seermartech.cn/v3/serp/google/dataset_info/live/advanced", {
 method: "POST",
 headers: {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 body: JSON.stringify([
 {
 dataset_id: "L2cvMTFqbl85ZHN6MQ=="
 }
 ])
});

const result = await response.json;
console.log(result);

响应结构

接口返回 JSON 对象，顶层 tasks 数组，每个任务对应一次获取结果。

顶层字段

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

建议在接时完善异常处理与错误状态处理逻辑。

`tasks[]` 字段

字段名	类型	说明
`id`	string	任务唯一标识，UUID 格式
`status_code`	integer	任务状态码，范围通常为 `10000-60000`，完整列表参考 `/v3/appendix/errors`
`status_message`	string	任务状态信息
`time`	string	任务执行耗时
`cost`	float	该任务费用，单位 USD
`result_count`	integer	`result` 数组中的结果数量
`path`	array	URL 路径
`data`	object	请求时提交的参数，响应中会原样返回
`result`	array	获取结果数组

`result[]` 字段

字段名	类型	说明
`keyword`	string	POST 数组中提交的。若 `%##` 会被解码；加号 `+` 会被解码为空格
`se_domain`	string	请求中的搜索引擎域名
`language_code`	string	请求中的语言代码
`check_url`	string	可直接访问的搜索结果页面 URL，用于校验结果准确性
`datetime`	string	获取结果的时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`
`spell`	object	搜索引擎自动纠错信息
`refinement_chips`	object	搜索细分建议
`item_types`	array	SERP 中出现的结果类型列表；本接口可能值为 `dataset`
`se_results_count`	integer	SERP 总结果数
`items_count`	integer	`items` 数组中的结果数量
`items`	array	数据集结果列表

`items[]` 字段说明

每个 items素表示一个数据集结果。

字段名	类型	说明
`type`	string	素类型，固定为 `dataset`
`rank_group`	integer	同类型结果分组排名
`rank_absolute`	integer	SERP局绝对排名
`position`	string	结果展示位置，可选值：`left`、`right`
`xpath`	string	该的 XPath
`dataset_id`	string	数据集 ID
`title`	string	SERP 中展示的数据集标题
`image_url`	string	图片 URL，可能指向原始资源或平台 API 缓存地址
`scholarly_citations_count`	integer	引用该数据集的学术文章数量
`links`	array / null	SERP 中该数据集下方展示的附加链接；无则为 `null`
`dataset_providers`	array	数据集提供机构列表
`formats`	array	数据集文件格式列表
`authors`	array / null	列表
`licenses`	array	数据集许可证列表
`updated_date`	string	数据集最后更新时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`
`area_covered`	array / null	数据覆盖区域，如 `Africa`、`Global`
`period_covered`	object	数据覆盖时间范围
`dataset_description`	object	数据集描述信息

`links[]` 字段

字段名	类型	说明
`type`	string	素类型，固定为 `link_element`
`title`	string	链接标题
`description`	string	链接描述
`url`	string	附加链接 URL
`domain`	string	链接域名

`dataset_providers[]` 字段

字段名	类型	说明
`type`	string	素类型，固定为 `dataset_providers_element`
`title`	string	数据提供机构名称
`url`	string	提供机构站点 URL
`domain`	string	提供机构域名

`formats[]` 字段

字段名	类型	说明
`type`	string	素类型，固定为 `formats_element`
`format`	string	文件格式类型，例如 `zip`、`html`、`csv`
`size`	string	文件大小，字节数

`authors[]` 字段

字段名	类型	说明
`type`	string	素类型，固定为 `authors_element`
`name`	string	名称
`url`	string	链接 URL
`domain`	string	链接域名

`licenses[]` 字段

字段名	类型	说明
`type`	string	素类型，固定为 `licenses_element`
`title`	string	许可证名称
`url`	string	许可证链接
`domain`	string	许可证链接域名

`period_covered` 字段

字段名	类型	说明
`start_date`	string	覆盖周期开始时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`
`end_date`	string	覆盖周期结束时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`
`displayed_date`	string	SERP 中展示的时间范围文本，例如：`Mar 2, 2020 - Dec 9, 2022`

`dataset_description` 字段

字段名	类型	说明
`text`	string	数据集描述正文
`links`	array	描述中出现的链接列表

`dataset_description.links[]` 字段

字段名	类型	说明
`type`	string	素类型，固定为 `link_element`
`title`	string	链接锚文本
`description`	string	链接描述
`url`	string	链接 URL
`domain`	string	链接域名

响应示例

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": [
 {
 "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": [
 {
 "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 (CESI) program provides data and information to track Canada's performance on key environmental sustainability issues.",
 "links": []
 }
 }
 ]
 }
 ]
 }
 ]
}

错误处理

可通过以下字段判断请求或任务是否成功：

顶层 status_code / status_message
tasks[].status_code / tasks[].status_message

常见处理建议：

顶层状态码非成功时，按请求级错误处理
顶层成功但任务状态码异常时，按任务级错误处理
结合 tasks_error 判断本次请求中是否存在失败任务
错误码完整列表参考：/v3/appendix/errors

使用说明

dataset_id 是本接口的核心参数，准确传
若只心桌面端结果，可传 dataset_id
若需做语言环境控制，可传 language_code 或 language_name，二选一即可
device 当前可用值为 desktop
os 默认值为 windows

实用场景

提取数据集信息：批量获取数据集标题、描述、、许可证和更新时间，用于搭建数据资源库或聚合页。
识别数据提供机构：采集 dataset_providers 信息，分析某一行业或主题下的核心数据发布机构，外链与合作目标筛选。
评估数据可用性：根据 formats、licenses、period_covered 等字段判断数据格式、授权方式和时间覆盖范围，提升选数效率。
监控数据集变动：定期抓取 updated_date、描述文本和覆盖周期，发现重点数据集是否更新，支持报跟踪与刷新。
分析学术与搜索价值：结合 scholarly_citations_count 与 SERP 展示结构，识别高引用、高权威数据集，支持研究选题和 SEO策划。

Google Dataset 信息实时查询（高级版） ​

接口概述 ​

请求方式 ​

计费说明 ​

请求限制 ​

请求参数 ​

主要参数 ​

附加参数 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应结构 ​

顶层字段 ​

tasks[] 字段 ​

result[] 字段 ​

items[] 字段说明 ​

links[] 字段 ​

dataset_providers[] 字段 ​

formats[] 字段 ​

authors[] 字段 ​

licenses[] 字段 ​

period_covered 字段 ​

dataset_description 字段 ​

dataset_description.links[] 字段 ​

响应示例 ​

错误处理 ​

使用说明 ​

实用场景 ​