当使用小红书笔记详情API时,获取到的返回值是一个包含丰富信息的JSON数据结构。这个结构通常涵盖了笔记的各个方面,如标题、内容、图片、作者信息、发布时间等。
返回值以JSON格式呈现,首先你会看到一个包含笔记唯一标识符的id
字段,紧接着是title
字段显示笔记的标题。随后是content
字段,它包含了笔记的详细内容。图片信息则通过images
字段以URL数组的形式给出。此外,user
字段提供了笔记作者的详细信息,而created_at
和updated_at
则分别表示笔记的创建和更新时间。
smallredbook.item_get_video
公共参数
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
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=649c46ab000000002702ad36
参数说明:num_iid:笔记ID
字段解析:
- id:这是笔记的唯一标识符,用于在小红书平台内部唯一标识这篇笔记。
- title:笔记的标题,通常用于展示给用户看。
- content:笔记的内容,可以是文本、HTML或其他富文本格式。
- images:一个包含笔记中图片URL的数组。这些URL通常用于在前端展示图片。
- user:一个包含笔记作者信息的对象。其中
id
是用户的唯一标识符,username
是用户名。 - created_at 和 updated_at:分别表示笔记的创建时间和最后更新时间。
- likes_count 和 comments_count:分别表示这篇笔记的点赞数和评论数。
- tags:一个包含笔记标签的数组。这些标签通常用于分类和搜索。
- location:如果笔记包含了地理位置信息,这里会包含相关信息。
- views_count:表示这篇笔记的浏览量。但请注意,并非所有版本的API都会返回这个字段。
注意:
- API的返回值结构可能会随着小红书平台的更新而发生变化,因此建议开发者经常查看小红书的官方文档以获取最新的API信息。
- 调用API时,请确保使用正确的API密钥,并遵循小红书的API使用规定和限制。
- 在处理API返回值时,要注意处理可能出现的空值或异常情况,以确保程序的健壮性。
返回数据示例
"item": {
"num_iid": "649c46ab000000002702ad36",
"detail_url": "https://www.xiaohongshu.com/explore/649c46ab000000002702ad36",
"title": "变形金刚4",
"type": "video",
"video": "http://sns-video-qc.xhscdn.com/stream/110/258/01e49c46a63bcd390103770389027d1ad7_258.mp4?sign=180a24669a446bf75a3ec79f41926bcb&t=64a04c54",
"pic_url": "https://sns-img-hw.xhscdn.com/0ccd59b9-71ad-d2c0-ec5a-afac90d21355?imageView2/2/h/1920/format/webp|imageMogr2/strip",
"tag_list": [
{
"name": "变形金刚",
"type": "topic",
"id": "545c2716d6e4a924bf74ed49"
}
],
"desc": " 这就是柱子哥的魅力",
"city": "河北",
"nick": "变形金刚电影剪辑",
"uid": "64805fc1000000000f004891",
"interact_info": {
"liked_count": "41",
"collected_count": "16",
"comment_count": "0"
},
"time": "2023-06-28 22:41:47",
"_ddf": "mt"
},
"error": "",
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:182 max:10100 all[5611=182+44+5385];expires:2030-12-31",
"execution_time": "1.957",
"server_time": "Beijing/2023-06-30 17:21:49",
"client_ip": "106.6.34.137",
"call_args": [],
"api_type": "smallredbook",
"translate_language": "zh-CN",
"translate_engine": "baidu",
"server_memory": "3.03MB",
"request_id": "1.649e9eab4b441",
"last_id": "1840805874"