Bing 排名（实时）

POST /v3/dataforseo_labs/bing/ranked_keywords/live

接口说明

该接口用于获取任意域名或网页当前在 Bing 搜索结果中有排名的列表，同时返回对应的 SERP素信息、月搜索量、难度、预估流量等 SEO 数据。

接口路径：/v3/dataforseo_labs/bing/ranked_keywords/live
请求方式：POST
请求地址：https://api.seermartech.cn/v3/dataforseo_labs/bing/ranked_keywords/live

数据更新频率： 每周更新一次。最新更新时间可通过 /v3/dataforseo_labs/status/ 查询。

计费与调用限制

本接口按请求计费。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

调用限制：

每分钟最多 2000 次 API 调用
最大并发请求数：30

请求体格式

所有 POST 数据需使用 UTF-8 编码的 JSON。请求体为 JSON 数组 格式：

json

[
 {
 "target": "example.com",
 "language_name": "English",
 "location_code": 2840,
 "limit": 3
 }
]

请求参数

字段名	类型	说明
`target`	string	填。目标域名或目标网页 URL。若传域名，不能带 `https://` 或 `www.`；若传网页 URL，带 `https://` 或 `www.`。
`location_name`	string	可选。地区完整名称。传此字段时无需再传 `location_code`。地区和语言列表可通过 `/v3/dataforseo_labs/locations_and_languages` 获取。忽略该字段表示返回所有可用地区的数据。注意：当前该接口支持美国地区。示例：`United States`
`location_code`	integer	可选。地区编码。传此字段时无需再传 `location_name`。可通过 `/v3/dataforseo_labs/locations_and_languages` 获取。忽略该字段表示返回所有可用地区的数据。注意：当前该接口支持美国地区。示例：`2840`
`language_name`	string	可选。语言完整名称。传此字段时无需再传 `language_code`。可通过 `/v3/dataforseo_labs/locations_and_languages` 获取。忽略该字段表示返回所有可用语言的数据。示例：`English`
`language_code`	string	可选。语言编码。传此字段时无需再传 `language_name`。可通过 `/v3/dataforseo_labs/locations_and_languages` 获取。忽略该字段表示返回所有可用语言的数据。示例：`en`
`item_types`	array	可选。指定返回的搜索结果类型。若数组中除 `organic` 之外的类型，结果将按数组中的第一个类型排序。对于未在响应中的结果类型，无法进行排序和过滤。
`ignore_synonyms`	boolean	可选。是否忽略高度相似。设为 `true` 时返回核心，排除高度相似词。默认值：`false`
`limit`	integer	可选。返回的最大数量。默认值：`100`；最大值：`1000`
`offset`	integer	可选。结果偏移量。默认值：`0`。例如设为 `10`，则跳过前 10 个，从第 11 个开始返回。
`load_rank_absolute`	boolean	可选。是否返回按 `rank_absolute` 统计的排名分布。设为 `true` 时，响应中会 `metrics_absolute` 字段。默认值：`false`
`historical_serp_mode`	string	可选。数据筛选模式。可选值：`live`（当前仍有排名的）、`lost`（之前有排名但最近一次检查已丢失的）、`all`（同时返回两类）。默认值：`live`
`filters`	array	可选。结果过滤条件数组，最多可设置 8 个过滤器。条件之间可使用 `and` / `or`。支持操作符：`regex`、`not_regex`、`<`、`<=`、`>`、`>=`、`=`、`<>`、`in`、`not_in`、`ilike`、`not_ilike`、`like`、`not_like`、`match`、`not_match`。`like` / `not_like` / `ilike` / `not_ilike` 支持 `%` 通符。若要筛选某个页面有排名的，可对 `ranked_serp_element.serp_item.relative_url` 设置过滤。
`order_by`	array	可选。结果排序规则。可使用与 `filters` 相同的字段路径，排序方式为 `asc` 或 `desc`。单次请求最多支持 3 条排序规则。
`tag`	string	可选。自定义任务标识，最长 255 个字符。可用于在响应中识别并匹请求任务。

过滤示例

1）筛选搜索量大于 10，且结果不是付费广告的

json

[
 {
 "target": "example.com",
 "location_code": 2840,
 "language_name": "English",
 "filters": [
 ["keyword_data.keyword_info.search_volume", ">", 10],
 "and",
 [
 ["ranked_serp_element.serp_item.type", "<>", "paid"],
 "or",
 ["ranked_serp_element.serp_item.is_paid", "=", false]
 ]
 ],
 "limit": 3
 }
]

2）获取某个页面有排名的

json

[
 {
 "target": "example.com",
 "filters": [
 ["ranked_serp_element.serp_item.relative_url", "=", "/blog/seo-guide"]
 ]
 }
]

排序示例

json

[
 {
 "target": "example.com",
 "order_by": [
 ["keyword_data.keyword_info.search_volume", "desc"],
 ["ranked_serp_element.serp_item.rank_absolute", "asc"]
 ]
 }
]

响应结构

接口返回 JSON 对象 tasks 数组。

顶层字段

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

`tasks[]` 字段

字段名	类型	说明
`id`	string	任务 ID，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	搜索引擎类型
`target`	string	请求中的目标域名
`location_code`	integer	请求中的地区编码；无数据时为 `null`
`language_code`	string	请求中的语言编码；无数据时为 `null`
`total_count`	integer	数据库中与请求匹的结果总数
`items_count`	integer	本次 `items` 中返回的结果数量
`metrics`	object	按 `rank_group` 统计的排名分布与流量数据
`metrics_absolute`	object	按 `rank_absolute` 统计的排名分布；在 `load_rank_absolute=true` 时返回
`items`	array	及对应排名

`metrics` / `metrics_absolute` 字段说明

metrics 基于 rank_group 统计，即只在同类 SERP素比较位置。 metrics_absolute 基于 rank_absolute 统计，即在所有 SERP素中按绝对位置统计。

二均可能以下结果类型：

organic
paid
featured_snippet
local_pack

每个结果类型对象通常以下字段：

字段名	类型	说明
`pos_1`	integer	排名第 1 的数量
`pos_2_3`	integer	排名第 2-3 的数量
`pos_4_10`	integer	排名第 4-10 的数量
`pos_11_20`	integer	排名第 11-20 的数量
`pos_21_30`	integer	排名第 21-30 的数量
`pos_31_40`	integer	排名第 31-40 的数量
`pos_41_50`	integer	排名第 41-50 的数量
`pos_51_60`	integer	排名第 51-60 的数量
`pos_61_70`	integer	排名第 61-70 的数量
`pos_71_80`	integer	排名第 71-80 的数量
`pos_81_90`	integer	排名第 81-90 的数量
`pos_91_100`	integer	排名第 91-100 的数量
`etv`	float	预估流量
`count`	integer	该类型结果总数
`estimated_paid_traffic_cost`	float	预估付费流量成本
`is_new`	integer	新增排名数量
`is_up`	integer	排名上升的数量
`is_down`	integer	排名下降的数量
`is_lost`	integer	丢失排名的数量

`items[]` 字段说明

每个 items[]素表示一个及该目标在该下的 SERP 排名。

`keyword_data`

字段名	类型	说明
`se_type`	string	搜索引擎类型
`keyword`	string	返回的
`location_code`	integer	地区编码
`language_code`	integer/string	语言编码
`keyword_info`	object	基础数据
`keyword_properties`	object	属性数据
`serp_info`	object	SERP 概览信息
`avg_backlinks_info`	object/null	对应 top10 自然结果的平均外链数据

`keyword_info`

字段名	类型	说明
`se_type`	string	搜索引擎类型
`last_updated_time`	string	数据更新时间，UTC 时间，如 `2019-11-15 12:57:46 +00:00`
`competition`	float	竞争度，范围 0 到 1，基于广告数据；无数据时为 `null`
`cpc`	float	平均点击成本（USD）；无数据时为 `null`
`search_volume`	integer	月均搜索量；无数据时为 `null`
`monthly_searches`	array	过去 12 个月月度搜索量；无数据时为 `null`

`monthly_searches[]`

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

`keyword_properties`

字段名	类型	说明
`se_type`	string	搜索引擎类型
`core_keyword`	string	同义词聚类中的核心；若无同义词聚类结果则为 `null`
`synonym_clustering_algorithm`	string	同义词识别算法，可能值：`keyword_metrics`、`text_processing`
`keyword_difficulty`	integer	难度，0-100，对自然结果前 10 的难度评估
`detected_language`	string	系统识别出的语言
`is_another_language`	boolean	若为 `true`，表示请求设置的语言与系统识别语言不一致

`serp_info`

字段名	类型	说明
`se_type`	string	搜索引擎类型
`check_url`	string	可直接打开的搜索结果页地址，用于校验结果
`serp_item_types`	array	SERP 中检测到的结果类型
`se_results_count`	string/integer	该搜索结果数量
`keyword_difficulty`	integer	难度
`last_updated_time`	string	最近一次 SERP 数据更新时间
`previous_updated_time`	string	上一次 SERP 数据更新时间

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`

该对象提供对应自然结果前 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	外链数据更新时间

`ranked_serp_element` 字段说明

该对象表示目标域名/页面在该下命中的 SERP素。

字段名	类型	说明
`se_type`	string	搜索引擎类型
`serp_item`	object	命中的 SERP素
`check_url`	string	SERP 校验链接
`serp_item_types`	array	当前 SERP 中的结果类型
`se_results_count`	string/integer	搜索结果数量
`keyword_difficulty`	integer	难度
`is_lost`	boolean	是否为已丢失排名
`last_updated_time`	string	最近一次 SERP 更新时间
`previous_updated_time`	string	上一次 SERP 更新时间

`serp_item` 支持的结果类型

1）`organic` 自然结果

字段名	类型	说明
`type`	string	固定为 `organic`
`rank_group`	integer	同类型结果中的排名
`rank_absolute`	integer	所有 SERP素中的绝对排名
`position`	string	展示位置：`left` / `right`
`xpath`	string	素 XPath
`domain`	string	SERP 中的子域名
`title`	string	标题
`url`	string	URL
`breadcrumb`	string	面屑
`is_image`	boolean	是否图片
`is_video`	boolean	是否视频
`is_featured_snippet`	boolean	是否为精选摘要
`is_malicious`	boolean	是否被标记为恶意结果
`description`	string	描述
`pre_snippet`	string	描述前附加信息
`extended_snippet`	string	描述后附加信息
`amp_version`	boolean	是否有 AMP 版本
`rating`	object	评分信息
`highlighted`	array	描述中加粗的词
`links`	array/null	子链接（sitelinks）
`main_domain`	string	主域名
`relative_url`	string	不含协议和域名的相对路径
`etv`	float	该带来的预估自然流量
`estimated_paid_traffic_cost`	float	将该自然流量转化为付费流量的预估成本
`rank_changes`	object	排名变化信息
`backlinks_info`	object/null	目标网站外链数据
`rank_info`	object	页面/域名 Rank 数据

`rating`

字段名	类型	说明
`rating_type`	string	评分类型：`Max5`、`Percents`、`CustomMax`
`value`	integer	评分值
`votes_count`	integer	评价数量
`rating_max`	integer	最大评分值

`links[]`

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

2）`paid` 付费结果

字段名	类型	说明
`type`	string	固定为 `paid`
`rank_group`	integer	同类型结果中的排名
`rank_absolute`	integer	所有 SERP素中的绝对排名
`position`	string	展示位置：`left` / `right`
`xpath`	string	素 XPath
`title`	string	广告标题
`domain`	string	广告域名
`description`	string	描述
`breadcrumb`	string	广告面屑
`url`	string	广告目标 URL
`highlighted`	array	描述中加粗的词
`extra`	object	额外信息
`links`	array/null	广告子链接
`main_domain`	string	主域名
`relative_url`	string	相对路径
`etv`	float	预估流量
`estimated_paid_traffic_cost`	float	预估付费流量成本
`rank_changes`	object	排名变化信息
`backlinks_info`	object/null	外链数据
`rank_info`	object	页面/域名 Rank 数据

`extra`

字段名	类型	说明
`ad_aclk`	string	广告标识
`description_rows`	array/null	扩展描述行

`links[]`

字段名	类型	说明
`type`	string	固定为 `ad_link_element`
`title`	string	链接标题
`description`	string	链接描述
`url`	string	链接地址
`ad_aclk`	string	广告标识

3）`local_pack` 本地结果

字段名	类型	说明
`type`	string	固定为 `local_pack`
`rank_group`	integer	同类型结果中的排名
`rank_absolute`	integer	所有 SERP素中的绝对排名
`position`	string	展示位置：`left` / `right`
`xpath`	string	素 XPath
`title`	string	标题
`description`	string	描述
`domain`	string	域名
`phone`	string	电话
`url`	string	URL
`is_paid`	boolean	是否为广告
`rating`	object	评分信息
`main_domain`	string	主域名
`relative_url`	string	相对路径
`etv`	float	预估流量
`estimated_paid_traffic_cost`	float	预估流量成本
`rank_changes`	object	排名变化信息
`backlinks_info`	object/null	外链数据
`rank_info`	object	页面/域名 Rank 数据

4）`featured_snippet` 精选摘要

字段名	类型	说明
`type`	string	固定为 `featured_snippet`
`rank_group`	integer	同类型结果中的排名
`rank_absolute`	integer	所有 SERP素中的绝对排名
`position`	string	展示位置：`left` / `right`
`xpath`	string	素 XPath
`domain`	string	域名
`title`	string	结果标题
`featured_title`	string	摘要来源页标题
`description`	string	描述
`url`	string	URL
`table`	array/null	表格数据
`main_domain`	string	主域名
`relative_url`	string	相对路径
`etv`	float	预估流量
`estimated_paid_traffic_cost`	float	预估流量成本
`rank_changes`	object	排名变化信息
`backlinks_info`	object/null	外链数据
`rank_info`	object	页面/域名 Rank 数据

`table[]`

字段名	类型	说明
`table_header`	array	列名
`table_content`	array	表格，每个代表一行

排名变化与外链/权重字段

`rank_changes`

字段名	类型	说明
`previous_rank_absolute`	integer/null	上次绝对排名；若为新结果则为 `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	外链数据更新时间

`rank_info`

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

认证示例

Authorization 统一使用 Bearer Token：

bash

Authorization: Bearer smt_live_YOUR_KEY

请求示例

cURL

bash

curl --location --request POST "https://api.seermartech.cn/v3/dataforseo_labs/bing/ranked_keywords/live" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "target": "bing.com",
 "location_name": "United States",
 "language_name": "English",
 "filters": [
 ["keyword_data.keyword_info.search_volume", ">", 10],
 "and",
 [
 ["ranked_serp_element.serp_item.type", "<>", "paid"],
 "or",
 ["ranked_serp_element.serp_item.is_paid", "=", false]
 ]
 ],
 "load_rank_absolute": true,
 "limit": 3
 }
]'

Python

python

import requests

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

payload = [
 {
 "target": "bing.com",
 "location_name": "United States",
 "language_name": "English",
 "filters": [
 ["keyword_data.keyword_info.search_volume", ">", 10],
 "and",
 [
 ["ranked_serp_element.serp_item.type", "<>", "paid"],
 "or",
 ["ranked_serp_element.serp_item.is_paid", "=", False]
 ]
 ],
 "load_rank_absolute": True,
 "limit": 3
 }
]

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

TypeScript

typescript

import axios from "axios";

const payload = [
 {
 target: "bing.com",
 location_name: "United States",
 language_name: "English",
 filters: [
 ["keyword_data.keyword_info.search_volume", ">", 10],
 "and",
 [
 ["ranked_serp_element.serp_item.type", "<>", "paid"],
 "or",
 ["ranked_serp_element.serp_item.is_paid", "=", false]
 ]
 ],
 load_rank_absolute: true,
 limit: 3
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/dataforseo_labs/bing/ranked_keywords/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);
 });

响应示例

json

{
 "version": "0.1.20240313",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.7323 sec.",
 "cost": 0.0103,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "dataforseo_labs",
 "function": "ranked_keywords",
 "se_type": "bing",
 "target": "bing.com",
 "language_name": "English",
 "location_name": "United States",
 "load_rank_absolute": true,
 "limit": 3
 },
 "result": [
 {
 "items": [
 {
 "se_type": "bing",
 "keyword_data": {
 "se_type": "bing",
 "keyword": "0 0 0 color",
 "location_code": 2840,
 "language_code": "en",
 "keyword_properties": {
 "se_type": "bing",
 "core_keyword": "color 0 0 0",
 "synonym_clustering_algorithm": "text_processing",
 "keyword_difficulty": 62,
 "detected_language": "en",
 "is_another_language": false
 },
 "serp_info": {
 "se_type": "bing",
 "check_url": "https://www.bing.com/search?q=0%200%200%20color&count=50&first=1&setmkt=en-US&setlang=en-us&safesearch=Moderate&form=QBLH",
 "se_results_count": 370000000,
 "last_updated_time": "2024-03-06 14:00:40 +00:00",
 "previous_updated_time": "2024-02-02 11:05:50 +00:00"
 },
 "avg_backlinks_info": null
 },
 "ranked_serp_element": {
 "se_type": "bing",
 "serp_item": {
 "se_type": "bing",
 "type": "featured_snippet",
 "rank_group": 1,
 "rank_absolute": 1,
 "position": "left",
 "xpath": "/html/body/div/main/ol/li",
 "domain": "www.bing.com",
 "title": "#000000 Hex Color - RGB: 0, 0, 0 - Color Code",
 "featured_title": null,
 "description": "In a RGB color space...",
 "url": "https://www.bing.com/search?q=how+to+make+a+black+color",
 "table": null,
 "main_domain": "bing.com",
 "relative_url": "/search?q=how+to+make+a+black+color",
 "etv": 6.079999923706055,
 "estimated_paid_traffic_cost": null,
 "rank_changes": {
 "previous_rank_absolute": null,
 "is_new": false,
 "is_up": false,
 "is_down": false
 },
 "backlinks_info": null,
 "rank_info": {
 "page_rank": 0,
 "main_domain_rank": 788
 }
 },
 "check_url": "https://www.bing.com/search?q=0%200%200%20color&count=50&first=1&setmkt=en-US&setlang=en-us&safesearch=Moderate&form=QBLH",
 "se_results_count": 370000000,
 "keyword_difficulty": 62,
 "is_lost": false,
 "last_updated_time": "2024-03-06 14:00:40 +00:00",
 "previous_updated_time": "2024-02-02 11:05:50 +00:00"
 }
 }
 ]
 }
 ]
 }
 ]
}

状态码与错误处理

请根据返回的 status_code 和 status_message 进行统一错误处理。建议重点处理以下：

请求参数缺失或格式错误
认证失败
任务级别执行失败 -出频率限制
账户余额不足或计费异常

完整错误码列表请参考 /v3/appendix/errors。

结果解读建议

若需要看当前仍在排名的，使用 historical_serp_mode=live
若需要排查流失，使用 historical_serp_mode=lost
若要分析自然排名与广告位混合表现，可结合 item_types 与 ranked_serp_element.serp_item.type
若需要查看SERP 绝对位置分布，请开启 load_rank_absolute=true
若心某个落地页的表现，可对 ranked_serp_element.serp_item.relative_url 加过滤条件

实用场景

监控域名 Bing 覆盖：批量拉取站点在 Bing 上有排名的，评估自然流量覆盖面和 SEO 基础盘。
定位页面级排名词：按 relative_url 过滤页面的排名，用于落地页优化、扩写和链调整。
排查流失：使用 historical_serp_mode=lost 找出近期丢失排名的，及时发现算法波动或页面问题。
分析 SERP 占位类型：区分 organic、paid、featured_snippet、local_pack 的排名表现，制定更精细的搜索可见性策略。
评估机会优级：结合 search_volume、keyword_difficulty、etv、estimated_paid_traffic_cost，筛选更值得的优化目标。

Bing 排名（实时） ​

接口说明 ​

计费与调用限制 ​

请求体格式 ​

请求参数 ​

过滤示例 ​

1）筛选搜索量大于 10，且结果不是付费广告的 ​

2）获取某个页面有排名的 ​

排序示例 ​

响应结构 ​

顶层字段 ​

tasks[] 字段 ​

result[] 字段 ​

metrics / metrics_absolute 字段说明 ​

items[] 字段说明 ​

keyword_data ​

keyword_info ​

monthly_searches[] ​

keyword_properties ​

serp_info ​

avg_backlinks_info ​

ranked_serp_element 字段说明 ​

serp_item 支持的结果类型 ​

1）organic 自然结果 ​

rating ​

links[] ​

2）paid 付费结果 ​

extra ​

links[] ​

3）local_pack 本地结果 ​

4）featured_snippet 精选摘要 ​

table[] ​

Bing 排名（实时）

接口说明

计费与调用限制

请求体格式

请求参数

过滤示例

1）筛选搜索量大于 10，且结果不是付费广告的

2）获取某个页面有排名的

排序示例

响应结构

顶层字段

`tasks[]` 字段

`result[]` 字段

`metrics` / `metrics_absolute` 字段说明

`items[]` 字段说明

`keyword_data`

`keyword_info`

`monthly_searches[]`

`keyword_properties`

`serp_info`

`avg_backlinks_info`

`ranked_serp_element` 字段说明

`serp_item` 支持的结果类型

1）`organic` 自然结果

`rating`

`links[]`

2）`paid` 付费结果

`extra`

`links[]`

3）`local_pack` 本地结果

4）`featured_snippet` 精选摘要

`table[]`