Bing SERP API
使用彼此独立的语言、国家、分页和设备参数查询结构化 Bing 搜索结果。
接口地址
GET https://api.goanyapi.com/api/v1/bing-serp当前配置下，每次成功请求消耗 2 积分。
鉴权方式
Authorization: Bearer YOUR_API_KEY请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
q | string | 是 | 搜索词，最多 200 个字符 |
setLang | string | 否 | 搜索语言，使用语言-国家格式，例如 en-US；为空时不传 |
cc | string | 否 | 两位搜索国家代码，例如 us；为空时不传 |
first | integer | 否 | 上一次响应中 pagination.next_page_start 返回的分页位置；首页留空 |
device | string | 否 | desktop、mobile、ios、iphone、ipad、ios_tablet、android 或 android_tablet；为空时不传 |
brd_browser | string | 否 | chrome、safari 或 firefox；留空时随机使用浏览器配置 |
只有 q 必填。选填参数为空时不会被加入搜索请求。
请求示例
不指定选填参数的第 1 页：
GET /api/v1/bing-serp?q=ai%20image
Authorization: Bearer YOUR_API_KEY上一次响应返回 next_page_start: 4 时，使用英语、美国地区和 iPhone 设备查询下一页：
GET /api/v1/bing-serp?q=ai%20image&setLang=en-US&cc=us&first=4&device=iphone&brd_browser=safari
Authorization: Bearer YOUR_API_KEY响应示例
以下 Demo 来自 2026 年 8 月 25 日线上执行的 ai image 真实结构化响应。为便于阅读，重复广告记录和具有时效性的跟踪链接已缩短。
{
"code": "ok",
"message": "ok",
"data": {
"endpoint": "bing-serp",
"remainingCredits": 998,
"query": {
"q": "ai image"
},
"result": {
"general": {
"search_engine": "bing",
"query": "ai image",
"results_cnt": 86700,
"country_code": "NL",
"location": "The Hague, South Holland",
"language": "en-GB",
"mobile": false,
"search_type": "text",
"page_title": "ai image - Search",
"timestamp": "2026-08-25T14:03:12.766Z"
},
"top_ads": [
{
"title": "Free AI Image Generator - Best AI Image Generator",
"link": "http://www.chatday.ai",
"rank": 1,
"global_rank": 1
}
],
"organic": [
{
"link": "https://deepai.org/machine-learning-model/text2img",
"display_link": "https://deepai.org › machine-learning-model",
"title": "AI Image Generator - DeepAI",
"site_name": "DeepAI",
"description": "Whether you're a creator, developer, or entrepreneur, DeepAI's Free Online AI Image Generator gives you the power to visualize …",
"rank": 1,
"global_rank": 2
}
],
"related": [
{
"text": "ai image generator",
"rank": 1,
"global_rank": 15
}
],
"pagination": {
"current_page": 1,
"next_page": 2,
"next_page_start": 11,
"pages": [
{ "page": 2, "start": 11 },
{ "page": 3, "start": 21 }
]
}
}
}
}响应字段
Bing 会根据搜索词、国家、页面、设备和当前结果页返回不同模块。除非业务已经确认某个模块稳定存在，否则应将 data.result 下的字段按可选字段处理。
| 字段 | 类型 | 说明 |
|---|---|---|
data.endpoint | string | 固定值：bing-serp |
data.costCredits | number | 本次请求扣除的积分 |
data.remainingCredits | number | 扣费后的剩余积分 |
data.query | object | API 实际使用的已校验参数 |
data.query.q | string | 搜索词 |
data.query.setLang | string | 提供时返回搜索语言 |
data.query.cc | string | 提供时返回搜索国家代码 |
data.query.first | string | 提供时返回结果页位置 |
data.query.device | string | 提供时返回设备类型 |
data.query.brd_browser | string | 提供时返回浏览器类型 |
data.result.general | object | 搜索引擎、地区和设备等搜索元数据 |
data.result.top_ads | array | 可用时返回自然结果上方的广告 |
data.result.middle_ads | array | 可用时返回结果模块之间的广告 |
data.result.bottom_ads | array | 可用时返回自然结果下方的广告 |
data.result.organic | array | 按展示顺序排列的自然搜索结果 |
data.result.related | array | 可用时返回相关搜索 |
data.result.pagination | object | 可用时返回当前页和分页导航 |
data.result.pagination.next_page_start | number | 下一次请求应作为 first 传入的值 |
自然搜索结果字段
| 字段 | 类型 | 说明 |
|---|---|---|
data.result.organic[].link | string | 结果目标地址 |
data.result.organic[].tracking_link | string | 可选的 Bing 导航地址 |
data.result.organic[].display_link | string | 搜索结果中展示的地址 |
data.result.organic[].title | string | 结果标题 |
data.result.organic[].site_name | string | 可用时返回站点名称 |
data.result.organic[].description | string | 结果摘要 |
data.result.organic[].rank | number | 在自然搜索模块中的位置 |
data.result.organic[].global_rank | number | 在所有返回结果模块中的位置 |
设备参数
setLang 和 cc 是两个彼此独立的参数。例如，setLang=en-US&cc=us 会保持原值同时传入搜索请求，API 不会根据其中一个参数推导另一个参数。
device留空时不会附加设备偏好。desktop使用桌面设备，mobile使用通用移动设备。ios和iphone使用 iPhone 设备。ipad和ios_tablet使用 iPad 设备。android使用 Android 手机。android_tablet使用 Android 平板。brd_browser留空时随机使用浏览器配置。brd_browser支持chrome、safari和firefox，并且可以与device组合使用。
响应模块与计费
响应会返回所有可用的 Bing 广告模块，包括顶部、中部、底部、购物、付费及赞助结果分组。源 HTML、酒店模块、AI 概览模块和知识面板仍会移除。其他未知结构化模块会继续保留，便于客户端兼容 Bing 新增的结果类型。
只有成功返回有效结构化 JSON 后才扣除积分。鉴权失败、参数错误、查询失败或无效响应均不扣积分。