参数名	类型	必填	说明	示例
msg	string	是	需要搜索的关键词，如：鄙视	鄙视
page	integer	否	页数，默认为当前第1页内容	1
num	integer	否	每页数量，默认每页为40条	40
n	integer	否	无此值返回多列表，有则返回指定当前页的n条图	1

聊天图片表情搜索

接口说明

多功能表情包检索接口，支持通过关键词快速搜索并获取静态图片与GIF动图资源，适用于聊天场景中表情包查找与斗图需求，帮助用户提升互动趣味性。

调用地址

/v1/meme.php

请求方式

GET、POST

鉴权说明

无需密钥

请求参数

参数名	类型	必填	说明
msg	string	是	需要搜索的关键词，如：鄙视
page	integer	否	页数，默认为第1页内容
num	integer	否	每页数量，默认每页为40条
n	integer	否	无此值返回多列表，有则返回指定当前页的n条图

成功响应示例

{
  "code": 200,
  "page": 1,
  "num": 40,
  "data": [
    {
      "img_url": "https://biaoqing.gtimg.com/back/yuntu/o/14c78e60e4cc43f25e955fd87f97b2ea.JPG",
      "img_size": 27333,
      "img_height": 220,
      "img_width": 220
    },
    {
      "img_url": "https://biaoqing.gtimg.com/product/200678/o/a31ab4f316b60986936dede0457a0fb5.gif",
      "img_size": 5213,
      "img_height": 136,
      "img_width": 136
    }
  ],
  "tips": "慕名API：http://xiaoapi.cn"
}

响应字段说明

字段	类型	说明
code	integer	接口返回状态码，200 表示请求成功
page	integer	当前返回数据的页码
num	integer	每页返回的条目数量
data	array	图片资源列表，每项为一张表情图片的信息对象
tips	string	接口提示信息

data 数组元素说明

字段	类型	说明
img_url	string	表情图片的完整访问地址，支持 JPG、PNG、GIF 等格式
img_size	integer	图片文件大小，单位为字节（Byte）
img_height	integer	图片高度，单位为像素（px）
img_width	integer	图片宽度，单位为像素（px）

错误响应示例

业务错误响应格式

{"code":0,"msg":"未提供调用密钥","errcode":11001}

常见业务错误示例

未提供调用密钥：

{"code":0,"msg":"未提供调用密钥","errcode":11001}

请求过于频繁：

{"code":0,"msg":"请求过于频繁（QPM 限制）","errcode":11005}

服务暂不可用：

{"code":0,"msg":"服务暂不可用","errcode":11017}

业务错误码说明

errcode	说明
11001	未提供调用密钥
11002	密钥错误
11003	密钥已禁用
11004	积分余额不足
11005	请求过于频繁（QPM 限制）
11006	接口维护中
11007	接口已禁用
11008	接口不可用
11009	密钥校验暂不可用
11010	积分系统暂不可用
11011	收费接口须提供有效密钥
11012	鉴权方式错误
11013	接口不存在
11014	***地址无效
11015	***地址不允许
11016	***请求失败
11017	服务暂不可用
11018	请求方式不允许
11019	当前IP不在白名单内
11020	启用出口代理须提供有效密钥
11021	未配置可用出口代理
11022	出口代理不可用
11023	密钥已过期
11024	令牌分配积分不足

调用示例

终端 curl（bash）

搜索「鄙视」表情包，返回第一页 40 条数据：

curl "https://api.xiaoapi.cn/v1/meme.php?msg=%E9%84%AD%E8%A6%96&page=1&num=40"

获取指定页数内容：

curl "https://api.xiaoapi.cn/v1/meme.php?msg=%E9%84%AD%E8%A6%96&page=2&num=20"

获取当前页第 1 条表情详情：

curl "https://api.xiaoapi.cn/v1/meme.php?msg=%E9%84%AD%E8%A6%96&n=1"

PHP

// 搜索表情包示例
$msg = "鄙视";
$page = 1;
$num = 40;

$url = "https://api.xiaoapi.cn/v1/meme.php?msg=" . urlencode($msg) . "&page={$page}&num={$num}";

$response = file_get_contents($url);
$result = json_decode($response, true);

if ($result['code'] == 200) {
    echo "当前页码：" . $result['page'] . "\n";
    echo "每页数量：" . $result['num'] . "\n";

    foreach ($result['data'] as $item) {
        echo "图片地址：" . $item['img_url'] . "\n";
        echo "文件大小：" . $item['img_size'] . " 字节\n";
        echo "尺寸：{$item['img_width']}x{$item['img_height']}\n";
        echo "---\n";
    }
}

注意事项

关键词必填：msg 为必传参数，建议使用简洁明确的情绪或动作词（如“鄙视”“鼓掌”），以提高匹配准确率。
n 参数慎用：该参数用于返回当前页内指定位置的单个结果，获取后请注意处理空值情况；若需批量结果集，请勿传递此参数。
分页取值建议：page 默认为 1，num 默认为 40；若搜索结果较多，可通过递增 page 值翻页获取后续内容。
图片资源有效期：返回的 img_url 为第三方表情库直链，建议获取后尽快使用，部分资源可能存在临时性或变更风险。
请求频率控制：尽管本接口免费调用，仍建议在批量请求时合理控制频率（间隔 500ms 以上），避免触发***限流导致响应延迟或中断。
图片格式与尺寸：返回结果涵盖 JPG、PNG、GIF 等格式，img_height 与 img_width 为图片原始像素尺寸，GIF 动图可能与静态图尺寸存在差异，使用前可据此判断是否满足展示需求。
错误响应处理：接口返回 code 非 200 时表示请求异常，需在业务代码中对异常状态进行容错处理，避免因单个请求失败导致整体流程中断。

聊天图片表情搜索

请求参数

返回示例

详细文档

聊天图片表情搜索

接口说明

调用地址

请求方式

鉴权说明

请求参数

成功响应示例

响应字段说明

data 数组元素说明

错误响应示例

业务错误响应格式

常见业务错误示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

注意事项

快速上手

在线测试

接口反馈

今天是纪念日