通过任务 ID 获取 Bing Organic Advanced SERP 结果

GET /v3/serp/bing/organic/task_get/advanced/{id}

接口说明

用于根据任务 ID 获取 Bing 自然搜索（Organic）Advanced 模式的 SERP 结果。

请求方式：GET 请求地址：https://api.seermartech.cn/v3/serp/bing/organic/task_get/advanced/$id

该接口本身不会重复扣费。费用在创建任务时产生；任务创建后，可在 30 天多次获取结果。

实扣费以响应头 X-SeerMarTech-Charge-CNY 为准
本接口获取结果通常为 cost = 0

请求参数

路径参数

字段	类型	说明
`id`	string	任务唯一标识，UUID 格式。任务创建后可在 30 天随时通过该 ID 获取结果。

沙盒调试

如需查看该端点可返回的所有 SERP素类型及字段结构，可使用沙盒地址：

https://sandbox.seermartech.cn/v3/serp/bing/organic/task_get/advanced/00000000-0000-0000-0000-000000000000

说明：

沙盒响应会返回该端点支持的完整字段结构
字段值为模拟数据
使用沙盒端点不会扣费

响应结构

接口返回 JSON 数据，顶层 tasks 数组。

顶层字段

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

建议在接时对 status_code、status_message 以及任务级别错误做完整异常处理。

`tasks[]` 字段

字段	类型	说明
`id`	string	任务 ID，UUID 格式
`status_code`	integer	任务状态码，范围通常为 `10000-60000`
`status_message`	string	任务状态信息
`time`	string	任务执行耗时
`cost`	float	任务成本，单位 USD
`result_count`	integer	`result` 数组中的结果数
`path`	array	请求路径
`data`	object	与创建任务时 POST 请求中一致的参数
`result`	array	结果数组

`tasks[].result[]` 字段

字段	类型	说明
`keyword`	string	查询；返回时会对 `%##` 解码，`+` 会被还原为空格
`type`	string	搜索引擎类型
`se_domain`	string	搜索引擎域名
`location_code`	integer	地区编码
`language_code`	string	语言编码
`check_url`	string	搜索结果直达链接，可用于核验结果准确性
`datetime`	string	抓取结果时间，UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`
`spell`	object	搜索引擎自动纠错信息
`refinement_chips`	object	搜索细化 chips；该字段为 `null`
`item_types`	array	当前 SERP 中出现的结果类型列表
`se_results_count`	integer	SERP 总结果数
`pages_count`	integer	已抓取的结果页数
`items_count`	integer	`items` 数组中的数量
`items`	array	SERP 中识别到的各类结果

`spell` 字段

当搜索引擎对进行了纠错并按纠错词返回结果时，会以下：

字段	类型	说明
`keyword`	string	自动纠错后的
`type`	string	纠错类型

type 可能值：

did_you_mean
showing_results_for
no_results_found_for
including_results_for

`item_types` 可能值

answer_box
carousel
events
featured_snippet
hotels_pack
images
jobs
local_pack
map
organic
paid
people_also_ask
people_also_search
questions_and_answers
recipes
related_searches
shopping
top_stories
video
ai_overview

`items[]`素说明

Advanced 模式会返回 SERP 中识别出的不同模块。以下为各类型的主要字段定义。

1. `organic` 自然结果

字段	类型	说明
`type`	string	固定为 `organic`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	SERP局绝对排名
`page`	integer	所在搜索结果页码
`position`	string	页面位置：`left` / `right`
`xpath`	string	素 XPath
`domain`	string	结果域名
`title`	string	标题
`url`	string	结果链接
`cache_url`	string	缓存页面链接
`related_search_url`	string	相似搜索链接
`breadcrumb`	string	面屑
`website_name`	string	网站名称
`is_image`	boolean	是否图片
`is_video`	boolean	是否视频
`is_featured_snippet`	boolean	是否属于精选摘要来源
`is_malicious`	boolean	是否被标记为恶意
`is_web_story`	boolean	是否被标记为 Web Story
`description`	string	摘要描述
`pre_snippet`	string	摘要前附加信息
`extended_snippet`	string	摘要后附加信息
`images`	array	附带图片
`amp_version`	boolean	是否存在 AMP 版本
`rating`	object	评分信息
`price`	object	价格信息
`highlighted`	array	摘要中加粗高亮的词
`links`	array	站点链接
`faq`	object	FAQ 扩展
`extended_people_also_search`	array	回退搜索页后出现的搜索扩展
`about_this_result`	object	“此结果”信息；在 Bing 中始终为 `null`
`related_result`	array	同域结果；在 Bing 中始终为 `null`
`timestamp`	string	发布时间，UTC
`rectangle`	object	页面坐标和尺寸信息；当创建任务时 `calculate_rectangles=true` 才返回

`images[]`

字段	类型	说明
`type`	string	固定为 `images_element`
`alt`	string	图片 alt 文本
`url`	string	页面链接
`image_url`	string	图片 URL

`rating`

字段	类型	说明
`rating_type`	string	评分类型：`Max5`、`Percents`、`CustomMax`
`value`	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	搜索结果中展示的原始价格文本

`links[]`

字段	类型	说明
`type`	string	固定为 `link_element`
`title`	string	链接标题
`description`	string	链接描述
`url`	string	链接地址

`faq`

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

`faq.items[]`

字段	类型	说明
`type`	string	固定为 `faq_box_element`
`title`	string	问题标题
`description`	string	展开的答案文本
`links`	array	FAQ 中的链接

2. `paid` 付费广告结果

字段	类型	说明
`type`	string	固定为 `paid`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	局绝对排名
`page`	integer	页码
`position`	string	`left` / `right`
`xpath`	string	素 XPath
`domain`	string	广告域名
`description`	string	广告描述
`title`	string	广告标题
`url`	string	广告链接
`breadcrumb`	string	面屑
`highlighted`	array	高亮词
`extra`	object	附加信息
`description_rows`	array	扩展描述
`links`	array	站点链接
`price`	object	价格信息
`rectangle`	object	页面坐标和尺寸

`extra`

字段	类型	说明
`ad_aclk`	string	广告标识符

3. `answer_box` 答案框

字段	类型	说明
`type`	string	固定为 `answer_box`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	局绝对排名
`page`	integer	页码
`position`	string	`left` / `right`
`xpath`	string	素 XPath
`text`	array	文本，无则为 `null`
`links`	array	附带链接
`rectangle`	object	页面坐标和尺寸

4. `related_searches` 搜索

字段	类型	说明
`type`	string	固定为 `related_searches`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	局绝对排名
`page`	integer	页码
`position`	string	`left` / `right`
`xpath`	string	素 XPath
`items`	array	部条目
`rectangle`	object	页面坐标和尺寸

5. `people_also_search` 人在搜

字段	类型	说明
`type`	string	固定为 `people_also_search`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	局绝对排名
`page`	integer	页码
`position`	string	`left` / `right`
`xpath`	string	素 XPath
`title`	string	模块标题
`items`	array	部条目
`rectangle`	object	页面坐标和尺寸

6. `local_pack` 本地结果

字段	类型	说明
`type`	string	固定为 `local_pack`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	局绝对排名
`page`	integer	页码
`position`	string	`left` / `right`
`xpath`	string	素 XPath
`title`	string	商家名称
`description`	string	描述
`domain`	string	域名
`phone`	string	电话
`url`	string	链接
`is_paid`	boolean	是否为广告
`rating`	object	评分信息
`cid`	string	Bing 定义的商家唯一 ID
`is_claimed`	boolean	是否已认领
`rectangle`	object	页面坐标和尺寸

7. `hotels_pack`店

字段	类型	说明
`type`	string	固定为 `hotels_pack`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	局绝对排名
`page`	integer	页码
`position`	string	`left` / `right`
`xpath`	string	素 XPath
`title`	string	模块标题
`date_from`	string	住开始日期，格式 `yyyy-mm-dd`
`date_to`	string	住结束日期，格式 `yyyy-mm-dd`
`items`	array	店条目
`rectangle`	object	页面坐标和尺寸

`hotels_pack.items[]`

字段	类型	说明
`type`	string	固定为 `hotels_pack_element`
`price`	object	对应日期区间下的价格
`title`	string	店名称
`desription`	string	描述
`hotel_identifier`	string	Bing 分的唯一标识
`domain`	string	域名
`url`	string	链接
`is_paid`	boolean	是否广告
`rating`	object	评分
`rectangle`	object	页面坐标和尺寸

8. `carousel` 轮播模块

字段	类型	说明
`type`	string	固定为 `carousel`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	局绝对排名
`page`	integer	页码
`position`	string	`left` / `right`
`xpath`	string	素 XPath
`title`	string	模块标题
`items`	array	子项
`rectangle`	object	页面坐标和尺寸

`carousel.items[]`

字段	类型	说明
`type`	string	固定为 `carousel_element`
`title`	string	子项标题
`subtitle`	string	子项副标题

9. `events` 事件模块

字段	类型	说明
`type`	string	固定为 `events`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	局绝对排名
`page`	integer	页码
`position`	string	`left` / `right`
`xpath`	string	素 XPath
`title`	string	模块标题
`url`	string	链接
`items`	array	事件条目
`rectangle`	object	页面坐标和尺寸

`events.items[]`

字段	类型	说明
`type`	string	固定为 `events_element`
`title`	string	事件标题
`description`	string	摘要
`url`	string	事件链接

10. `featured_snippet` 精选摘要

字段	类型	说明
`type`	string	固定为 `featured_snippet`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	局绝对排名
`page`	integer	页码
`position`	string	`left` / `right`
`xpath`	string	素 XPath
`domain`	string	来源域名
`title`	string	标题
`featured_title`	string	摘要来源页标题
`description`	string	描述
`timestamp`	string	发布时间，UTC
`url`	string	链接
`images`	array	附图
`table`	object	表格数据，无则为 `null`
`rectangle`	object	页面坐标和尺寸

11. `images` 图片模块

字段	类型	说明
`type`	string	固定为 `images`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	局绝对排名
`page`	integer	页码
`position`	string	`left` / `right`
`xpath`	string	素 XPath
`title`	string	模块标题
`url`	string	链接
`items`	array	图片列表
`related_image_searches`	array	图片搜索建议
`rectangle`	object	页面坐标和尺寸

`images.items[]`

字段	类型	说明
`type`	string	固定为 `images_element`
`alt`	string	图片 alt 文本
`url`	string	原始图片来源链接
`image_url`	string	压缩图片链接

12. `shopping` 购物模块

字段	类型	说明
`type`	string	固定为 `shopping`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	局绝对排名
`page`	integer	页码
`position`	string	`left` / `right`
`xpath`	string	素 XPath
`title`	string	模块标题
`items`	array	商品条目
`rectangle`	object	页面坐标和尺寸

`shopping.items[]`

字段	类型	说明
`type`	string	固定为 `shopping_element`
`title`	string	商品标题
`price`	object	价格信息
`source`	string	信息来源
`description`	string	描述
`marketplace`	string	商家平台
`marketplace_url`	string	平台页面链接
`url`	string	商品链接

13. `jobs` 招聘模块

字段	类型	说明
`type`	string	固定为 `jobs`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	局绝对排名
`page`	integer	页码
`position`	string	`left` / `right`
`xpath`	string	素 XPath
`title`	string	模块标题
`url`	string	链接
`items`	array	职位条目
`rectangle`	object	页面坐标和尺寸

`jobs.items[]`

字段	类型	说明
`type`	string	固定为 `jobs_element`
`title`	string	职位标题
`description`	string	描述
`location`	string	工作地点
`author`	string	发布方
`job_posted_time`	string	发布时间文本
`timestamp`	string	发布时间，UTC
`contract_type`	string	合同类型
`salary`	string	薪资
`url`	string	链接

14. `map` 地图模块

字段	类型	说明
`type`	string	固定为 `map`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	局绝对排名
`page`	integer	页码
`position`	string	`left` / `right`
`xpath`	string	素 XPath
`title`	string	标题
`url`	string	链接
`rectangle`	object	页面坐标和尺寸

15. `people_also_ask` 提问

字段	类型	说明
`type`	string	固定为 `people_also_ask`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	局绝对排名
`page`	integer	页码
`position`	string	`left` / `right`
`xpath`	string	素 XPath
`items`	array	问题条目
`rectangle`	object	页面坐标和尺寸

`people_also_ask.items[]`

字段	类型	说明
`type`	string	固定为 `people_also_ask_element`
`title`	string	问题标题
`xpath`	string	子 XPath
`expanded_element`	array	展开后的答案

`expanded_element[]`

字段	类型	说明
`type`	string	固定为 `people_also_ask_expanded_element`
`featured_title`	string	标题
`url`	string	链接
`domain`	string	域名
`title`	string	结果标题
`description`	string	摘要
`timestamp`	string	发布时间，UTC
`table`	object	表格数据

16. `questions_and_answers` 问答模块

字段	类型	说明
`type`	string	固定为 `questions_and_answers`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	局绝对排名
`page`	integer	页码
`position`	string	`left` / `right`
`xpath`	string	素 XPath
`items`	array	问答条目
`rectangle`	object	页面坐标和尺寸

`questions_and_answers.items[]`

字段	类型	说明
`type`	string	固定为 `questions_and_answers_element`
`url`	string	条目链接
`question_text`	string	问题文本
`answer_text`	string	回答文本
`source`	string	来源
`domain`	string	来源域名

17. `recipes` 菜谱模块

字段	类型	说明
`type`	string	固定为 `recipes`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	局绝对排名
`page`	integer	页码
`position`	string	`left` / `right`
`xpath`	string	素 XPath
`items`	array	菜谱条目
`rectangle`	object	页面坐标和尺寸

`recipes.items[]`

字段	类型	说明
`type`	string	固定为 `recipes_element`
`title`	string	标题
`url`	string	链接
`domain`	string	域名
`source`	string	来源
`description`	string	摘要
`time`	string	制作总时长
`rating`	object	评分

18. `top_stories` 热门新闻

字段	类型	说明
`type`	string	固定为 `top_stories`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	局绝对排名
`page`	integer	页码
`position`	string	`left` / `right`
`xpath`	string	素 XPath
`items`	array	新闻条目
`rectangle`	object	页面坐标和尺寸

`top_stories.items[]`

字段	类型	说明
`type`	string	固定为 `top_stories_element`
`source`	string	来源
`domain`	string	域名
`title`	string	标题
`date`	string	发布日期文本
`amp_version`	boolean	是否有 AMP 版本
`timestamp`	string	发布时间，UTC
`url`	string	链接
`image_url`	string	图片地址
`badges`	array	角标信息

19. `video` 视频模块

字段	类型	说明
`type`	string	固定为 `video`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	局绝对排名
`page`	integer	页码
`position`	string	`left` / `right`
`xpath`	string	素 XPath
`items`	array	视频条目
`rectangle`	object	页面坐标和尺寸

`video.items[]`

字段	类型	说明
`type`	string	固定为 `video_element`
`source`	string	视频来源平台
`title`	string	标题
`timestamp`	string	发布时间，UTC
`url`	string	链接

20. `ai_overview` AI Overview 模块

字段	类型	说明
`type`	string	固定为 `ai_overview`
`rank_group`	integer	同类型分组排名
`rank_absolute`	integer	局绝对排名
`page`	integer	页码
`position`	string	`left` / `right`
`xpath`	string	素 XPath
`markdown`	string	模块的 Markdown
`items`	array	模块项
`references`	array	模块级引用来源
`rectangle`	object	页面坐标和尺寸

`ai_overview.items[]` 可能类型

ai_overview_element
ai_overview_video_element
ai_overview_videos_element
ai_overview_images_element
ai_overview_organic_element

`ai_overview_element`

字段	类型	说明
`type`	string	固定为 `ai_overview_element`
`title`	string	标题
`text`	string	文本
`images`	array	图片
`references`	array	引用来源

`ai_overview_reference`

字段	类型	说明
`type`	string	固定为 `ai_overview_reference`
`source`	string	来源名称或标题
`domain`	string	来源域名
`url`	string	来源页面链接
`title`	string	来源页面标题
`text`	string	被用于生成的文本片段

`ai_overview_video_element`

字段	类型	说明
`type`	string	固定为 `ai_overview_video_element`
`position`	string	位置：`left` / `right`
`title`	string	视频标题
`snippet`	string	视频摘要
`url`	string	视频链接
`domain`	string	托管域名
`image_url`	string	缩略图链接
`source`	string	视频平台
`date`	string	发布时间文本
`timestamp`	string	发布时间，UTC

`ai_overview_videos_element`

字段	类型	说明
`type`	string	固定为 `ai_overview_videos_element`
`items`	array	视频列表

`ai_overview_images_element`

字段	类型	说明
`type`	string	固定为 `ai_overview_images_element`
`url`	string	查看更多图片的链接
`title`	string	图片集合标题
`items`	array	图片列表

`ai_overview_organic_element`

字段	类型	说明
`type`	string	固定为 `ai_overview_organic_element`
`title`	string	自然结果标题
`url`	string	链接
`domain`	string	域名
`snippet`	string	摘要
`breadcrumb`	string	面屑
`website_name`	string	网站名
`links`	array	附加链接
`highlighted`	array	高亮
`references`	array	附加引用来源

`rectangle` 坐标字段说明

多个都可能返回 rectangle 对象，用于描述 SERP 页面中的像素位置和尺寸。

字段	类型	说明
`x`	integer	左上角 x 坐标
`y`	integer	左上角 y 坐标
`width`	integer	素宽度（像素）
`height`	integer	素高度（像素）

当创建任务时将 calculate_rectangles 设为 true，该字段才会返回；否则为 null。

调用示例

cURL

bash

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

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

Python

python

import requests

task_id = "02231256-2604-0066-2000-57133b8fc54e"

url = f"https://api.seermartech.cn/v3/serp/bing/organic/task_get/advanced/{task_id}"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
data = response.json

print(data)

TypeScript

typescript

import axios from "axios";

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

axios({
 method: "get",
 url: `https://api.seermartech.cn/v3/serp/bing/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

{
 "version": "0.1.20200129",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.2347 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "serp",
 "function": "task_get",
 "se": "bing",
 "se_type": "organic",
 "language_name": "English",
 "location_name": "United States",
 "keyword": "flight ticket new york san francisco",
 "priority": 2,
 "tag": "tag2",
 "device": "desktop",
 "os": "windows"
 },
 "result": [
 {
 "se_results_count": 99148,
 "pages_count": 1,
 "items_count": 110,
 "items": [
 {
 "type": "organic",
 "rank_group": 1,
 "rank_absolute": 2,
 "page": 1,
 "position": "left",
 "xpath": "/html/body/div/main/ol/li",
 "domain": "www.imdb.com",
 "title": "Star Wars Cast(1977-Present) - IMDb",
 "url": "https://www.imdb.com/list/ls070679507/",
 "cache_url": null,
 "related_search_url": null,
 "breadcrumb": "https://www.imdb.com/list/ls070679507",
 "website_name": "IMDb",
 "is_image": false,
 "is_video": false,
 "is_featured_snippet": false,
 "is_malicious": false,
 "is_web_story": false,
 "description": "Star Wars Cast (1977-Present) 1. Mark Hamill. Actor | Star Wars. Mark Hamill is best known for his portrayal of Luke Skywalker in the original Star Wars trilogy...",
 "pre_snippet": null,
 "extended_snippet": null,
 "images": null,
 "amp_version": false,
 "rating": null,
 "price": null,
 "highlighted": [],
 "links": null,
 "faq": null,
 "extended_people_also_search": null,
 "about_this_result": null,
 "related_result": null,
 "timestamp": null,
 "rectangle": {
 "x": 160,
 "y": 571,
 "width": 648,
 "height": 986
 }
 },
 {
 "type": "images",
 "rank_group": 1,
 "rank_absolute": 4,
 "page": 1,
 "position": "left",
 "xpath": "/html/body/div/main/ol/li",
 "title": "Images of Star Wars Cast",
 "url": "https://www.bing.com/images/search?q=star+wars+cast",
 "items": [],
 "related_image_searches": [],
 "rectangle": {
 "x": 160,
 "y": 571,
 "width": 648,
 "height": 986
 }
 },
 {
 "type": "top_stories",
 "rank_group": 1,
 "rank_absolute": 7,
 "page": 1,
 "position": "left",
 "xpath": "/html/body/div/main/ol/li",
 "title": "News about Star Wars Cast",
 "items": [],
 "rectangle": {
 "x": 160,
 "y": 571,
 "width": 648,
 "height": 986
 }
 },
 {
 "type": "video",
 "rank_group": 1,
 "rank_absolute": 10,
 "page": 1,
 "position": "left",
 "xpath": "/html/body/div/main/ol/li",
 "items": [],
 "rectangle": {
 "x": 160,
 "y": 571,
 "width": 648,
 "height": 986
 }
 },
 {
 "type": "people_also_ask",
 "rank_group": 1,
 "rank_absolute": 8,
 "page": 1,
 "position": "left",
 "xpath": "/html/body/div/main/ol/li",
 "items": [
 {
 "type": "people_also_ask_element",
 "title": "Who are the most popular characters in Star Wars?",
 "xpath": "/html/body/div/main/ol/li/div/div/div/div/div/div/div",
 "expanded_element": null
 }
 ],
 "rectangle": {
 "x": 160,
 "y": 2964.3,
 "width": 648,
 "height": 260
 }
 },
 {
 "type": "local_pack",
 "rank_group": 1,
 "rank_absolute": 1,
 "page": 1,
 "position": "left",
 "xpath": "/html/body/div/main/ol/li/div/div/div/div",
 "title": "Angelo's Barber Shop",
 "description": "DIRECTIONS WEBSITE",
 "domain": "www.angelosbarbershop.com",
 "phone": null,
 "url": "https://www.angelosbarbershop.com/dtla--biltmore-hotel-",
 "is_paid": false,
 "rating": {
 "rating_type": "Max5",
 "value": 4.5,
 "votes_count": 11,
 "rating_max": 5
 },
 "cid": null,
 "is_claimed": true,
 "rectangle": {
 "x": 180,
 "y": 446,
 "width": 608,
 "height": 109
 }
 },
 {
 "type": "ai_overview",
 "rank_group": 25,
 "rank_absolute": 211,
 "page": 1,
 "position": "left",
 "xpath": "XPatha2ffe97b-67c8-4aca-a1a3-e96ef3817da8",
 "markdown": null,
 "items": [],
 "references": [],
 "rectangle": {
 "x": 165,
 "y": 197,
 "width": 149,
 "height": 141
 }
 }
 ]
 }
 ]
 }
 ]
}

错误处理

建议至少按以下层级处理错误：

HTTP 层错误：如 401、403、429、500
顶层状态错误：检查 status_code 与 status_message
任务级错误：检查 tasks[].status_code 与 tasks[].status_message
结果为空：如任务尚未完成，或 result 为 null

一般判断建议：

status_code = 20000：请求成功
任务级 status_code >= 40000：通常表示任务处理出错，应结合 status_message 排查

使用建议

通过对应的任务提交接口创建任务，再保存返回的 id
如需批量消费结果，可合 /v3/serp/bing/organic/tasks_ready 获取已完成任务列表
如需页面坐标，请在创建任务时启用 calculate_rectangles
对 item_types 做分支处理，可更稳定地解析不同 SERP 模块
Bing 下 about_this_result 和 related_result 字段通常为 null

实用场景

拉取自然排名：按任务 ID 获取指定的完整 Bing SERP，用于排名监控、收录检查和竞品对比。
识别 SERP 特征占位：分析 item_types 与 items，判断是否出现图片、新闻、问答、本地、AI Overview 等模块，帮助制定更细分的 SEO 策略。
监控广告与自然结果竞争：同时提取 paid 与 organic素，评估某页的广告挤压程度与自然流量空间。
分析本地搜索机会：读取 local_pack、map、hotels_pack 等字段，判断本地商家或门店词的展示机会与优化重点。
还原页面布局影响：结合 rank_absolute、position 和 rectangle，评估不同模块在页面中的视觉占位，为 CTR 预测和版位研究提供数据支持。

通过任务 ID 获取 Bing Organic Advanced SERP 结果 ​

接口说明 ​

请求参数 ​

路径参数 ​

沙盒调试 ​

响应结构 ​

顶层字段 ​

tasks[] 字段 ​

tasks[].result[] 字段 ​

spell 字段 ​

item_types 可能值 ​

items[]素说明 ​

1. organic 自然结果 ​

images[] ​

rating ​

price ​

links[] ​

faq ​

faq.items[] ​

2. paid 付费广告结果 ​

extra ​

3. answer_box 答案框 ​

4. related_searches 搜索 ​

5. people_also_search 人在搜 ​

6. local_pack 本地结果 ​

7. hotels_pack店 ​

hotels_pack.items[] ​

8. carousel 轮播模块 ​

carousel.items[] ​

9. events 事件模块 ​

events.items[] ​

10. featured_snippet 精选摘要 ​