1. 接口描述
接口请求域名: wsa.tencentcloudapi.com 。
联网搜索API,以JSON形式向客户提供搜索结果数据,包含标题、摘要、内容来源url等信息
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数,本接口取值:SearchPro。 |
| Version | 是 | String | 公共参数,本接口取值:2025-05-08。 |
| Region | 否 | String | 公共参数,本接口不需要传递此参数。 |
| Query | 是 | String | 搜索词 示例值:今天北京的天气 |
| Mode | 否 | Integer | 返回结果类型,0-自然检索结果(默认),1-多模态VR结果,2-混合结果(多模态VR结果+自然检索结果) 示例值:2 |
| Site | 否 | String | 指定域名站内搜索(用于过滤自然检索结果) 示例值:zhihu.com |
| FromTime | 否 | Integer | 起始时间(用于过滤自然检索结果),精确到秒时间戳格式 示例值:1745498501 |
| ToTime | 否 | Integer | 结束时间(用于过滤自然检索结果),精确到秒时间戳格式 示例值:1745498501 |
| Cnt | 否 | Integer | cnt=10/20/30/40/50,最多可支持返回50条搜索结果,仅限尊享版使用 示例值:10 |
| Industry | 否 | String | Industry=gov/news/acad/finance,对应党政机关、权威媒体、学术(英文)、金融,仅限尊享版使用 示例值:news |
| Freshness | 否 | String | 搜索实效范围(仅旗舰版参数)
示例说明:
枚举值:
示例值:d3 |
| Deeplinks | 否 | Boolean | 返回子链信息(仅旗舰版参数) 子链信息包括"子链标题"和"子链URL",单个doc最多返回10条子链信息。
示例值:true |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| Query | String | 原始查询语 示例值:今天北京的天气 |
| Pages | Array of String | 搜索结果页面详情,格式为json字符串。
示例值:["{"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": [
"{\"title\":\"【新思想引领新征程】人工智能创新加速我国产业转型升级_中央网络安全和信息化委员会办公室\",\"url\":\"https://www.cac.gov.cn/2025-02/26/c_1742272852299173.htm\",\"date\":\"2025/02/26 09:37:00\",\"passage\":\"【新思想引领新征程】人工智能创新加速我国产业转型升级_中央网络安全和信息化委员会办公室\",\"content\":\"【新思想引领新征程】人工智能创新加速我国产业转型升级_中央网络安全和信息化委员会办公室...\",\"site\":\"中国网信网\",\"favicon\":\"https://cdn-yb.icon.qq.com/zuowei_dir/www_cac_gov_cn.ico\",\"score\":0.84889734,\"pics\":[{\"caption\":\"CCTV报道人工智能创新加速我国产业转型升级\",\"origin_url\":\"https://www.cac.gov.cn/rootimages/2025/02/26/1742272852299173-1742272852345396.jpg\"},{\"caption\":\"CCTV13报道工厂内正在搬运黑色料箱的机械臂\",\"origin_url\":\"https://www.cac.gov.cn/rootimages/2025/02/26/1742272852299173-1742272852346371.jpg\"},{\"caption\":\"AI创新文章配图服务器机房\",\"origin_url\":\"https://www.cac.gov.cn/rootimages/2025/02/26/1742272852299173-1742272852347738.jpg\"},{\"caption\":\"CCTV13报道长春市人工智能产业展示\",\"origin_url\":\"https://www.cac.gov.cn/rootimages/2025/02/26/1742272852299173-1742272852348427.jpg\"},{\"caption\":\"央视报道人工智能创新加速产业转型升级\",\"origin_url\":\"https://www.cac.gov.cn/rootimages/2025/02/26/1742272852299173-1742272852350041.jpg\"},{\"caption\":\"CCTV13报道之江实验室建筑及园区\",\"origin_url\":\"https://www.cac.gov.cn/rootimages/2025/02/26/1742272852299173-1742272852350602.jpg\"}]}"
],
"Query": "人工智能发展现状",
"Version": "flagship",
"RequestId": "39684d0c-0504-4892-b7b4-0d8f05203007"
}
}
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
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| InternalError | 内部错误。 |
| InvalidParameter | 参数错误。 |
| RequestLimitExceeded | 请求的次数超过了频率限制。 |
| ResourceNotFound | 用户资源未开通。 |
| ResourceUnavailable | 用户资源不可用。 |
| UnauthorizedOperation | 未授权操作。 |