小红书商品详情API接口（item_get-获得小红书商品详情接口）

小红书商品详情API接口（item_get-获得小红书商品详情接口）代码对接如下：

1.公共参数

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中，点击获取请求key和secret）
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版本

2.请求参数

请求参数：num_iid=5eb1097ba091410953951d17

参数说明：num_iid:小红书商品ID 

3.响应参数

获取单个笔记详细数据：

note_id为笔记id，如 5b275e5c9374260197ec884a
short_url为笔记短链接，如 https://xhslink.com/jJI6sg 此参数与note_id之间只需要传一个

返回如下：
{
  "ok": true,
  "result": {
    ... # 返回值与小红书接口一样，字段比较多，按字面意思理解即可
  }
}

当作品不存在时，则返回如下：
{
  "cost": true,
  "error": "作品不存在",
  "ok": false
}

 

获取笔记的评论列表

每页返回20条。
如果要翻页，需要传入cursor参数（会在前一次请求结果里返回），第一次请求不需要传此参数。
返回如下：
{
  "ok": true,
  "result": {
    'cursor': '5e16e6200000000001009400',
    'data':{...}  # 评论数据
  }
}

获取单条评论下的回复列表

每页返回20条。
如果要翻页，需要传入cursor参数（会在前一次请求结果里返回），第一次请求不需要传此参数。
返回如下：
{
  "ok": true,
  "result": {
    'cursor': '5e16e6200000000001009400',
    'data': []  # 评论回复列表
  }
}

 

获取单个笔记关联的商品列表（当笔记存在关联商品时才需要调用此接口）

如果要翻页，需要传入page参数，从1开始，每页最多10条。
返回如下：
{
  "ok": true,
  "result": {
    ... # 返回值与小红书接口一样，字段比较多，按字面意思理解即可
  }
}

获取用户笔记列表

如果要翻页，需要传入cursor参数（会在前一次请求结果里返回），第一次请求不需要传此参数。
返回如下：
{
  "ok": true,
  "result": {
    ... # 返回值与小红书接口一样
  }
}

获取用户个人页信息

返回如下：
{
  "ok": true,
  "result": {
    ... # 返回值与小红书接口一样
  }
}

当用户不存在时，则返回如下：
{
  "cost": true,
  "error": "用户不存在",
  "ok": false
}

 

获取用户关注列表

每页返回20条。
如果要翻页，需要传入cursor参数（会在前一次请求结果里返回），第一次请求不需要传此参数。
返回如下：
{
  "ok": true,
  "retCode": 0,
  "cost": true,
  "result": {
    'cursor': '5e16e6200000000001009400',
    'data': []  # 用户列表
  }
}

 

获取用户粉丝列表

每页返回20条。
如果要翻页，需要传入cursor参数（会在前一次请求结果里返回），第一次请求不需要传此参数。
返回如下：
{
  "ok": true,
  "retCode": 0,
  "cost": true,
  "result": {
    'cursor': '5e16e6200000000001009400',
    'data': []  # 用户列表
  }
}

获取用户点赞的笔记列表

每页返回7条。
如果要翻页，需要传入cursor参数（会在前一次请求结果里返回），第一次请求不需要传此参数。
返回如下：
{
  "ok": true,
  "retCode": 0,
  "cost": true,
  "result": {
    'cursor': '5e846cd30000000001006feb',
    'data': []  # 笔记列表
  }
}

 

获取用户收藏的笔记列表

每页返回7条。
如果要翻页，需要传入cursor参数（会在前一次请求结果里返回），第一次请求不需要传此参数。
返回如下：
{
  "ok": true,
  "retCode": 0,
  "cost": true,
  "result": {
    'cursor': '5e846cd30000000001006feb',
    'data': []  # 笔记列表
  }
}

获取与用户互动的笔记列表

如果要翻页，需要传入page参数，第一页传1，之后每一页加1，以此类推
返回如下：
{
  "ok": true,
  "retCode": 0,
  "cost": true,
  "result": {
    ... # 返回值与小红书接口一样
  }
}

 

获取商城店铺下的商品列表

如果要翻页，需要传入page参数，从1开始，每页最多20条。
返回如下：
{
  "ok": true,
  "result": {
    ... # 返回值与小红书接口一样
  }

关键字搜索笔记列表

如果要翻页，需要传入page参数，从1开始，每页最多20条。
sort为搜索排序方式，可取值：general(综合) popularity_descending(最热) time_descending(最新)， 默认取general
filter_note_type为笔记类型筛选，可取值：普通笔记、视频笔记，默认不传此参数，即不执行筛选

⚠️注意：小红书搜索接口最多翻50页
解析结果时，请根据返回的model_type来判断不同类型的笔记，比如当model_type=note和ads时对应的字段格式有所不同。

返回如下：
{
  "ok": true,
  "result": {
    ... # 返回值与小红书接口一样
  }
}

 

关键字搜索商品列表

如果要翻页，需要传入page参数，从1开始，每页最多20条。
sort为搜索排序方式，可取值：sales_qty(销量) fav_count(种草数) price_asc(价格升序) price_desc(价格降序) new_arrival(新品优先)
当sort不传时，则默认为综合搜索

返回如下：
{
  "ok": true,
  "result": {
    ... # 返回值与小红书接口一样
  }
}

topic/话题页相关接口

如果是获取topic/话题详情，pageId为topic分享页的id，如 5f40db4e2e11630001b3a440

如果要获取笔记列表，请传入subPath=notes参数，并支持以下额外参数：
page：翻页参数，从1开始，默认为1
sort：排序，可取之为hot与time，默认为hot，表示按热度排序，time表示按最新排序


返回如下：
{
  "ok": true,
  "result": {
    ... # 返回值与小红书接口一样
  }
}

 4.请求示例（CURL、PHP 、PHPsdk 、Java 、C# 、Python…)

# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 请求示例 url 默认请求参数已经做URL编码
url = "https://wx19970108018/smallredbook/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=5eb1097ba091410953951d17"
headers = {
    "Accept-Encoding": "gzip",
    "Connection": "close"
}
if __name__ == "__main__":
    r = requests.get(url, headers=headers)
    json_obj = r.json()
    print(json_obj)