小红书获得小红书商品详情笔记详情 API接口数据item_get接入测试指南

smallredbook.item_get

公共参数

API测试工具

名称类型必须描述
keyString调用key(必须以GET方式拼接在URL中)
secretString调用密钥
api_nameStringAPI接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]
cacheString[yes,no]默认yes,将调用缓存的数据,速度比较快
result_typeString[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读
langString[cn,en,ru]翻译语言,默认cn简体中文
versionStringAPI版本

请求参数

请求参数:num_iid=5eb1097ba091410953951d17

参数说明:num_iid:小红书商品ID
filter:note(搜索笔记/视频)

响应参数

Version: Date:

名称类型必须示例值描述

num_iid

String01999629976商品ID

title

String02019新款女装短袖t恤女夏宽松韩版休闲上衣百搭蝙蝠衫五分袖体恤商品标题

price

Float08.8价格

minGroupPrice

String0

maxGroupPrice

String0

total_price

Float0

orginal_price

Float0原价

nick

String0雅怡服饰1688卖家昵称

num

Int0233库存

sales

Int076销量

detail_url

String0http://yangkeduo.com/goods.html?goods_id=1999629976宝贝链接

desc

String0本店默认申通快递【还有百世汇通 中通快递 中通 韵达 邮政】。商家建议尺码仅供参考。如有其它问题请及时联系客服!喜欢的赶紧购买,质量保证,买的放心,穿的也开心!商品备注

item_imgs

Mix0[{"url": "//t00img.yangkeduo.com/t05img/images/2018-06-28/24bcb29df1195edaea840afd3e1bdaf9.jpeg?imageMogr2/strip%7CimageView2/2/w/1300/q/80"}]宝贝图片列表

pic_url

String0//t00img.yangkeduo.com/t05img/images/2018-06-28/24bcb29df1195edaea840afd3e1bdaf9.jpeg?imageMogr2/thumbnail/150x/quality/50宝贝图片

props_name

String0商品属性名

prop_imgs

Mix0{"prop_img": [ {"properties": "0:0;1:1", "url": "//t00img.yangkeduo.com/t10img/images/2018-06-28/5c8f783ab2c4fea0ffea8fac73d8b2c2.jpeg"}]}商品属性图片列表

props

Mix0商品详情

skus

Mix0{"sku": [{"price": "16.56", "total_price": null, "orginal_price": "20.9", "properties": "0:0;1:1", "properties_name": "0:0:颜色:黑色;1:1:尺码:M【75-100斤】", "quantity": 221, "sku_id": 36410965966}]商品规格信息

props_list

Mix0{ "0:0": "颜色:黑色","1:1": "尺码:M【75-100斤】"}商品属性

props_img

Mix0{"0:0;1:1": "//t00img.yangkeduo.com/t10img/images/2018-06-28/5c8f783ab2c4fea0ffea8fac73d8b2c2.jpeg"}属性图片

property_alias

String0商品属性别名

seller_info

Mix0{"nick": "雅怡服饰1688", "city": "", "level": null, "rate": null, "score": 4.27, "delivery_score": 4.37, "item_score": 4.38, "shop_type": "", "user_num_id": "", "sid": 99033, "shop_name": "雅怡服饰1688", "zhuy": "", "menu": [] }卖家信息

shop_item

Mix0[]

relate_items

Mix0[]

 

 

错误码解释

状态代码(error_code)状态信息详细描述是否收费
0000success接口调用成功并返回相关数据
2000Search success but no result接口访问成功,但是搜索没有结果
4000Server internal error服务器内部错误
4001Network error网络错误
4002Target server error目标服务器错误
4003Param error用户输入参数错误忽略
4004Account not found用户帐号不存在忽略
4005Invalid authentication credentials授权失败忽略
4006API stopped您的当前API已停用忽略
4007Account stopped您的账户已停用忽略
4008API rate limit exceeded并发已达上限忽略
4009API maintenanceAPI维护中忽略
4010API not found with these valuesAPI不存在忽略
4012Please add api first请先添加api忽略
4013Number of calls exceeded调用次数超限忽略
4014Missing url param参数缺失忽略
4015Wrong pageToken参数pageToken有误忽略
4016Insufficient balance余额不足忽略
4017timeout error请求超时
5000unknown error未知错误

 

<think>嗯,用户想了解如何获取小红书笔记详情API接口的信息或使用方法,特别是使用说明文档。首先,我需要整理一下已有的引用资料,看看里面有没有相关的步骤或者信息。根据引用1到4,可以看到几个关键点: 首先,引用4提到了具体的步骤:注册并创建应用,获取App Key和App Secret,然后进行认证获取Access Token,最后调用接口传入笔记ID。这可能是一个基本流程。引用3也提到需要前期准备和接口申请,可能需要联系相关人员获取权限。引用2和1则提到了接口的功能,比如获取笔记的标题、内容、作者信息等。 接下来,用户可能需要详细的步骤说明,包括如何注册应用、认证、获取token,以及调用接口的具体参数和示例代码。但根据提供的引用,示例代码可能只有引用3和4提到有代码示例,但实际内容里并没有给出具体的代码,只是提到了需要联系获取或者步骤说明。因此,在回答时需要将这些步骤分点列出,并强调需要联系小红书开放平台获取权限,可能还需要附上简化的代码示例,比如Python的requests库调用。 另外,用户可能关心接口的认证方式,比如签名机制,以及返回的数据格式,比如JSON。引用4提到了签名和认证,所以需要解释OAuth 2.0流程。返回的数据结构如标题、内容、作者信息、发布时间等,需要具体说明。 需要注意的是,所有引用中提到的步骤都涉及注册应用和获取密钥,这是关键的第一步。同时,可能存在的难点在于签名生成和Access Token的获取,需要详细说明。此外,可能存在的常见问题,比如权限申请被拒、参数错误、频率限制等,应该在注意事项里提到。 最后,生成相关问题,帮助用户进一步了解API的使用,比如如何提高调用频率、处理返回数据、错误排查等。需要确保问题与主题相关,并且基于现有引用内容,比如性能优化可能不在引用范围内,但数据解析和错误处理可以涉及。</think>以下是根据小红书开放平台文档整理的获取笔记详情API接口使用说明: ### 一、接口基础信息 1. **接口功能**:通过笔记ID获取笔记的标题、内容、作者信息、发布时间等完整数据 2. **请求方式**:GET/POST(需根据最新文档确认) 3. **认证方式**:OAuth 2.0签名认证流程[^4] ### 二、接入步骤 1. **注册开发者账号** - 访问[小红书开放平台](https://open.xiaohongshu.com/) - 完成企业实名认证(个人开发者可能受限) 2. **创建应用** - 在控制台新建应用获取凭证: - `App Key`(客户端ID) - `App Secret`(客户端密钥) 3. **获取Access Token** ```python import requests auth_url = "https://open.xiaohongshu.com/api/oauth2/access_token" params = { "client_id": "YOUR_APP_KEY", "client_secret": "YOUR_APP_SECRET", "grant_type": "client_credentials" } response = requests.post(auth_url, params=params) access_token = response.json()['access_token'] ``` (注意:实际参数可能需包含签名参数) 4. **调用笔记详情接口** ```python note_api = "https://open.xiaohongshu.com/api/notes/detail" headers = {"Authorization": f"Bearer {access_token}"} params = { "note_id": "笔记ID字符串", "request_id": "唯一请求标识" } response = requests.get(note_api, headers=headers, params=params) ``` ### 三、响应数据结构(示例) ```json { "code": 200, "message": "success", "data": { "note_id": "5e4a8b7c0000000001000000", "title": "春季穿搭指南", "content": "...", "author": { "user_id": "用户唯一标识", "nickname": "时尚达人" }, "create_time": "2023-03-15 10:00:00", "likes": 1500, "comments": 235 } } ``` ### 四、注意事项 1. 需申请接口权限并通过审核才能调用 2. 每日调用次数有限制(根据开发者等级不同) 3. 必须包含合法签名参数(参考签名算法文档) 4. 返回数据需遵守小红书内容使用规范[^3] ### 五、常见错误码 | 错误码 | 说明 | 解决方案 | |--------|-----------------------|------------------------| | 40001 | 无效的Access Token | 检查Token获取流程 | | 40003 | 缺少必填参数 | 核对接口文档参数列表 | | 40301 | 接口调用权限不足 | 申请对应接口权限 | | 50000 | 服务端内部错误 | 重试或联系技术支持 |
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值