Bing 页面交集（实时）

接口说明

通过本接口，您可以获取多个指定页面在同一 Bing 搜索结果页（SERP）中排名的。

该接口支持两类型分析方式：

查找多个页面覆盖的 传 pages 对象时，接口会返回这些 URL 的交集，即这些页面在同一 Bing SERP 中出现的。
查找竞争对手覆盖、而您未覆盖的 同时传 pages 和 exclude_pages 时，接口会返回：pages 中页面有排名，但 exclude_pages 中页面没有排名的。

请求地址

POST https://api.seermartech.cn/v3/dataforseo_labs/bing/page_intersection/live

计费说明

该接口按请求计费。

参考价需以平台实时计费为准；扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求规范

请求方法：POST
请求体格式：JSON
编码：UTF-8
请求体为 JSON 数组：[{ ... }]
频率限制：每分钟最多 2000 次调用
并发限制：最多 30 个同时请求

您可以通过 limit、offset、filters、order_by 控制返回数量、分页、筛选和排序。

请求参数

顶层参数

字段	类型	说明
`pages`	object	填。目标页面 URL 集合。最多可设置 20 个页面。使用绝对 URL（ `http://` 或 `https://`）。
`exclude_pages`	array	可选。需排除的页面 URL。最多可设置 10 个页面。
`location_name`	string	当未传 `location_code` 时填。地区名。
`location_code`	integer	当未传 `location_name` 时填。地区编码。
`language_name`	string	当未传 `language_code` 时填。语言名。
`language_code`	string	当未传 `language_name` 时填。语言编码。
`item_types`	array	可选。指定响应中的搜索结果类型。
`ignore_synonyms`	boolean	可选。是否忽略高度相似。`true` 表示返回核心。默认 `false`。
`limit`	integer	可选。返回数量上限。默认 `100`，最大 `1000`。
`offset`	integer	可选。结果偏移量。默认 `0`。
`include_subdomains`	boolean	可选。是否子域名。默认 `true`；若为 `false`，则忽略子域名。
`intersection_mode`	string	可选。控制多个 `pages` 的结果是取并集还是交集。可选值：`union`、`intersect`。
`include_serp_info`	boolean	可选。是否返回每个的 SERP 信息。默认 `false`。
`filters`	array	可选。结果筛选条件，最多 8 个过滤条件。
`order_by`	array	可选。结果排序规则，最多 3 条。
`tag`	string	可选。自定义任务标识，最大长度 255。会原样返回在响应的 `data` 对象中。

`pages`

pages 用于指定要分析的页面集合。

示例：

json

"pages": {
 "1": "https://www.apple.com/mac/*",
 "2": "https://example.com/*",
 "3": "https://support.microsoft.com/"
}

说明：

最多支持 20 个页面
键名通常使用 "1" 到 "20" 的字符串编号
支持使用通符 * 指定 URL 模式
若只传一个页面，则只返回该页面结果
页面使用绝对 URL

通符规则

支持在 URL 末尾使用 * 进行前缀匹，例如：

"https://example.com"：匹精确 URL
"https://example.com/eng/*"：匹 /eng/ 开头的该目录及下所有 URL

注意：

通符 *须放在 URL 末尾，且位于最后一个 / 之后
不支持这样写：https://example.com*
应写为：https://example.com/*

注意：如果交集数量 1000 万，本接口将不返回结果。

`exclude_pages`

用于指定需要排除的页面。

当传该参数时：

默认返回的是：pages 中任意一个 URL有排名、且 exclude_pages 中 URL 没有排名的
若同时设置 intersection_mode = "intersect"，则返回：pages 中所有 URL都在同一 SERP 中有排名、且 exclude_pages 中 URL 没有排名的

地区与语言参数

location_name 与 location_code 二选一填；language_name 与 language_code 二选一填。

可通过以下接口获取支持的地区和语言列表：

/v3/dataforseo_labs/locations_and_languages

注意：

当前接口支持美国地区
美国地区示例：
location_name: United States
location_code: 2840
英语示例：
language_name: English
language_code: en

`intersection_mode`

控制多个页面结果的合并方式。

可选值：

union：返回 pages 中任意一个 URL有排名的
intersect：返回 pages 中所有 URL都在同一 SERP 中有排名的

默认行为：

传 pages 时，默认按 intersect 处理
同时传 exclude_pages 时，默认按 union 处理

`include_serp_info`

若设置为 true，响应中每个会附带 serp_info 对象，：

搜索结果总数
搜索结果校验链接
SERP 中出现的结果类型
SERP 更新时间等

默认值：false

`filters`

支持对结果进行过滤，最多可同时设置 8 个条件，并使用逻辑运算符 and / or 组合。

支持的操作符：

regex
not_regex
<
<=
>
>=
=
<>
in
not_in
ilike
not_ilike
like
not_like
match
not_match

补说明：

like / not_like / ilike / not_ilike 支持 % 通
如果要按 intersection_result部字段过滤，需要带上对应页面编号

例如：

按第一个 URL 的排名过滤：使用 intersection_result.1.rank_absolute
返回第三个 URL 为自然结果的记录：使用 intersection_result.3.type

可参考路径：

/v3/dataforseo_labs/filters

`order_by`

用于结果排序。

排序方向：
asc：升序
desc：降序
最多支持 3 条排序规则
可使用与 filters 相同的字段路径

请求示例

cURL

bash

curl --request POST "https://api.seermartech.cn/v3/dataforseo_labs/bing/page_intersection/live" \
 --header "Authorization: Bearer smt_live_YOUR_KEY" \
 --header "Content-Type: application/json" \
 --data-raw '[
 {
 "pages": {
 "1": "https://example.com/*",
 "2": "https://ahrefs.com/*"
 },
 "language_name": "English",
 "location_code": 2840
 }
 ]'

Python

python

import requests

url = "https://api.seermartech.cn/v3/dataforseo_labs/bing/page_intersection/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

payload = [
 {
 "pages": {
 "1": "https://example.com/*",
 "2": "https://ahrefs.com/*"
 },
 "location_name": "United States",
 "language_name": "English"
 }
]

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

TypeScript

typescript

import axios from "axios";

const payload = [
 {
 pages: {
 "1": "https://example.com/*",
 "2": "https://ahrefs.com/*"
 },
 language_name: "English",
 location_code: 2840
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/dataforseo_labs/bing/page_intersection/live",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 data: payload
})
 .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	执行耗时，单位秒。
`cost`	float	本次请求总费用，单位 USD。
`tasks_count`	integer	`tasks` 数组中的任务数量。
`tasks_error`	integer	返回错误的任务数量。
`tasks`	array	任务结果数组。

`tasks[]` 字段

字段	类型	说明
`id`	string	任务唯一标识，UUID 格式。
`status_code`	integer	任务状态码。
`status_message`	string	任务状态消息。
`time`	string	任务执行耗时。
`cost`	float	单任务费用，单位 USD。
`result_count`	integer	`result` 数组数量。
`path`	array	URL 路径。
`data`	object	与请求中提交的参数一致。
`result`	array	实结果数组。

`result[]` 字段

字段	类型	说明
`se_type`	string	搜索引擎类型。此接口固定为 `bing`。
`pages`	object	请求中传的页面集合。
`exclude_pages`	array	请求中传的排除页面集合。
`location_code`	integer	地区编码。
`language_code`	string	语言编码。
`total_count`	integer	数据库中匹本次请求的结果总数。
`items_count`	integer	本次 `items` 返回数量。
`items`	array	及数据。

`items[]` 字段说明

每个 items素代表一个及多个页面在该 SERP 中的排名结果。

基本字段

字段	类型	说明
`se_type`	string	搜索引擎类型，固定为 `bing`。
`keyword_data`	object	数据。
`intersection_result`	object	各页面在 SERP 中的命中结果。

`keyword_data`

字段	类型	说明
`se_type`	string	搜索引擎类型。
`keyword`	string	返回的。
`location_code`	integer	地区编码。
`language_code`	string	语言编码。
`keyword_info`	object	指标数据。
`keyword_properties`	object	附加属性。
`serp_info`	object \| null	SERP 数据；若未开启 `include_serp_info` 或数据库中无数据，则为 `null`。
`avg_backlinks_info`	object \| null	该 Top 10 自然结果的平均外链指标。

`keyword_info`

字段	类型	说明
`se_type`	string	搜索引擎类型。
`last_updated_time`	string	数据更新时间，UTC 格式：`yyyy-mm-dd hh:mm:ss +00:00`
`competition`	float	竞争度，范围 `0` 到 `1`。
`cpc`	float	平均点击成本，单位 USD。
`search_volume`	integer	平均月搜索量。
`monthly_searches`	array	最近 12 个月的月度搜索量。

`monthly_searches[]`

字段	类型	说明
`year`	integer	年份
`month`	integer	月份
`search_volume`	integer	当月搜索量

`keyword_properties`

字段	类型	说明
`se_type`	string	搜索引擎类型。
`core_keyword`	string \| null	同义词聚类后的核心。
`synonym_clustering_algorithm`	string \| null	同义词识别算法。可选：`keyword_metrics`、`text_processing`。
`keyword_difficulty`	integer	难度，范围 `0` 到 `100`。
`detected_language`	string	系统识别的语言。
`is_another_language`	boolean	识别出的语言是否与请求语言不同。

`serp_info`

字段	类型	说明
`se_type`	string	搜索引擎类型。
`check_url`	string	可直接打开的搜索结果页链接，用于校验结果。
`serp_item_types`	array	SERP 中出现的结果类型。
`se_results_count`	string	该的搜索结果数量。
`last_updated_time`	string	最近一次 SERP 更新时间，UTC。
`previous_updated_time`	string	上一次 SERP 更新时间，UTC。

serp_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

注意：结果会返回以下的数据：

organic
paid
featured_snippet
local_pack

`avg_backlinks_info`

表示该下 Top 10 自然排名页面的平均外链指标。

字段	类型	说明
`se_type`	string	搜索引擎类型。
`backlinks`	float	平均外链数。
`dofollow`	float	平均 dofollow 外链数。
`referring_pages`	float	平均引荐页面数。
`referring_domains`	float	平均引荐域名数。
`referring_main_domains`	float	平均主域引荐数。
`rank`	float	平均 Rank 值。
`main_domain_rank`	float	平均主域 Rank 值。
`last_updated_time`	string	外链数据更新时间，UTC。

`intersection_result`

该对象每个指定页面在当前 SERP 中的结果。

会按 pages 中定义的编号返回，如 1、2、3
最多可返回 1 到 20 个编号对象
每个编号对象代表对应 URL 在该 SERP 中命中的结果

支持的结果类型：

organic
paid
featured_snippet
local_pack

各 SERP素通用字段

以下字段在不同类型结果中大多通用：

字段	类型	说明
`se_type`	string	搜索引擎类型。
`type`	string	结果类型。
`rank_group`	integer	同类型结果组排名。
`rank_absolute`	integer	SERP 绝对排名。
`position`	string	页面位置，可为 `left` 或 `right`。
`xpath`	string	结果节点的 XPath。
`title`	string	结果标题。
`domain`	string	结果域名或子域名。
`url`	string	命中的结果 URL。
`description`	string	结果描述。
`main_domain`	string	主域名。
`relative_url`	string	相对路径。
`etv`	float	预估自然流量。
`estimated_paid_traffic_cost`	float	预估将自然流量转换为付费流量的成本，单位 USD。
`rank_changes`	object	排名变化信息。
`backlinks_info`	object	当前排名 URL 的外链数据。
`rank_info`	object	页面与主域的 Rank 数据。

`rank_changes`

字段	类型	说明
`previous_rank_absolute`	integer \| null	上次记录的绝对排名。
`is_new`	boolean	是否为新结果。
`is_up`	boolean	排名是否上升。
`is_down`	boolean	排名是否下降。

`backlinks_info`

字段	类型	说明
`referring_domains`	integer	引荐域名数。
`referring_main_domains`	integer	引荐主域名数。
`referring_pages`	integer	引荐页面数。
`dofollow`	integer	dofollow 外链数。
`backlinks`	integer	外链总数。
`time_update`	string	外链数据更新时间，UTC。

`rank_info`

字段	类型	说明
`page_rank`	integer	页面 Rank。
`main_domain_rank`	integer	主域 Rank。

各类型结果的专有字段

1）`organic`

除通用字段外，还可能：

字段	类型	说明
`breadcrumb`	string	面屑路径。
`is_image`	boolean	是否图片。
`is_video`	boolean	是否视频。
`is_featured_snippet`	boolean	是否为精选摘要来源。
`is_malicious`	boolean	是否被标记为恶意。
`pre_snippet`	string	描述前附加信息。
`extended_snippet`	string	描述后附加信息。
`amp_version`	boolean	是否有 AMP 版本。
`rating`	object \| null	评分信息。
`highlighted`	array \| null	描述中加粗高亮的词。
`links`	array \| null	站点链接。

2）`paid`

除通用字段外，还可能：

字段	类型	说明
`breadcrumb`	string	广告面屑。
`highlighted`	array	描述中的加粗词。
`extra`	array	广告的附加信息。
`ad_aclk`	string	广告标识。
`description_rows`	array \| null	扩展描述。
`links`	array \| null	广告站点链接。

3）`local_pack`

除通用字段外，还可能：

字段	类型	说明
`phone`	string	电话号码。
`is_paid`	boolean	是否为广告。
`rating`	object	评分信息。

4）`featured_snippet`

除通用字段外，还可能：

字段	类型	说明
`featured_title`	string	精选摘要来源页标题。
`table`	array \| null	表格。
`about_this_result`	object	“此结果”的附加信息。

`about_this_result`

字段	类型	说明
`type`	string	固定为 `about_this_result_element`。
`url`	string	结果 URL。
`source`	string	附加信息来源。
`source_info`	string	来源说明。
`source_url`	string	来源链接。
`language`	string	结果语言。
`location`	string	结果适用地区。
`search_terms`	array	命中的搜索词。
`related_terms`	array	搜索词。

`rating`

字段	类型	说明
`rating_type`	string	评分类型，可能为 `Max5`、`Percents`、`CustomMax`。
`value`	integer	评分值。
`votes_count`	integer	评价数量。
`rating_max`	integer	评分上限。

`links[]`

自然结果中的站点链接可能：

字段	类型	说明
`type`	string	自然结果中通常为 `link_element`；广告中通常为 `ad_link_element`。
`title`	string	链接标题。
`description`	string	链接描述。
`url`	string	链接地址。
`ad_aclk`	string	广告链接标识广告结果可能返回。
`main_domain`	string	主域名。
`relative_url`	string	相对路径。

响应示例

json

{
 "version": "0.1.20240313",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "1.5895 sec.",
 "cost": 0.0103,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "dataforseo_labs",
 "function": "page_intersection",
 "se_type": "bing",
 "pages": {
 "1": "https://forbes.com",
 "2": "https://cnn.com/*"
 },
 "language_name": "English",
 "location_code": 2840,
 "include_serp_info": true,
 "limit": 3
 },
 "result": [
 {
 "se_type": "bing",
 "keyword_data": {
 "se_type": "bing",
 "keyword": "newsletter sign up",
 "location_code": 2840,
 "language_code": "en",
 "keyword_properties": {
 "se_type": "bing",
 "core_keyword": "newsletter signups",
 "synonym_clustering_algorithm": "text_processing",
 "keyword_difficulty": 55,
 "detected_language": "en",
 "is_another_language": false
 },
 "serp_info": {
 "se_type": "bing",
 "check_url": "https://www.bing.com/search?q=newsletter%20sign%20up&count=50&first=1&setmkt=en-US&setlang=en-us&safesearch=Moderate&form=QBLH",
 "se_results_count": 31600000,
 "last_updated_time": "2024-03-21 10:18:06 +00:00",
 "previous_updated_time": "2024-02-17 14:51:16 +00:00"
 },
 "avg_backlinks_info": null
 },
 "intersection_result": {
 "1": {
 "se_type": "bing",
 "type": "organic",
 "rank_group": 18,
 "rank_absolute": 24,
 "position": "left",
 "xpath": "/html/body/div/main/ol/li",
 "domain": "account.forbes.com",
 "title": "Forbes Newsletters",
 "url": "https://account.forbes.com/",
 "breadcrumb": "https://account.forbes.com",
 "is_image": false,
 "is_video": false,
 "is_featured_snippet": false,
 "is_malicious": false,
 "description": "Web Result By signing up, you accept and agree to our Terms of Service...",
 "etv": 0.651419997215271,
 "rank_changes": {
 "previous_rank_absolute": null,
 "is_new": true,
 "is_up": false,
 "is_down": false
 },
 "backlinks_info": {
 "referring_domains": 273,
 "referring_main_domains": 260,
 "referring_pages": 1316,
 "dofollow": 1097,
 "backlinks": 1336,
 "time_update": "2024-03-28 05:35:14 +00:00"
 },
 "rank_info": {
 "page_rank": 500,
 "main_domain_rank": 667
 }
 },
 "2": {
 "se_type": "bing",
 "type": "organic",
 "rank_group": 2,
 "rank_absolute": 7,
 "position": "left",
 "xpath": "/html/body/div/main/ol/li",
 "domain": "www.cnn.com",
 "title": "CNN newsletters: Subscribe for news, lifestyle, markets info and …",
 "url": "https://www.cnn.com/newsletters",
 "breadcrumb": "https://www.cnn.com/newsletters",
 "is_image": false,
 "is_video": false,
 "is_featured_snippet": false,
 "is_malicious": false,
 "description": "Web Result Select from our newsletters below and enter your email to sign up...",
 "etv": 26.535600662231445,
 "rank_changes": {
 "previous_rank_absolute": null,
 "is_new": true,
 "is_up": false,
 "is_down": false
 },
 "backlinks_info": {
 "referring_domains": 349,
 "referring_main_domains": 333,
 "referring_pages": 2609,
 "dofollow": 2403,
 "backlinks": 2691,
 "time_update": "2024-04-01 14:17:47 +00:00"
 },
 "rank_info": {
 "page_rank": 430,
 "main_domain_rank": 678
 }
 }
 }
 }
 ]
 }
 ]
}

状态码与错误处理

顶层 status_code 表示整次请求状态
tasks[].status_code 表示单个任务状态
建议同时检查：
HTTP 状态码
顶层 status_code
任务级 tasks[].status_code

常见成功状态：

20000：请求成功

更多错误码请参考：

/v3/appendix/errors

建议在生产环境中实现完整的异常处理、重试机制和任务级错误记录。

实用场景

识别覆盖：对比多个站点或多个栏目页，找出它们在 Bing 上排名的，用于聚类和主题重合分析。
挖掘竞品缺口词：结合 pages 与 exclude_pages，筛出竞争对手已覆盖而自身未覆盖的，快速扩选题池。
评估栏目页竞争重叠：比较不同目录、专题页或子站之间的交集，判断是否存在竞争或重复。
定位高价值 SERP 机会：开启 include_serp_info 后识别 featured_snippet、local_pack 等特征的，制定更有针对性的页面优化策略。
筛选可抢占页面级机会：根据 intersection_result.*.rank_absolute、keyword_difficulty、search_volume 等字段过滤结果，优锁定“已有排名但仍可提升”的页面与组合。

Bing 页面交集（实时） ​

接口说明 ​

请求地址 ​

计费说明 ​

请求规范 ​

请求参数 ​

顶层参数 ​

pages ​

通符规则 ​

exclude_pages ​

地区与语言参数 ​

intersection_mode ​

include_serp_info ​

filters ​

order_by ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应结构 ​

顶层响应字段 ​

tasks[] 字段 ​

result[] 字段 ​

items[] 字段说明 ​

基本字段 ​

keyword_data ​

keyword_info ​

monthly_searches[] ​

keyword_properties ​

serp_info ​

avg_backlinks_info ​

intersection_result ​

Bing 页面交集（实时）

接口说明

请求地址

计费说明

请求规范

请求参数

顶层参数

`pages`

通符规则

`exclude_pages`

地区与语言参数

`intersection_mode`

`include_serp_info`

`filters`

`order_by`

请求示例

cURL

Python

TypeScript

响应结构

顶层响应字段

`tasks[]` 字段

`result[]` 字段

`items[]` 字段说明

基本字段

`keyword_data`

`keyword_info`

`monthly_searches[]`

`keyword_properties`

`serp_info`

`avg_backlinks_info`

`intersection_result`