本文介绍由接口盒子(apihz.cn)提供的搜狗图片搜索免费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
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
复制
<?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调用示例
ini
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可快速集成搜狗图片搜索能力,适用于内容聚合、素材采集等场景。建议合理控制调用频率,并遵守数据版权规范。