本文介绍由接口盒子提供的搜狗图片搜索免费API，支持通过关键词获取图片搜索结果，适用于图片采集、内容分析等场景。
一、接口基本信息
- 请求地址
https://cn.apihz.cn/api/img/apihzimgsougou.php - 请求方式
GET 或 POST - 每日调用限制
无上限（建议使用独立ID和KEY独享频次） - 版权声明
数据来源于搜狗搜索，请遵守参考资料中的版权要求
二、请求参数说明
| 参数名 | 必填 | 示例值 | 说明 |
| id | 是 | 10000000 | 用户中心注册的数字ID |
| key | 是 | 15he5h15... | 用户中心获取的通讯秘钥 |
| words | 否 | 张含韵 | 搜索关键词（默认返回综合结果） |
| page | 否 | 1 | 页码（默认第1页） |
| type | 否 | 1 | 返回类型：1=预览图（推荐），2=源地址（可能失效） |
三、返回参数说明
json
复制
{ "code": 200, // 状态码（200成功，400失败） "msg": "", // 错误提示（code=400时出现） "res": ["url1", "url2"], // 图片地址数组 "page": "1" // 当前页码 }
四、调用示例
1. GET请求示例
直接在浏览器访问：
https://cn.apihz.cn/api/img/apihzimgsougou.php?id=10000000&key=您的KEY&words=张含韵&page=1
2. PHP调用示例
php
复制
<?php $id = "10000000"; // 替换为您的ID $key = "您的通讯秘钥"; $keyword = "卡通猫"; $api_url = "https://cn.apihz.cn/api/img/apihzimgsougou.php"; // 构造请求参数 $params = [ 'id' => $id, 'key' => $key, 'words' => $keyword, 'page' => 1, 'type' => 1 ]; // 发送GET请求 $url = $api_url . '?' . http_build_query($params); $response = file_get_contents($url); $result = json_decode($response, true); // 处理结果 if ($result['code'] == 200) { foreach ($result['res'] as $img_url) { echo ""; } } else { echo "错误: " . $result['msg']; } ?>
3. Python调用示例
python
运行
复制
import requests id = "10000000" # 替换为您的ID key = "您的通讯秘钥" keyword = "风景" params = { "id": id, "key": key, "words": keyword, "page": 1, "type": 1 } response = requests.get( url="https://cn.apihz.cn/api/img/apihzimgsougou.php", params=params ) data = response.json() if data["code"] == 200: for index, url in enumerate(data["res"]): print(f"图片{index+1}: {url}") else: print("错误:", data["msg"])
五、注意事项
- 密钥安全
示例中的id=88888888和key=88888888为公共测试凭证，请勿在生产环境使用，注册独立账户获取专属ID和KEY。 - 频次限制
独立账户享有更高频次，未登录用户共享低频次（约1-2次/分钟）。 - 图片失效
type=2返回的源地址可能失效，建议优先使用type=1的预览图地址。 - 错误处理常见错误提示：
通讯秘钥错误：KEY无效ID不能为空：未提交ID参数关键词不能为空：未提交words参数
通过此API可快速集成搜狗图片搜索能力，适用于内容聚合、素材采集等场景。建议合理控制调用频率，并遵守数据版权规范。
