联网图像搜索文搜图

1. 接口描述

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

文搜图接口，本服务将针对您输入的搜索关键词，检索并以JSON形式返回相关图片的标题、宽高、缩略图、内容来源url等信息。

默认接口请求频率限制：20次/秒。

推荐使用 API Explorer

点击调试

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

2. 输入参数

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

参数名称	必选	类型	描述
Action	是	String	公共参数，本接口取值：SearchByText。
Version	是	String	公共参数，本接口取值：2025-11-06。
Region	否	String	公共参数，本接口不需要传递此参数。
Query	是	String	查询词示例值：北京故宫

3. 输出参数

参数名称	类型	描述
Query	String	原始查询词示例值：car
Images	Array of String	搜索结果图片列表，格式为json字符串。 - thumbnailUrl：缩略图地址。 - thumbnailWidth：缩略图宽度。 - thumbnailHeight：缩略图高度。 - origPicUrl：原图地址。 - origPicWidth：原图宽度。 - siteUrl：站点地址，原图来源网页URL。 - siteName：站点名称。 - title：标题，原图标题或原图来源网页标题。 - date：内容发布时间。示例值：["{"siteName":"搜狗百科","title":"the car book"}"]
RequestId	String	唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 文搜图示例

北京故宫，搜索结果示例

输入示例

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

{
    "Query": "北京故宫"
}

输出示例

{
    "Response": {
        "Images": [
            "{\"thumbnailUrl\":\"http://img04.sogoucdn.com/v2/thumb/resize/w/400/h/400/t/1/s/1/zi/off?appid=200620&url=https%3A%2F%2Flizhicdn.search.qq.com%2Fcdn%2Fybimages%2F9000%2F9000_abe1eea3ca79fc28-c577ebdcb0f3dbcc-532d887ca78e0859e9e45e5f49dc2601_3%2F0cd6527effd30363de912761795a4e82.jpg%3FimageMogr2%2Fformat%2Fjpg&sign=b9e36c242dee996b14aa8aa58efb46fd\",\"thumbnailWidth\":400,\"thumbnailHeight\":300,\"origPicUrl\":\"http://5b0988e595225.cdn.sohucs.com/images/20180929/80afc1d760f04cac845b562a3f83ff75.jpeg\",\"origPicWidth\":640,\"origPicHeight\":480,\"siteUrl\":\"https://www.sohu.com/a/257016237_279363\",\"siteName\":\"搜狐网\",\"title\":\"中国古城墙大全（下）_ 夔州\",\"date\":\"2018-09-29T21:30:00+08:00\"}",
            "{\"thumbnailUrl\":\"http://img01.sogoucdn.com/v2/thumb/resize/w/400/h/400/t/1/s/1/zi/off?appid=200620&url=https%3A%2F%2Flizhicdn.search.qq.com%2Fcdn%2Fybimages%2F9000%2F9000_d1091a17d1dc1269-cb91acea1ee42988-01bf49988f2dc73adbea83db0f10f883_43%2F2285c72bd6985afa940495885075333d.jpg%3FimageMogr2%2Fformat%2Fjpg&sign=7e4689b4d2ae62a94fe6f71572fdf0ae\",\"thumbnailWidth\":267,\"thumbnailHeight\":400,\"origPicUrl\":\"https://b1-q.mafengwo.net/s12/M00/13/6D/wKgED1voBdyAFs9OAAh9lfo_-6o73.jpeg?imageView2%2F2%2Fw%2F680%2Fq%2F90\",\"origPicWidth\":680,\"origPicHeight\":1020,\"siteUrl\":\"https://www.mafengwo.cn/gonglve/ziyouxing/202969.html?cid=1010616\",\"siteName\":\"马蜂窝\",\"title\":\"北京故宫游玩线路推荐 - 马蜂窝\",\"date\":\"2018-11-26T00:00:00+08:00\"}",
            "{\"thumbnailUrl\":\"http://img02.sogoucdn.com/v2/thumb/resize/w/400/h/400/t/1/s/1/zi/off?appid=200620&url=https%3A%2F%2Flizhicdn.search.qq.com%2Fcdn%2Fybimages%2F9000%2F9000_abe1eea3ca79fc28-c577ebdcb0f3dbcc-00dfead9c584ec5a4a289854b116af15_38%2F31fb6399cb3a00feb2844afa4ee1aee2.jpg%3FimageMogr2%2Fformat%2Fjpg&sign=ad6649ccf67d04315e91da8cb7950343\",\"thumbnailWidth\":400,\"thumbnailHeight\":251,\"origPicUrl\":\"http://5b0988e595225.cdn.sohucs.com/images/20190519/c150147916c646c08568983950096ce0.jpeg\",\"origPicWidth\":600,\"origPicHeight\":377,\"siteUrl\":\"https://www.sohu.com/a/314918532_156369\",\"siteName\":\"搜狐网\",\"title\":\"@你，请为台州国宝点个赞！_临海市\",\"date\":\"2019-05-18T23:57:00+08:00\"}",
            "{\"thumbnailUrl\":\"http://img04.sogoucdn.com/v2/thumb/resize/w/400/h/400/t/1/s/1/zi/off?appid=200620&url=https%3A%2F%2Flizhicdn.search.qq.com%2Fcdn%2Fybimages%2F9001%2F9001_68e96645-834f-44ab-ad32-c045f0f2daa5_0%2Fef83ce8b38938b2100079f2482faa48a.jpeg%3FimageMogr2%2Fformat%2Fjpg&sign=065ef2981acdfec9531353321ebf949d\",\"thumbnailWidth\":400,\"thumbnailHeight\":250,\"origPicUrl\":\"https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2020%2F0211%2Fe3c9ce78j00q5ipjk0019c000hs00b4m.jpg&thumbnail=660x2147483647&quality=80&type=jpg\",\"origPicWidth\":640,\"origPicHeight\":400,\"siteUrl\":\"https://www.163.com/dy/article/F53OU4EG052187AM.html\",\"siteName\":\"www.163.com\",\"title\":\"古代，不光外国人可运输巨石，中国人照样可以，而且石头更大更重_网易订阅\",\"date\":\"2025-08-18T17:09:49+08:00\"}",
            "{\"thumbnailUrl\":\"http://img03.sogoucdn.com/v2/thumb/resize/w/400/h/400/t/1/s/1/zi/off?appid=200620&url=https%3A%2F%2Flizhicdn.search.qq.com%2Fcdn%2Fybimages%2F70000021%2F70000021_795664817c656752_1%2Ffb1682623e5d3638cb567dbf2a97a476.jpg%3FimageMogr2%2Fformat%2Fjpg&sign=22cfb3e33ef3979804982ecbdadcd59f\",\"thumbnailWidth\":400,\"thumbnailHeight\":262,\"origPicUrl\":\"http://qqpublic.qpic.cn/qq_public/0/28-3639940324-71239C319E60B0B856934DBD5F8CFABB/0?fmt=jpg&size=96&h=500&w=763&ppv=1\",\"origPicWidth\":763,\"origPicHeight\":500,\"siteUrl\":\"https://so.html5.qq.com/page/real/search_news?docid=70000021_795664817c656752\",\"siteName\":\"企鹅号\",\"title\":\"中国最著名的六大世界之最\",\"date\":\"2025-07-24T21:45:40+08:00\"}",
            "{\"thumbnailUrl\":\"http://img04.sogoucdn.com/v2/thumb/resize/w/400/h/400/t/1/s/1/zi/off?appid=200620&url=https%3A%2F%2Flizhicdn.search.qq.com%2Fcdn%2Fybimages%2F70000021%2F70000021_7766745e57547352_3%2F753e8c7e134d1f12d677b4e1aedcaff9.jpg%3FimageMogr2%2Fformat%2Fjpg&sign=d1e92374d7d5be0d8d09a28a7c01e085\",\"thumbnailWidth\":400,\"thumbnailHeight\":264,\"origPicUrl\":\"http://qqpublic.qpic.cn/qq_public/0/28-2922166780-E0291FE35FF41B83C98975239CCC1C14/0?fmt=jpg&size=53&h=423&w=640&ppv=1\",\"origPicWidth\":640,\"origPicHeight\":423,\"siteUrl\":\"https://so.html5.qq.com/page/real/search_news?docid=70000021_7766745e57547352\",\"siteName\":\"企鹅号\",\"title\":\"北京故宫明明占地72万平方米，却几乎看不到草木，难道怕藏刺客？\",\"date\":\"2025-07-24T21:41:32+08:00\"}",
            "{\"thumbnailUrl\":\"http://img02.sogoucdn.com/v2/thumb/resize/w/400/h/400/t/1/s/1/zi/off?appid=200620&url=https%3A%2F%2Flizhicdn.search.qq.com%2Fcdn%2Fybimages%2F9000%2F9000_75533887a6dc10dc-a8d84b93f49e7502-04cf7e674c3cd90b740967e8b01f27f4_2%2F881acfce0b216f1a52a6bab20ab1b4b7.jpg%3FimageMogr2%2Fformat%2Fjpg&sign=667a96cad2751b51950d1acfc70a51f2\",\"thumbnailWidth\":400,\"thumbnailHeight\":250,\"origPicUrl\":\"https://image.maigoo.com/upload/images/20180922/16521791637_500x312.jpg?t=1545629405\",\"origPicWidth\":500,\"origPicHeight\":312,\"siteUrl\":\"https://www.maigoo.com/goomai/211750.html\",\"siteName\":\"买购网\",\"title\":\"北京三日游最佳路线 北京3日游攻略 三天时间北京怎么玩→MAIGOO知识\",\"date\":\"2014-05-29T04:06:48+08:00\"}",
            "{\"thumbnailUrl\":\"https://imgcdn.qq.com/558bb9bed44e08fc\",\"thumbnailWidth\":500,\"thumbnailHeight\":332,\"origPicUrl\":\"http://5b0988e595225.cdn.sohucs.com/images/20190214/212c98813d2e479691a03e883aed0566.jpeg\",\"origPicWidth\":550,\"origPicHeight\":366,\"siteUrl\":\"http://www.sohu.com/a/294644430_123753\",\"siteName\":\"搜狐网\",\"title\":\"台媒 两岸故宫参观人数此消彼长 台北故宫节节下滑\",\"date\":\"2019-02-14T11:42:00+08:00\"}",
            "{\"thumbnailUrl\":\"http://img03.sogoucdn.com/v2/thumb/resize/w/400/h/400/t/1/s/1/zi/off?appid=200620&url=https%3A%2F%2Flizhicdn.search.qq.com%2Fcdn%2Fybimages%2F70000021%2F70000021_98764818b6615552_0%2F388f424407e0b4a84319ac75f6a1596a.jpg%3FimageMogr2%2Fformat%2Fjpg&sign=f867e3cadcc574ec82a06aa405842c38\",\"thumbnailWidth\":400,\"thumbnailHeight\":261,\"origPicUrl\":\"http://qqpublic.qpic.cn/qq_public/0/28-475144491-33BC8AA849030421F6BEF9A8AA836468/0?fmt=jpg&size=29&h=361&w=553&ppv=1\",\"origPicWidth\":553,\"origPicHeight\":361,\"siteUrl\":\"https://so.html5.qq.com/page/real/search_news?docid=70000021_98764818b6615552\",\"siteName\":\"企鹅号\",\"title\":\"北京人的酒桌上，除了“北京烤鸭”，这3道小菜是常客，值得一看\",\"date\":\"2025-07-24T21:54:09+08:00\"}",
            "{\"thumbnailUrl\":\"https://imgcdn.qq.com/9a00701b0c6290f8\",\"thumbnailWidth\":500,\"thumbnailHeight\":375,\"origPicUrl\":\"https://p4.itc.cn/q_70/images01/20210511/49e7fb6feb2440fc8b1734f4883f6c2f.png\",\"origPicWidth\":680,\"origPicHeight\":510,\"siteUrl\":\"http://www.sohu.com/a/465764714_121001113\",\"siteName\":\"搜狐网\",\"title\":\"换房旅游之北京逛故宫最全技能get 故宫,你真的熟吗\",\"date\":\"2021-05-11T14:27:00+08:00\"}",
            "{\"thumbnailUrl\":\"https://imgcdn.qq.com/f858c8a39b93f53e\",\"thumbnailWidth\":500,\"thumbnailHeight\":333,\"origPicUrl\":\"http://5b0988e595225.cdn.sohucs.com/images/20181123/029ff201494e4cb68c1d5f232fbbc3e0.jpeg\",\"origPicWidth\":2048,\"origPicHeight\":1365,\"siteUrl\":\"https://www.sohu.com/a/277331972_100048008\",\"siteName\":\"搜狐网\",\"title\":\"苏式琉璃折服印度第二大英文报纸\",\"date\":\"2018-11-23T14:06:00+08:00\"}",
            "{\"thumbnailUrl\":\"https://imgcdn.qq.com/716259d6d37d7c17\",\"thumbnailWidth\":499,\"thumbnailHeight\":336,\"origPicUrl\":\"http://5b0988e595225.cdn.sohucs.com/images/20180928/121c0da8b7d94131b8139fe57a0d11bd.jpeg\",\"origPicWidth\":932,\"origPicHeight\":628,\"siteUrl\":\"https://www.sohu.com/a/256600415_99931233\",\"siteName\":\"搜狐网\",\"title\":\"旅行的意义 北京故宫\",\"date\":\"2018-09-27T22:08:00+08:00\"}",
            "{\"thumbnailUrl\":\"https://imgcdn.qq.com/34e91f1e3f864c22\",\"thumbnailWidth\":500,\"thumbnailHeight\":333,\"origPicUrl\":\"http://5b0988e595225.cdn.sohucs.com/images/20181231/bd9c10b5d66c437891c7f3e9e7146dee.jpeg\",\"origPicWidth\":640,\"origPicHeight\":427,\"siteUrl\":\"http://www.sohu.com/a/285852012_100020495\",\"siteName\":\"搜狐网\",\"title\":\"特惠京津 北京天津纯玩六日游\",\"date\":\"2018-12-31T18:25:00+08:00\"}",
            "{\"thumbnailUrl\":\"https://imgcdn.qq.com/fb1e0fa2c26f226f\",\"thumbnailWidth\":500,\"thumbnailHeight\":335,\"origPicUrl\":\"http://5b0988e595225.cdn.sohucs.com/images/20170930/cf4879b81211493bbeb49f1ac0e36afb.jpeg\",\"origPicWidth\":600,\"origPicHeight\":402,\"siteUrl\":\"http://www.sohu.com/a/195668579_428290\",\"siteName\":\"搜狐网\",\"title\":\"国庆景区人气榜出炉,你准备好了吗\",\"date\":\"2017-09-30T16:24:00+08:00\"}",
            "{\"thumbnailUrl\":\"https://imgcdn.qq.com/6e9b409fc6e78f46\",\"thumbnailWidth\":520,\"thumbnailHeight\":249,\"origPicUrl\":\"https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2FrYCNwnwMwYwdaI8WdslAjTxMbU9BMq41TPsvdDWkDiHWF1553666108886.jpeg&thumbnail=650x2147483647&quality=80&type=jpg\",\"origPicWidth\":650,\"origPicHeight\":312,\"siteUrl\":\"http://dy.163.com/v2/article/detail/EB9FRHUL05441HXU.html\",\"siteName\":\"网易订阅\",\"title\":\"北京故宫建造巨石搬运过程, 今终解谜团\",\"date\":\"2020-09-24T23:54:43+08:00\"}",
            "{\"thumbnailUrl\":\"https://imgcdn.qq.com/184955f9054c8ea2\",\"thumbnailWidth\":500,\"thumbnailHeight\":352,\"origPicUrl\":\"https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2024%2F0214%2F069a5fdcj00s8tsr7001rd000no00gnm.jpg&thumbnail=660x2147483647&quality=80&type=jpg\",\"origPicWidth\":660,\"origPicHeight\":465,\"siteUrl\":\"https://www.163.com/dy/article/IQTDRSAN05566X6U.html?f=post2020_dy_recommends\",\"siteName\":\"网易\",\"title\":\"沈阳故宫和北京故宫最直观的区别是什么\",\"date\":\"2024-02-14T11:10:30+08:00\"}",
            "{\"thumbnailUrl\":\"https://imgcdn.qq.com/a71ddf4ff302c260\",\"thumbnailWidth\":500,\"thumbnailHeight\":374,\"origPicUrl\":\"http://img.hvacr.cn/bao/2021-02/2021-02-26_10_22_57PP161p.png\",\"origPicWidth\":648,\"origPicHeight\":485,\"siteUrl\":\"https://bao.hvacr.cn/202102_2090863.html\",\"siteName\":\"制冷快报\",\"title\":\"北京制冷生产市场 创新永不停止\",\"date\":\"2021-02-26T00:00:00+08:00\"}",
            "{\"thumbnailUrl\":\"https://imgcdn.qq.com/c459d7351a3bbc7e\",\"thumbnailWidth\":416,\"thumbnailHeight\":250,\"origPicUrl\":\"http://5b0988e595225.cdn.sohucs.com/images/20190910/53c33be223954afe82619d4d358c0217.jpeg\",\"origPicWidth\":641,\"origPicHeight\":384,\"siteUrl\":\"http://www.sohu.com/a/339984767_100056250\",\"siteName\":\"搜狐网\",\"title\":\"世界上 最著名 四大宫殿,北京故宫 布达拉宫上榜,你去过哪座\",\"date\":\"2019-09-10T03:41:30+08:00\"}",
            "{\"thumbnailUrl\":\"https://imgcdn.qq.com/5be59382732c85b1\",\"thumbnailWidth\":500,\"thumbnailHeight\":321,\"origPicUrl\":\"http://p5.itc.cn/images01/20200626/34ef0d9c09da46b0b65be932412c6c4d.jpeg\",\"origPicWidth\":1200,\"origPicHeight\":772,\"siteUrl\":\"https://www.sohu.com/a/404246409_100277431\",\"siteName\":\"搜狐网\",\"title\":\"故宫为何一到5点就关门 61年前的一件事,很少有人知道情况\",\"date\":\"2020-06-26T18:49:00+08:00\"}",
            "{\"thumbnailUrl\":\"https://imgcdn.qq.com/d37cb8b6101ee99f\",\"thumbnailWidth\":500,\"thumbnailHeight\":332,\"origPicUrl\":\"http://5b0988e595225.cdn.sohucs.com/images/20200313/e9b5c74edf34420f95a716231dfdac21.jpeg\",\"origPicWidth\":1000,\"origPicHeight\":664,\"siteUrl\":\"http://www.sohu.com/a/379852402_100203225\",\"siteName\":\"搜狐网\",\"title\":\"睿童之声 北京故宫 下篇\",\"date\":\"2020-03-13T17:42:00+08:00\"}"
        ],
        "Query": "北京故宫",
        "RequestId": "45384494-2901-41e6-b76a-8609e9bb1dcf"
    }
}

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	请求的次数超过了频率限制。
UnauthorizedOperation	未授权操作。

文搜图

本页目录：