文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>联网搜索API>API 文档>搜索相关接口>联网搜索API

联网搜索API

最近更新时间：2025-09-12 04:28:27

我的收藏

本页目录：

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，对应党政机关、权威媒体、学术（英文），仅限尊享版使用
示例值：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"}"]
Msg String 提示信息
示例值：hit black query
RequestId String 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 联网搜索API示例

三星堆的由来，搜索结果示例

输入示例

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.897802,\"date\":\"2024-06-07 19:00:51\",\"title\":\"三星堆名字的由来,你真的了解吗?三星堆的参观攻略,建议收藏青铜文物玉器古蜀国三星堆遗址_网易订阅\",\"url\":\"https://www.163.com/dy/article/J43Q2STU0553FV3Z.html\",\"site\":\"网易\",\"images\":[],\"favicon\":\"http://img01.sogoucdn.com/app/a/200913/a51423369a5d5a.png\"}",
            "{\"passage\":\"一､地理环境因素三星堆遗址位于四川省广汉市,距离成都约40公里｡在四川省广汉市西北部,有三座稍稍隆起的土堆呈直线排列,这种地形布局与夜空中闪烁的三颗星辰相呼应,因此得名“三星堆”｡这三个土堆历史悠久,据考古学家研究,它们的存在可以追溯到3000多年前｡这三个土堆不仅形态独特,而且在古代具有一定的宗教或象征意义｡在三星堆遗址的东北方,有一段残破的城墙,这段城墙呈现出弯月形状,与三个土堆隔河相望｡这种自然与人工相结合的景观,在当时的社会背景下,很可能被赋予了一定的神话色彩和宗教意义｡这一景观组合在历史上更是被形象地称为“三星伴月”,进一步增添了三星堆名字的文化韵味｡其中的“三星”指的就是那三个土堆,而“月”则是指那段弯月般的城墙｡当地居民根据这一独特的地理特征,赋予了这片土地以“三星伴月”的美称｡这种说法不仅反映了古人对于自然现象的崇拜和敬畏之情,同时也体现了人们对于美好事物的向往和赞美之心｡随着时间的推移,这一称谓逐渐深入人心,并最终演变成了“三星堆”这一名称｡\",\"score\":0.8887853,\"date\":\"2024-09-03 12:59:00\",\"title\":\"三星堆名字的由来_腾讯新闻\",\"url\":\"https://news.qq.com/rain/a/20240903A048N700\",\"site\":\"腾讯网\",\"images\":[],\"favicon\":\"http://img02.sogoucdn.com/app/a/200913/ab735a258a90e8.png\"}",
            "{\"passage\":\"最早在1929年,一位当地农民在遗址区域内偶然发现了一个玉器坑,这一发现引起了考古界的关注｡在四川省广汉市西北部,有<strong>三座稍稍隆起的土堆呈直线排列</strong>,这种地形布局与夜空中闪烁的<strong>三颗星辰</strong>相呼应,因此得名<strong>“三星堆”</strong>｡\",\"score\":0.86471426,\"date\":\"2024-09-03 13:06:46\",\"title\":\"三星堆名字的由来\",\"url\":\"https://so.html5.qq.com/page/real/search_news?docid=70000021_14266d6996591252\",\"site\":\"企鹅号\",\"images\":[],\"favicon\":\"http://img02.sogoucdn.com/app/a/200913/ab735a25.png\"}"
        ],
        "Query": "三星堆的由来",
        "RequestId": "6f8df221-9a68-4ea2-90d6-a9590cae244c"
    }
}

5. 开发者资源

腾讯云 API 平台

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

API Inspector

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

SDK

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

命令行工具

6. 错误码

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

错误码 描述
InternalError 内部错误。
InvalidParameter 参数错误。
RequestLimitExceeded 请求的次数超过了频率限制。
UnauthorizedOperation 未授权操作。
中国站
目录