联网搜索API 联网搜索API

1. 接口描述

接口请求域名： wsa.tencentcloudapi.com 。

联网搜索API，以JSON形式向客户提供搜索结果数据，包含标题、摘要、内容来源url等信息

推荐使用 API Explorer

点击调试

API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	类型	描述
Action	是	String	公共参数，本接口取值：SearchPro。
Version	是	String	公共参数，本接口取值：2025-05-08。
Region	否	String	公共参数，本接口不需要传递此参数。
Query	是	String	搜索词示例值：今天北京的天气
Mode	否	Integer	返回结果类型，0-自然检索结果(默认)，1-多模态VR结果，2-混合结果（多模态VR结果+自然检索结果）示例值：2
Site	否	String	指定域名站内搜索（用于过滤自然检索结果）注意： mode=1模式下，参数无效；mode=0模式下，对所有结果生效；mode=2模式下，对输出的自然结果生效示例值：zhihu.com
FromTime	否	Integer	起始时间（用于过滤自然检索结果），精确到秒时间戳格式注意： mode=1模式下，参数无效；mode=0模式下，对所有结果生效；mode=2模式下，对输出的自然结果生效示例值：1745498501
ToTime	否	Integer	结束时间（用于过滤自然检索结果），精确到秒时间戳格式注意：mode=1模式下，参数无效；mode=0模式下，对所有结果生效；mode=2模式下，对输出的自然结果生效示例值：1745498501
Cnt	否	Integer	cnt=10/20/30/40/50，最多可支持返回50条搜索结果，仅限尊享版使用示例值：10
Industry	否	String	Industry=gov/news/acad/finance，对应党政机关、权威媒体、学术（英文）、金融，仅限尊享版使用示例值：news

3. 输出参数

参数名称	类型	描述
Query	String	原始查询语示例值：今天北京的天气
Pages	Array of String	搜索结果页面详情，格式为json字符串。 title：结果标题 date：内容发布时间 url：内容发布源url passage：标准摘要 content：动态摘要（尊享版字段） site：网站名称，部分不知名站点结果可能为空 score：相关性得分，取值0～1，越靠近1表示越相关 images：图片列表 favicon：网站图标链接，部分不知名站点结果可能为空示例值：["{"passage":"aaa"}", "{"passage":"bbb"}"]
Version	String	用户版本：standard/premium/lite/flagship 示例值：standard
Msg	String	提示信息示例值：hit black query
RequestId	String	唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 请求成功示例

输入示例

POST / HTTP/1.1
Host: wsa.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: SearchPro
<公共请求参数>

{
    "Query": "三星堆的由来"
}

输出示例

{
    "Response": {
        "Pages": [
            "{\"passage\":\"三星堆名字的由来 三星堆遗址位于四川省广汉市西北部,距离成都约40公里,地理位置独特,被三条河流环绕,形成了天然的地理屏障｡据《华阳国志》记载,古蜀国“有三江,皆发源于岷山,流至成都平原”｡ 这三条河流,即今之鸭子河､石亭江和郪江,在三星堆附近交汇,形成了一片肥沃的土地｡三星堆之名,最初来源于这一地区的地形特征——三座小山丘呈三角状分布,犹如夜空中的三星,故得名“三星堆”｡ 三星堆名称的演变 三星堆遗址的发掘,始于20世纪20年代末期,但其真正引起广泛关注是在1986年两个大型祭祀坑的发现之后｡在此之前,三星堆只是当地的一个地名,直到考古学家们在这里发现了大量的古代遗存,三星堆才逐渐成为了世界瞩目的焦点｡ 随着研究的深入,三星堆之名也从一个简单的地理标识,演变为承载着深厚历史文化的符号｡\",\"score\":0.89779466,\"date\":\"2024-06-07 19:00:51\",\"title\":\"三星堆名字的由来,你真的了解吗?三星堆的参观攻略,建议收藏青铜文物玉器古蜀国三星堆遗址_网易订阅\",\"url\":\"https://www.163.com/dy/article/J43Q2STU0553FV3Z.html\",\"site\":\"网易\",\"images\":[\"https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2024%2F0607%2F6554e9f0j00sepikb0015d000ko00f7m.jpg&thumbnail=660x2147483647&quality=80&type=jpg\",\"https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2024%2F0607%2Fd8580756j00sepikb002sd000op00dwm.jpg&thumbnail=660x2147483647&quality=80&type=jpg\",\"https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2024%2F0607%2F0cef675bj00sepikb005td000x200m1m.jpg&thumbnail=660x2147483647&quality=80&type=jpg\"],\"favicon\":\"http://img01.sogoucdn.com/app/a/200913/a51423369a5d5a02e23e02dbe7ef3ac2.png\"}"
        ],
        "Query": "三星堆的由来",
        "Version": "standard",
        "RequestId": "2ef4f9d6-51fe-4223-929f-7dc5a1466cbb"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee
Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee
Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee
Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee
Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee
Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee
Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee
Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee

命令行工具

Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
InternalError	内部错误。
InvalidParameter	参数错误。
RequestLimitExceeded	请求的次数超过了频率限制。
ResourceNotFound	用户资源未开通。
ResourceUnavailable	用户资源不可用。
UnauthorizedOperation	未授权操作。

联网搜索API

本页目录：