跳转至

智能总结搜索接口文档

公共信息

参数 描述 示例
basePath 调用search的基础路径 https://genaiapi.cloudsway.net/
endpointPath 调用search的生成的一段随机路径 LPUqHEAjfonOmohV
AccessKey 调用search的accessKey RWxxxxxxxx0Gd

按照上面示例,最终请求IntelliSearch接口的路径为

https://genaiapi.cloudsway.net/LPUqHEAjfonOmohV/bing/v7.0/search

或者

https://genaiapi.cloudsway.net/v7.0/search

IntelliSearch

请求方法

GET

请求路径

  • 带endpointPath路径

  • {basePath}/{endpointPath}/bing/v7.0/search

  • 能精确定位到唯一的endpoint

  • 不带endpointPath路径

  • {basePath}/v7.0/search

  • 会自动选择endpoint,如果有多个,会选择第一个

参数 必填 描述
Authorization 是 AccessKey
Bearer ${AccessKey}

QueryParams

参数 必填 类型 描述
q 是 String 用户的搜索查询词。该词不能为空。

暂不支持高级操作符
searchType 是 String 固定值 SIMPLE_AI_SUMMARY
count 否 Short 返回结果中包含的搜索结果数量。默认值为10，最大值为50。实际返回的数量可能少于请求的数量。
mkt 否 String 结果来源的市场。通常，mkt是用户发出请求的国家。然而，如果用户不在Bing提供结果的国家，则可能是不同的国家。市场必须采用<语言>-<国家/地区>的形式。例如，en-US。该字符串不区分大小写。
offset 否 Short 从零开始的偏移量，指示在返回结果之前要跳过的搜索结果数量。默认值为0。 
使用此参数与count参数一起分页显示结果。例如，如果您的用户界面每页显示10个搜索结果，请将count设置为10，将offset设置为0以获取第一页的结果。对于每个后续页面，将offset增加10（例如，0，10，20）。多个页面可能会包含一些重叠的结果。

返回Body

QueryContext

定义Bing用于请求的查询字符串。

名称 值 类型
originalQuery 请求中指定的查询字符串。 String

SearchResponse

搜索请求成功时响应的顶层对象。

默认情况下，搜索API包括所有相关答案，除非：

  • 查询指定responseFilter查询参数以限制其返回的答案。
  • 一个或多个搜索组件不返回结果（例如，查询没有相关的新闻结果）。
  • 订阅密钥没有访问搜索组件的权限。
  • 如果服务怀疑是拒绝服务攻击，请求成功（HTTP状态代码为200 OK），但响应体为空。
名称 值 类型
_type 类型提示，设置为SearchResponse。 String
queryContext Bing用于请求的查询字符串。 QueryContext
webPages 与搜索查询相关的网页列表。 WebAnswer

WebAnswer

定义相关网页链接的列表。

名称 值 类型
value 与查询相关的网页列表。 WebPage[]
webSearchUrl 请求网页的Bing搜索结果的URL。 String

WebPage

定义与查询相关的网页。

名称 值 类型
about 仅供内部使用。 Object[]
dateLastCrawled Bing最后一次抓取网页的时间。日期格式为YYYY-MM-DDTHH:MM:SS。例如，2015-04-13T05:23:39。 String
datePublished 网页发布的时间。日期格式为YYYY-MM-DDTHH:MM:SS。例如，2015-04-13T05:23:39。 String
datePublishedDisplayText datePublished的显示版本。 String
contractualRules 您在显示答案时必须遵守的规则列表。以下合同规则可能适用。有关显示合同规则的信息，请参见数据归属。 Object[]
deepLinks Bing在包含此网页的网站中找到的相关内容链接列表。此上下文中的Webpage对象仅包含name和url字段，以及可选的snippet字段。 WebPage[]
displayUrl 网页的显示URL。此URL仅用于显示目的，并非格式良好。 String
id 唯一标识网页结果列表中此网页的ID。仅当Ranking答案指定您将网页与其他搜索结果混合时，对象才包含此字段。每个网页包含一个ID，该ID与Ranking答案中的ID匹配。有关更多信息，请参见排名结果。 String
isFamilyFriendly 一个布尔值，指示网页是否包含成人内容。如果网页不包含成人内容，isFamilyFriendly设置为true。 Boolean
isNavigational 一个布尔值，指示用户的查询是否经常用于导航到网页域的不同部分。如果用户从该页面导航到网站的其他部分，则值为true。 Boolean
language 用于标识网页语言的两字母语言代码。例如，en表示英语。 String
malware 如果Bing认为网页可能在用户点击URL链接时引发潜在问题，您应该在网页链接旁边高可见性地显示通知。 Malware
name 网页的名称。使用此名称和url创建一个超链接，用户点击时会转到网页。 String
mentions 仅供内部使用。 Object
searchTags 网页所有者在网页上指定的搜索标签列表。API仅返回已索引的搜索标签。MetaTag对象的name字段包含已索引的搜索标签。搜索标签以search.*开头（例如，search.assetId）。content字段包含标签的值。 MetaTag[]
snippet 描述网页内容的文本片段。 String
url 网页的URL。使用此URL和name创建一个超链接，用户点击时会转到网页。 String
aiSummary 网页内容ai总结 String

请求示例

curl --request GET \
  --url 'https://genaiapi.cloudsway.net/LPUqHEAjfonOmohV/bing/v7.0/search?q=spacex&count=3&searchType=SIMPLE_AI_SUMMARY' \
  --header 'Authorization: Bearer RWxxxxxxxx0Gd'

返回值示例

{
    "_type": "SearchResponse",
    "queryContext": {
        "originalQuery": "spacex"
    },
    "webPages": {
        "webSearchUrl": "https://www.bing.com/search?q=spacex",
        "value": [
            {
                "id": "https://api.bing.microsoft.com/api/v7/#WebPages.0",
                "name": "SpaceX因侵占破坏土地被起诉：马斯克被索赔1500万美元",
                "url": "https://xueqiu.com/9919963656/305469175",
                "isFamilyFriendly": true,
                "displayUrl": "https://xueqiu.com/9919963656/305469175",
                "snippet": "马斯克还向美国共和党国会委员会以及支持特朗普的美国政治行动委员会贡献了越来越多的资金，而且他一直在为后者提供资金。2024年7月，马斯克正式公开支持特朗普，他在社交媒体平台X上采访了特朗普数小时，称他为“通往繁荣的道路”。",
                "dateLastCrawled": "2024-09-24T11:31:00.0000000Z",
                "cachedPageUrl": "http://cc.bingj.com/cache.aspx?q=%E9%A9%AC%E6%96%AF%EF%BC%9F&d=2556298162967&mkt=zh-CN&setlang=zh-CN&w=IV3emKn3TClmyKJ86-UxbBI39d4JUdVi",
                "language": "zh_chs",
                "isNavigational": false,
                "noCache": false,
                "aiSummary": "美国游戏厂商Plaintiff Cards Against Humanity（CAH）正在起诉埃隆·马斯克的私人航天公司SpaceX，并向其索赔1500万美元。CAH声称SpaceX破坏了他们购买的位于美国德克萨斯州卡梅伦县的土地，包括堆放建筑材料、使用碎石和拖拉机等。CAH从未许可SpaceX进行这些活动，SpaceX也从未与CAH联系或道歉。CAH还推出了一个名为“elonowesyou100dollars.com”的网站，鼓励人们向马斯克施压。此前，CAH曾以独特的方式参与社会活动，如在黑色星期五销售牛粪对抗饥饿问题，制作防毒面具的“逃亡”背包等。同时，马斯克持续为政治选举提供经济支持，SpaceX也在该地区创造了大量就业机会。然而，CAH的诉讼反映了SpaceX扩张过程中可能存在的负面影响，即破坏当地环境和土地。"
            },
            {
                "id": "https://api.bing.microsoft.com/api/v7/#WebPages.1",
                "name": "SpaceX三部曲第二部《Reentry(再入)》新书发布，埃里克·伯 ...",
                "url": "https://www.bilibili.com/video/BV1kBsheyEpr/",
                "isFamilyFriendly": true,
                "displayUrl": "https://www.bilibili.com/video/BV1kBsheyEpr",
                "snippet": "【访谈/中英】当马云 遇见马斯克：人工智能、火星、就业、人口与可持续性 SpaceX小工 5353 25 【访谈/中英】马斯克2011年接受WSJ《Big Interview》采访，展望特斯拉与SpaceX未来发展 ...",
                "dateLastCrawled": "2024-09-24T21:27:00.0000000Z",
                "cachedPageUrl": "http://cc.bingj.com/cache.aspx?q=%E9%A9%AC%E4%BA%91%E8%BA%AB%E9%AB%98%EF%BC%9F&d=2693867175959&mkt=zh-CN&setlang=zh-CN&w=qIKhsttrW6mTnPSG4vSI_8PqFfaSqmqh",
                "language": "zh_chs",
                "isNavigational": false,
                "noCache": false,
                "aiSummary": "SpaceX三部曲第二部《Reentry(再入)》新书发布，作者埃里克·伯格接受采访时透露了SpaceX的发展历程和重要事件。书中详细记录了SpaceX如何克服重重困难，从初期的艰难起步到如今的成功，包括猎鹰重型火箭、猎鹰9号火箭回收、星链项目、星舰计划等。埃里克·伯格还分享了SpaceX的重要时刻和关键人物的故事，展现了SpaceX从小公司成长为全球领先的航天企业的历程。"
            },
            {
                "id": "https://api.bing.microsoft.com/api/v7/#WebPages.2",
                "name": "SpaceX 从海中打捞出星舰超级重型助推器残骸 - IT之家",
                "url": "https://www.ithome.com/0/798/045.htm",
                "isFamilyFriendly": true,
                "displayUrl": "https://www.ithome.com/0/798/045.htm",
                "snippet": "SpaceX 从海中打捞出了部分星舰巨型火箭的残骸。SpaceX 创始人兼首席执行官埃隆・马斯克上周日在 X 上发布了一张照片，展示了正在从海洋中打捞出的火箭残骸。马斯克表示，这是最近一次星舰测试飞行中使用的第一级助推器的一部分。",
                "dateLastCrawled": "2024-09-24T08:35:00.0000000Z",
                "cachedPageUrl": "http://cc.bingj.com/cache.aspx?q=%E9%A9%AC%E6%96%AF%EF%BC%9F&d=1319530267211&mkt=zh-CN&setlang=zh-CN&w=-5AXyoAy5PFCxTGT2INzRSokLfwu3C5R",
                "language": "zh_chs",
                "isNavigational": false,
                "noCache": false,
                "aiSummary": "SpaceX 从海中打捞出了星舰巨型火箭的残骸，这残骸来自最近一次星舰测试飞行中使用的第一级助推器。星舰由两个不锈钢部分组成，分别是超级重型助推器和星舰航天器，两者都由猛禽发动机提供动力。星舰在进行多次测试飞行后，达到了轨道速度，飞船和助推器在穿过大气层后幸存，并落入水中。这些残骸可能用于研究或确保不落入竞争对手手中。SpaceX 计划进行第五次测试飞行，但需要等待 FAA 的批准。"
            }
        ]
    }
}

MarketCode

Country/Region Language Market code
Argentina Spanish es-AR
Australia English en-AU
Austria German de-AT
Belgium Dutch nl-BE
Belgium French fr-BE
Brazil Portuguese pt-BR
Canada English en-CA
Canada French fr-CA
Chile Spanish es-CL
Denmark Danish da-DK
Finland Finnish fi-FI
France French fr-FR
Germany German de-DE
Hong Kong SAR Traditional Chinese zh-HK
India English en-IN
Indonesia English en-ID
Italy Italian it-IT
Japan Japanese ja-JP
Korea Korean ko-KR
Malaysia English en-MY
Mexico Spanish es-MX
Netherlands Dutch nl-NL
New Zealand English en-NZ
Norway Norwegian no-NO
People's republic of China Chinese zh-CN
Poland Polish pl-PL
Republic of the Philippines English en-PH
Russia Russian ru-RU
South Africa English en-ZA
Spain Spanish es-ES
Sweden Swedish sv-SE
Switzerland French fr-CH
Switzerland German de-CH
Taiwan Traditional Chinese zh-TW
Türkiye Turkish tr-TR
United Kingdom English en-GB
United States English en-US
United States Spanish es-US