按任务 ID 获取百度自然搜索高级 SERP 结果

本接口使用 GET 方法，通过任务 ID 获取百度自然搜索结果的高级 SERP 数据。

接口路径：

GET https://api.seermartech.cn/v3/serp/baidu/organic/task_get/advanced/$id

计费说明

• 任务结果在任务提交后的 30 天可重复获取。
• 费用在提交任务时产生，本接口不会因获取结果重复扣费。
• 扣费以提交任务时的计费结果为准。
• 实扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求参数

路径参数

参数	类型	说明
id	string	任务唯一标识，UUID 格式。任务提交后 30 天可使用该 ID 随时获取结果。

请求示例

cURL

id="02261816-2027-0066-0000-c27d02864073"

curl --location --request GET \
  "https://api.seermartech.cn/v3/serp/baidu/organic/task_get/advanced/${id}" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json"

Python

import requests

task_id = "02261816-2027-0066-0000-c27d02864073"

response = requests.get(
    f"https://api.seermartech.cn/v3/serp/baidu/organic/task_get/advanced/{task_id}",
    headers={
        "Authorization": "Bearer smt_live_YOUR_KEY",
        "Content-Type": "application/json",
    },
)

response.raise_for_status()
data = response.json()
print(data)

TypeScript

import axios from "axios";

const taskId = "02231256-2604-0066-2000-57133b8fc54e";

axios
  .get(
    `https://api.seermartech.cn/v3/serp/baidu/organic/task_get/advanced/${taskId}`,
    {
      headers: {
        Authorization: "Bearer smt_live_YOUR_KEY",
        "Content-Type": "application/json",
      },
    }
  )
  .then((response) => {
    // 处理接口返回结果
    console.log(response.data);
  })
  .catch((error) => {
    // 处理请求异常
    console.error(error.response?.data || error.message);
  });

响应结构

接口返回 JSON 数据，顶层 tasks 数组。通常每个任务对象对应一个任务的处理结果。

顶层字段

字段	类型	说明
version	string	当前 API 版本。
status_code	integer	总体状态码。完整状态码列表请参考错误码文档。
status_message	string	总体状态说明。
time	string	接口执行耗时，例如 0.1110 sec.。
cost	float	平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
tasks_count	integer	tasks 数组中的任务数量。
tasks_error	integer	tasks 数组中返回错误的任务数量。
tasks	array	任务结果数组。

任务对象字段

字段	类型	说明
id	string	任务唯一标识，UUID 格式。
status_code	integer	任务状态码，通常为 10000 至 60000 范围的整数。
status_message	string	任务状态说明。
time	string	任务执行耗时。
cost	float	平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
result_count	integer	result 数组中的结果数量。
path	array	请求 URL 路径信息。
data	object	创建任务时提交的参数。
result	array	SERP 结果数组。

data 通常以下任务参数：

字段	类型	说明
api	string	API 类型，例如 serp。
function	string	API 功能，例如 task_get。
se	string	搜索引擎类型，例如 baidu。
se_type	string	SERP 类型，例如 organic。
language_code	string	语言代码，例如 zh_CN。
location_code	integer	地区代码。
keyword	string	查询。
priority	integer	任务优级。
device	string	设备类型，例如 desktop。
os	string	操作系统，例如 windows。

SERP 结果字段

result 数组中的每个结果对象通常以下字段：

字段	类型	说明
keyword	string	请求中的。返回时会对编码后的 %##进行解码，+ 会解码为空格。
type	string	搜索引擎或 SERP素类型。
se_domain	string	搜索引擎域名。
location_code	integer	地区代码。
language_code	string	语言代码。
check_url	string	对应搜索结果页的直接 URL，可用于核验结果准确性。
datetime	string	获取结果的时间，UTC 格式：yyyy-MM-dd hh:mm:ss +00:00。
spell	object	搜索引擎自动纠错信息。
refinement_chips	object	搜索细化选项。百度结果中通常为 null。
item_types	array	SERP 中的类型。
se_results_count	integer	SERP 中的结果总数。
pages_count	integer	已获取的 SERP 页数。
items_count	integer	items 数组中的数量。
items	array	SERP 中的结果。

spell 自动纠错字段

字段	类型	说明
keyword	string	搜索引擎纠正后的，结果将该返回。
type	string	纠错类型。可选值：did_you_mean、showing_results_for、no_results_found_for、including_results_for。

item_types 可选值

• images
• local_pack
• map
• organic
• paid
• related_searches
• video
• stocks_box
• dictionary
• shopping

SERP素通用字段

多数 SERP素会以下定位和排名字段：

字段	类型	说明
type	string	素类型，例如 organic、paid、images。
rank_group	integer	素在同类型组的排名。不同类型之间不会影响该字段。
rank_absolute	integer	素在整个 SERP 中的绝对排名。
page	integer	素所在的 SERP 页码。
position	string	素在 SERP 中的对齐位置，可为 left 或 right。
xpath	string	素在页面中的 XPath。
rectangle	object	素在 SERP 中的坐标和尺寸信息。百度任务暂不支持 calculate_rectangles，因此通常为 null。

rectangle 对象字段如下：

字段	类型	说明
x	integer	素左上角的横坐标。
y	integer	素左上角的纵坐标。
width	integer	素宽度，单位为像素。
height	integer	素高度，单位为像素。

自然结果 organic

当 type 为 organic 时，可能以下字段：

字段	类型	说明
domain	string	结果域名。
title	string	搜索结果标题。
url	string	搜索结果 URL。
cache_url	string	页面缓存 URL。
related_search_url	string	搜索 URL。
breadcrumb	string	面屑导航。
website_name	string	网站名称。
description	string	搜索结果描述。
pre_snippet	string	描述前附加的信息。
extended_snippet	string	描述后附加的信息。
is_image	boolean	是否图片。
is_video	boolean	是否视频。
is_featured_snippet	boolean	是否为精选摘要。
is_malicious	boolean	是否被标记为恶意结果。
is_web_story	boolean	是否为网页。
amp_version	boolean	是否存在 AMP 版本。
highlighted	array	描述中以粗体突出显示的词语。
links	array	站点链接，没有时为 null。
faq	object	常见问题扩展，没有时为 null。
extended_people_also_search	array	搜索扩展。
related_result	array	同域名下的结果。
about_this_result	object	结果补信息。百度结果中始终为 null。
timestamp	string	结果发布时间，UTC 格式。

图片字段

images 数组中的字段：

字段	类型	说明
type	string	固定为 images_element。
alt	string	图片替代文本。
url	string	结果 URL。
image_url	string	图片 URL。可能指向原始资源，也可能指向本平台存储的图片。

评分字段

rating 对象字段：

字段	类型	说明
rating_type	string	评分类型：Max5、Percents 或 CustomMax。
value	integer/float	评分值。
votes_count	integer	评价数量。
rating_max	integer	评分上限。

价格字段

price 对象字段：

字段	类型	说明
current	float	当前价格。
regular	float	未折扣的常规价格。
max_value	float	价格区间中的最高价格。
currency	string	价格币种的 ISO 代码。
is_price_range	boolean	是否为价格区间。
displayed_price	string	SERP 中原始展示的价格文本。

站点链接与 FAQ

links 数组中的链接：

字段	类型	说明
type	string	固定为 link_element。
title	string	链接标题。
description	string	链接描述。
url	string	站点链接 URL。

faq 对象字段：

字段	类型	说明
type	string	固定为 faq_box。
items	array	FAQ 问答列表。

FAQ 项字段：

字段	类型	说明
type	string	固定为 faq_box_element。
title	string	问题。
description	string	展开区域中的答案。
links	array	FAQ 中的链接。

付费结果 paid

当 type 为 paid 时，可能：

字段	类型	说明
domain	string	广告结果域名。
title	string	广告标题。
description	string	广告描述。
url	string	广告目标 URL。
breadcrumb	string	广告面屑。
highlighted	array	描述中突出显示的词语。
extra	object	广告附加信息。
links	array	广告站点链接。
description_rows	array	扩展描述；没有时为 null。

extra 对象字段：

字段	类型	说明
ad_aclk	string	广告标识符。
description	string	广告描述。
description_rows	array	扩展描述行。

本地结果 local_pack

当 type 为 local_pack 时，可能：

字段	类型	说明
title	string	本地商户标题。
description	string	商户描述。
domain	string	商户域名。
phone	string	电话号码。
url	string	URL。
is_paid	boolean	是否为广告。
rating	object	商户评分。
cid	string	本地商户唯一 ID。

图片、视频及搜索

图片 images

字段	类型	说明
title	string	图片结果标题。
url	string	图片结果页 URL。
items	array	图片列表。

图片列表项字段：

字段	类型	说明
type	string	固定为 images_element。
alt	string	图片替代文本。
url	string	原始图片 URL。
image_url	string	百度生成的图片预览 URL。

视频 video

字段	类型	说明
items	array	视频条目列表。

视频条目字段：

字段	类型	说明
type	string	固定为 video_element。
source	string	视频来源。
title	string	视频标题。
timestamp	string	视频发布时间，UTC 格式。
url	string	视频 URL。

搜索 related_searches

字段	类型	说明
items	array	搜索条目；没有时为 null。

地图 map

字段	类型	说明
title	string	地图结果标题。
url	string	地图结果 URL。

股票信息 stocks_box

当 type 为 stocks_box 时，可能：

字段	类型	说明
title	string	股票信息标题。
source	string	股票信息来源。
snippet	string	股票摘要。
price	string	获取结果时页面展示的报价。
url	string	URL。
domain	string	结果域名。
table	object	股票数据表，没有时为 null。
graph	object	股票走势图数据，没有时为 null。

table 对象字段：

字段	类型	说明
table_header	array	表格列名，没有时为 null。
table_content	array	表格，没有时为 null。

graph 对象字段：

字段	类型	说明
items	array	当前时间段的股票数据。
previous_items	array	前一时间段的收盘数据。

图表条目字段：

字段	类型	说明
type	string	固定为 graph_element。
date	string	日期时间，ISO 8601 格式：yyyy-MM-ddTHH:mm:ss。
value	integer/float	对应时间点的股票价格。

词 dictionary

当 type 为 dictionary 时，可能：

字段	类型	说明
title	string	词结果标题。
url	string	词结果 URL。
domain	string	结果域名。
breadcrumb	string	面屑导航。
keyword	string	结果中突出显示的。
snippet	string	词摘要。
text	boolean	结果描述或文本标识。
links	array	站点链接。

购物 shopping

当 type 为 shopping 时，可能：

字段	类型	说明
title	string	购物结果标题。
items	array	商品列表。

商品条目字段：

字段	类型	说明
type	string	固定为 shopping_element。
title	string	商品标题。
price	object	商品价格信息。
source	string	商品信息来源。
description	string	商品描述。
marketplace	string	商品所在的电商平台或商户提供方。
marketplace_url	string	商品在电商平台上的页面 URL。
url	string	商品结果 URL。
rectangle	object	素位置和尺寸信息。

购物商品的 price 对象：

current、regular、max_value、currency、is_price_range 和 displayed_price 字段，含义与自然结果中的价格字段相同。

结果 related_result

同一域名下的结果可能作为主结果摘要的一部分返回，字段：

字段	类型	说明
type	string	固定为 related_result。
xpath	string	素 XPath。
domain	string	结果域名。
title	string	结果标题。
url	string	结果 URL。
cache_url	string	缓存 URL。
related_search_url	string	搜索 URL。
breadcrumb	string	面屑导航。
is_image	boolean	是否图片。
is_video	boolean	是否视频。
description	string	结果描述。
pre_snippet	string	描述前附加信息。
extended_snippet	string	描述后附加信息。
amp_version	boolean	是否存在 AMP 版本。
rating	object	结果评分。
price	object	结果价格。
highlighted	array	描述中突出显示的词语。
about_this_result	object	结果补信息；百度结果中始终为 null。

about_this_result

该对象用于描述结果的补信息，但对于百度搜索结果始终为 null。容字段：

字段	类型	说明
type	string	固定为 about_this_result_element。
url	string	结果 URL。
source	string	补信息来源。
source_info	string	网站的补描述。
source_url	string	来源详细信息 URL。
language	string	结果语言。
location	string	结果适用地区。
search_terms	array	在结果中匹到的搜索词。
related_terms	array	搜索词。

响应示例

{
  "version": "0.1.20210129",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.1110 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "02261816-2027-0066-0000-c27d02864073",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.1000 sec.",
      "cost": 0,
      "result_count": 1,
      "data": {
        "api": "serp",
        "function": "task_get",
        "se": "baidu",
        "se_type": "organic",
        "language_code": "zh_CN",
        "location_code": 2156,
        "keyword": "我附近的餐",
        "priority": 2,
        "device": "desktop",
        "os": "windows"
      },
      "result": [
        {
          "keyword": "我附近的餐",
          "type": "organic",
          "se_domain": "www.baidu.com",
          "location_code": 2156,
          "language_code": "zh_CN",
          "check_url": "https://www.baidu.com/s?wd=%E6%88%91%E9%99%84%E8%BF%91%E7%9A%84%E9%A4%90%E5%8E%85",
          "datetime": "2019-11-15 12:57:46 +00:00",
          "item_types": [
            "organic",
            "local_pack",
            "paid",
            "images",
            "video",
            "related_searches"
          ],
          "se_results_count": 100000000,
          "pages_count": 1,
          "items_count": 2,
          "items": [
            {
              "type": "organic",
              "rank_group": 1,
              "rank_absolute": 1,
              "page": 1,
              "position": "left",
              "xpath": "/html/body/div/div/div/div/div",
              "domain": "www.baidu.com",
              "title": "离我最近的24小时餐饮",
              "url": "https://www.baidu.com/link?url=example",
              "description": "最佳答案：找一个离我近的饭店",
              "is_image": false,
              "is_video": false,
              "is_featured_snippet": false,
              "is_malicious": false,
              "is_web_story": false,
              "amp_version": false,
              "links": null,
              "faq": null,
              "rectangle": null
            },
            {
              "type": "local_pack",
              "rank_group": 1,
              "rank_absolute": 2,
              "page": 1,
              "position": "left",
              "title": "特色餐",
              "description": "￥81起，192条评论",
              "domain": "www.baidu.com",
              "phone": "0531-82070315",
              "url": "https://www.baidu.com/link?url=example",
              "is_paid": false,
              "rating": null,
              "cid": null,
              "rectangle": null
            }
          ]
        }
      ]
    }
  ]
}

响应状态处理

建议客户端同时判断以下字段：

• 顶层 status_code：判断接口请求是否成功。
• 任务对象中的 status_code：判断任务是否成功。
• 任务对象中的 result：判断是否存在可用结果。
• tasks_error：统计批量任务中失败的任务数量。

当状态码表示错误或 result 为空时，应记录 status_message，并根据业务需要执行重试、告警或人工排查。

实用场景

• 监控自然排名：按任务 ID 获取百度指定的完整 SERP，评估页面排名变化和 SEO 优化效果。
• 分析 SERP 特征占位：统计自然结果、图片、视频、地图、本地结果、广告和购物模块，指导与页面结构优化。
• 识别竞争对手页面：提取排名、标题、描述、域名和 URL，建立竞争对手排名与页面资产单。
• 评估本地 SEO 表现：读取 local_pack 中的商户名称、电话、评分和商户 ID，分析门店在百度本地结果中的。
• 审查搜索结果展示质量：结合 description、breadcrumb、站点链接、FAQ 和图片字段，检查页面在百度 SERP 中的摘要与增强展示效果。