通用图片搜索-搜狗源免费API接口使用指南

本文介绍由接口盒子(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"])

五、注意事项

  1. 密钥安全

    示例中的id=88888888key=88888888为公共测试凭证,​请勿在生产环境使用,注册独立账户获取专属ID和KEY。

  2. 频次限制

    独立账户享有更高频次,未登录用户共享低频次(约1-2次/分钟)。

  3. 图片失效
    type=2返回的源地址可能失效,建议优先使用type=1的预览图地址。

  4. 错误处理

    常见错误提示:

    • 通讯秘钥错误:KEY无效
    • ID不能为空:未提交ID参数
    • 关键词不能为空:未提交words参数

通过此API可快速集成搜狗图片搜索能力,适用于内容聚合、素材采集等场景。建议合理控制调用频率,并遵守数据版权规范。

相关推荐
猿究院-陆昱泽31 分钟前
Redis 五大核心数据结构知识点梳理
redis·后端·中间件
yuriy.wang1 小时前
Spring IOC源码篇五 核心方法obtainFreshBeanFactory.doLoadBeanDefinitions
java·后端·spring
咖啡教室3 小时前
程序员应该掌握的网络命令telnet、ping和curl
运维·后端
你的人类朋友4 小时前
Let‘s Encrypt 免费获取 SSL、TLS 证书的原理
后端
老葱头蒸鸡4 小时前
(14)ASP.NET Core2.2 中的日志记录
后端·asp.net
李昊哲小课4 小时前
Spring Boot 基础教程
java·大数据·spring boot·后端
码事漫谈4 小时前
C++内存越界的幽灵:为什么代码运行正常,free时却崩溃了?
后端
Swift社区5 小时前
Spring Boot 3.x + Security + OpenFeign:如何避免内部服务调用被重复拦截?
java·spring boot·后端
90后的晨仔5 小时前
Mac 上配置多个 Gitee 账号的完整教程
前端·后端
码事漫谈5 小时前
AI智能体平台选型指南:从技术架构到商业落地的全景洞察
后端