通用图片搜索-搜狗源免费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可快速集成搜狗图片搜索能力,适用于内容聚合、素材采集等场景。建议合理控制调用频率,并遵守数据版权规范。

相关推荐
Badman32 分钟前
分布式系统下的数据一致性-Redis分布式锁
redis·分布式·后端
Java水解36 分钟前
盘点那些自带高级算法的SQL
后端
一只叫煤球的猫1 小时前
2025年基于Java21的的秒杀系统要怎么设计?来点干货
后端·面试·性能优化
方圆想当图灵2 小时前
《生产微服务》评估清单 CheckList
后端·微服务
服务端技术栈2 小时前
历时 1 个多月,我的第一个微信小程序「图片转 Excel」终于上线了!
前端·后端·微信小程序
计算机毕业设计指导2 小时前
基于Spring Boot的幼儿园管理系统
spring boot·后端·信息可视化
年轻的麦子2 小时前
Go 框架学习之:go.uber.org/fx项目实战
后端·go
小蒜学长2 小时前
django全国小米su7的行情查询系统(代码+数据库+LW)
java·数据库·spring boot·后端
听风同学3 小时前
RAG的灵魂-向量数据库技术深度解析
后端·架构
橙序员小站4 小时前
搞定系统面试题:如何实现分布式Session管理
java·后端·面试