item_review-获得小红书笔记评论
smallredbook.item_review
公共参数
请求地址: https://api-gw-4.cn/smallredbook/item_review
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
key | String | 是 | 调用key(必须以GET方式拼接在URL中) |
secret | String | 是 | 调用密钥 |
api_name | String | 是 | API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等] |
cache | String | 否 | [yes,no]默认yes,将调用缓存的数据,速度比较快 |
result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读 |
lang | String | 否 | [cn,en,ru]翻译语言,默认cn简体中文 |
version | String | 否 | API版本 |
请求参数
请求参数:num_iid=63e77ef7000000001300a9e3&cursor=
参数说明:num_iid:笔记ID
cursor:翻页参数(第一页默认为空)
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
items | items[] | 0 | 商品评论数据 |
请求示例
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "https://api-gw-4.cn/smallredbook/item_review/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=63e77ef7000000001300a9e3&cursor="
响应示例
{ "items": { "page_size": 2000, "total_results": 2000, "has_more": true, "cursor": "640c7908000000001603586a", "_ddf": "mt", "item": [ { "num_iid": "63e77ef7000000001300a9e3", "rate_date": "2023-03-11 02:57:49", "rate_content": "运纽约多少钱", "like_count": "12", "display_user_nick": "༜༄༼钰༽༄༜", "user_id": "5fabfd6b0000000001001261", "add_feedback": [ { "rate_content": "收到" }, { "rate_content": "纽约可以的" }, { "rate_content": "深圳宝安国际机场直飞纽约" } ] }, { "num_iid": "63e77ef7000000001300a9e3", "rate_date": "2023-03-07 09:30:16", "rate_content": "你好 询问海运美国运费", "like_count": "11", "display_user_nick": "游游甜品&长乐冰饭", "user_id": "5d45025300000000120177f5", "add_feedback": [ { "rate_content": "收到" }, { "rate_content": "纽约可以的" }, { "rate_content": "深圳宝安国际机场直飞纽约" }, { "rate_content": "亲,您好" }, { "rate_content": "好的" }, { "rate_content": "有多少呢" } ] }, { "num_iid": "63e77ef7000000001300a9e3", "rate_date": "2023-02-25 15:49:38", "rate_content": "有纽约的吗", "like_count": "7", "display_user_nick": "小哥哥控.诗宝", "user_id": "5e35b72d0000000001000110", "add_feedback": [ { "rate_content": "收到" }, { "rate_content": "纽约可以的" }, { "rate_content": "深圳宝安国际机场直飞纽约" }, { "rate_content": "亲,您好" }, { "rate_content": "好的" }, { "rate_content": "有多少呢" }, { "rate_content": "亲,您好" }, { "rate_content": "有的" }, { "rate_content": "您寄什么物品" } ] }, { "num_iid": "63e77ef7000000001300a9e3", "rate_date": "2023-02-26 00:19:17", "rate_content": "包装后的尺寸:210*85*65 重250斤左右纽约布鲁克林八大适", "like_count": "8", "display_user_nick": "鹊喜草药精油熏蒸养生小馆", "user_id": "63ac8c38000000002702a35f", "add_feedback": [ { "rate_content": "收到" }, { "rate_content": "纽约可以的" }, { "rate_content": "深圳宝安国际机场直飞纽约" }, { "rate_content": "亲,您好" }, { "rate_content": "好的" }, { "rate_content": "有多少呢" }, { "rate_content": "亲,您好" }, { "rate_content": "有的" }, { "rate_content": "您寄什么物品" }, { "rate_content": "可以的" }, { "rate_content": "私您啦亲" }, { "rate_content": "留意一下我的消息" } ] }, { "num_iid": "63e77ef7000000001300a9e3", "rate_date": "2023-02-23 13:04:45", "rate_content": "怎么联系", "like_count": "7", "display_user_nick": "momo", "user_id": "59ebe8fde8ac2b1781063632", "add_feedback": [ { "rate_content": "收到" }, { "rate_content": "纽约可以的" }, { "rate_content": "深圳宝安国际机场直飞纽约" }, { "rate_content": "亲,您好" }, { "rate_content": "好的" }, { "rate_content": "有多少呢" }, { "rate_content": "亲,您好" }, { "rate_content": "有的" }, { "rate_content": "您寄什么物品" }, { "rate_content": "可以的" }, { "rate_content": "私您啦亲" }, { "rate_content": "留意一下我的消息" }, { "rate_content": "亲,您好" }, { "rate_content": "来啦来啦" }, { "rate_content": "亲,已思信您" } ] }, { "num_iid": "63e77ef7000000001300a9e3", "rate_date": "2023-02-14 14:09:20", "rate_content": "怎么弄呢 我想寄一些大的家具 大理石餐桌那些", "like_count": "4", "display_user_nick": "雜食小仙女🌟", "user_id": "5d491c8200000000100370bd", "add_feedback": [ { "rate_content": "收到" }, { "rate_content": "纽约可以的" }, { "rate_content": "深圳宝安国际机场直飞纽约" }, { "rate_content": "亲,您好" }, { "rate_content": "好的" }, { "rate_content": "有多少呢" }, { "rate_content": "亲,您好" }, { "rate_content": "有的" }, { "rate_content": "您寄什么物品" }, { "rate_content": "可以的" }, { "rate_content": "私您啦亲" }, { "rate_content": "留意一下我的消息" }, { "rate_content": "亲,您好" }, { "rate_content": "来啦来啦" }, { "rate_content": "亲,已思信您" }, { "rate_content": "亲,您好" }, { "rate_content": "可以的" }, { "rate_content": "您官住我一下" } ] }, { "num_iid": "63e77ef7000000001300a9e3", "rate_date": "2023-02-23 05:20:23", "rate_content": "能寄佛罗里达州吗", "like_count": "6", "display_user_nick": "洛杉矶J姐", "user_id": "56ab10a86a6a694ca5c50e49", "add_feedback": [ { "rate_content": "收到" }, { "rate_content": "纽约可以的" }, { "rate_content": "深圳宝安国际机场直飞纽约" }, { "rate_content": "亲,您好" }, { "rate_content": "好的" }, { "rate_content": "有多少呢" }, { "rate_content": "亲,您好" }, { "rate_content": "有的" }, { "rate_content": "您寄什么物品" }, { "rate_content": "可以的" }, { "rate_content": "私您啦亲" }, { "rate_content": "留意一下我的消息" }, { "rate_content": "亲,您好" }, { "rate_content": "来啦来啦" }, { "rate_content": "亲,已思信您" }, { "rate_content": "亲,您好" }, { "rate_content": "可以的" }, { "rate_content": "您官住我一下" }, { "rate_content": "亲,您好" }, { "rate_content": "可以的" }, { "rate_content": "思您" } ] }, { "num_iid": "63e77ef7000000001300a9e3", "rate_date": "2023-02-16 05:53:07", "rate_content": "有大型貨運", "like_count": "6", "display_user_nick": "momo", "user_id": "604989df00000000010062a9", "add_feedback": [ { "rate_content": "收到" }, { "rate_content": "纽约可以的" }, { "rate_content": "深圳宝安国际机场直飞纽约" }, { "rate_content": "亲,您好" }, { "rate_content": "好的" }, { "rate_content": "有多少呢" }, { "rate_content": "亲,您好" }, { "rate_content": "有的" }, { "rate_content": "您寄什么物品" }, { "rate_content": "可以的" }, { "rate_content": "私您啦亲" }, { "rate_content": "留意一下我的消息" }, { "rate_content": "亲,您好" }, { "rate_content": "来啦来啦" }, { "rate_content": "亲,已思信您" }, { "rate_content": "亲,您好" }, { "rate_content": "可以的" }, { "rate_content": "您官住我一下" }, { "rate_content": "亲,您好" }, { "rate_content": "可以的" }, { "rate_content": "思您" }, { "rate_content": "亲,您好!" }, { "rate_content": "可以的" }, { "rate_content": "什么物品" } ] }, { "num_iid": "63e77ef7000000001300a9e3", "rate_date": "2023-02-15 23:08:10", "rate_content": "能寄电子产品吗", "like_count": "6", "display_user_nick": "Hi🌼", "user_id": "562667ea82718c3a8c9c8cb2", "add_feedback": [ { "rate_content": "收到" }, { "rate_content": "纽约可以的" }, { "rate_content": "深圳宝安国际机场直飞纽约" }, { "rate_content": "亲,您好" }, { "rate_content": "好的" }, { "rate_content": "有多少呢" }, { "rate_content": "亲,您好" }, { "rate_content": "有的" }, { "rate_content": "您寄什么物品" }, { "rate_content": "可以的" }, { "rate_content": "私您啦亲" }, { "rate_content": "留意一下我的消息" }, { "rate_content": "亲,您好" }, { "rate_content": "来啦来啦" }, { "rate_content": "亲,已思信您" }, { "rate_content": "亲,您好" }, { "rate_content": "可以的" }, { "rate_content": "您官住我一下" }, { "rate_content": "亲,您好" }, { "rate_content": "可以的" }, { "rate_content": "思您" }, { "rate_content": "亲,您好!" }, { "rate_content": "可以的" }, { "rate_content": "什么物品" }, { "rate_content": "亲,您好!" }, { "rate_content": "可以寄的" }, { "rate_content": "您寄什么物品呢" } ] }, { "num_iid": "63e77ef7000000001300a9e3", "rate_date": "2023-03-11 20:50:16", "rate_content": "价格是真的吗", "like_count": "5", "display_user_nick": "珠珠", "user_id": "5e1c5b530000000001002603", "add_feedback": [ { "rate_content": "收到" }, { "rate_content": "纽约可以的" }, { "rate_content": "深圳宝安国际机场直飞纽约" }, { "rate_content": "亲,您好" }, { "rate_content": "好的" }, { "rate_content": "有多少呢" }, { "rate_content": "亲,您好" }, { "rate_content": "有的" }, { "rate_content": "您寄什么物品" }, { "rate_content": "可以的" }, { "rate_content": "私您啦亲" }, { "rate_content": "留意一下我的消息" }, { "rate_content": "亲,您好" }, { "rate_content": "来啦来啦" }, { "rate_content": "亲,已思信您" }, { "rate_content": "亲,您好" }, { "rate_content": "可以的" }, { "rate_content": "您官住我一下" }, { "rate_content": "亲,您好" }, { "rate_content": "可以的" }, { "rate_content": "思您" }, { "rate_content": "亲,您好!" }, { "rate_content": "可以的" }, { "rate_content": "什么物品" }, { "rate_content": "亲,您好!" }, { "rate_content": "可以寄的" }, { "rate_content": "您寄什么物品呢" }, { "rate_content": "是的,价格真实有效" }, { "rate_content": "您寄什么物品" }, { "rate_content": "都多少呢" } ] } ] }, "secache": "abd7ae1db53600bb75ba4fb51ddc580d", "secache_time": 1688115623, "secache_date": "2023-06-30 17:00:23", "translate_status": "", "translate_time": 0, "language": { "default_lang": "cn", "current_lang": "cn" }, "error": "", "reason": "", "error_code": "0000", "cache": 1, "api_info": "today:177 max:10100 all[5595=177+43+5375];expires:2030-12-31", "execution_time": "0.064", "server_time": "Beijing/2023-06-30 17:08:39", "client_ip": "106.6.34.137", "call_args": { "num_iid": "63e77ef7000000001300a9e3", "page": 1 }, "api_type": "smallredbook", "translate_language": "zh-CN", "translate_engine": "baidu", "server_memory": "3.2MB", "request_id": "gw.649e9b97564d5", "last_id": "1840780640" }
异常示例
{ "error": "item-not-found", "reason": "商品没找到", "error_code": "2000", "success": 0, "cache": 0, "api_info": "today:0 max:10000", "execution_time": 0.081, "server_time": "Beijing/2020-06-10 23:44:00", "call_args": [], "api_type": "smallredbook", "request_id": "1ee0ffc041242"}
相关资料
错误码解释
状态代码(error_code) | 状态信息 | 详细描述 | 是否收费 |
---|---|---|---|
0000 | success | 接口调用成功并返回相关数据 | 是 |
2000 | Search success but no result | 接口访问成功,但是搜索没有结果 | 是 |
4000 | Server internal error | 服务器内部错误 | 否 |
4001 | Network error | 网络错误 | 否 |
4002 | Target server error | 目标服务器错误 | 否 |
4003 | Param error | 用户输入参数错误 | 忽略 |
4004 | Account not found | 用户帐号不存在 | 忽略 |
4005 | Invalid authentication credentials | 授权失败 | 忽略 |
4006 | API stopped | 您的当前API已停用 | 忽略 |
4007 | Account stopped | 您的账户已停用 | 忽略 |
4008 | API rate limit exceeded | 并发已达上限 | 忽略 |
4009 | API maintenance | API维护中 | 忽略 |
4010 | API not found with these values | API不存在 | 忽略 |
4012 | Please add api first | 请先添加api | 忽略 |
4013 | Number of calls exceeded | 调用次数超限 | 忽略 |
4014 | Missing url param | 参数缺失 | 忽略 |
4015 | Wrong pageToken | 参数pageToken有误 | 忽略 |
4016 | Insufficient balance | 余额不足 | 忽略 |
4017 | timeout error | 请求超时 | 否 |
5000 | unknown error | 未知错误 | 否 |
API 工具
小红书的API返回值通常会根据具体的API接口和功能而有所不同。对于获取小红书笔记评论的功能,API的返回值通常会包含笔记的评论列表,每个评论包含评论者的信息、评论内容、评论时间等。
下面是一个简化的示例,描述了可能的API返回值结构:
```json
{
"code": 0,
"message": "success",
"data": {
"count": 5, // 评论总数
"comments": [
{
"comment_id": "123456", // 评论ID
"user_id": "789012", // 评论者ID
"user_name": "张三", // 评论者用户名
"content": "这是一条评论内容。", // 评论内容
"created_at": "2023-04-01T10:00:00Z", // 评论创建时间
"is_liked": true, // 是否被点赞
"likes_count": 2 // 点赞数
},
{
"comment_id": "234567",
"user_id": "345678",
"user_name": "李四",
"content": "这是另一条评论内容。",
"created_at": "2023-04-01T10:10:00Z",
"is_liked": false,
"likes_count": 0
},
// 更多评论...
]
}
}
```
在这个示例中:
- `code` 表示API请求的状态码,`0` 通常表示成功。
- `message` 是API请求的消息,通常会返回"success"表示请求成功。
- `data` 字段包含实际的数据内容。
- `count` 表示评论的总数。
- `comments` 是一个数组,包含每个评论的详细信息。
- `comment_id` 是评论的唯一标识符。
- `user_id` 是评论者的唯一标识符。
- `user_name` 是评论者的用户名。
- `content` 是评论的具体内容。
- `created_at` 是评论的创建时间。
- `is_liked` 表示该评论是否被其他用户点赞。
- `likes_count` 表示该评论的点赞数。
请注意,这只是一个示例,并不代表小红书实际的API返回值。为了获得准确的返回值说明,你应该查阅小红书官方提供的API文档,或者通过小红书开放平台的相关文档来获取最新和最准确的信息。同时,确保你已经遵循了小红书的API使用协议和指南,包括获取和使用API密钥等认证过程。