一、接口获取与权限申请

1. 注册与认证
   • 访问某书开放平台/第三方开放平台，注册开发者账号并完成企业认证。
   • 在控制台创建应用，选择“商品搜索”相关接口权限（如 item_search），提交申请并等待审核。
2. 获取凭证
   • 审核通过后，在应用详情页获取 app_key（API密钥）和 app_secret（加密密钥）。

二、接口调用方式

请求头

json{"Content-Type": "application/json","Authorization": "Bearer {access_token}"  # 需结合OAuth2.0获取}

必填参数

加密参数

签名生成规则

1. 参数按字典序排序，拼接为字符串：
   key1=value1&key2=value2...+app_secret
2. 使用MD5加密后转为大写。

三、请求示例（Python）

pythonimport requestsimport hashlibimport timedef generate_sign(params, app_secret):sorted_params = sorted(params.items())sign_str = '&'.join([f"{k}={v}" for k, v in sorted_params]) + app_secretreturn hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()# 配置参数app_key = "YOUR_APP_KEY"app_secret = "YOUR_APP_SECRET"keyword = "口红"page_no = 1page_size = 10params = {"app_key": app_key,"keyword": keyword,"page_no": page_no,"page_size": page_size,"timestamp": int(time.time())}# 生成签名params["sign"] = generate_sign(params, app_secret)# 发送请求url = "https://api.xiaohongshu.com/v1/search/items"response = requests.get(url, params=params)# 处理响应if response.status_code == 200:data = response.json()if data.get("code") == 200:for item in data["data"]["items"]:print(f"商品ID: {item['item_id']}, 标题: {item['title']}, 价格: ¥{item['price']}")else:print(f"API错误: {data.get('message')}")else:print(f"请求失败，状态码: {response.status_code}")

四、返回数据结构（JSON）

json{"code": 200,"message": "success","data": {"items": [{"item_id": "64f6f55d000000001d015a5a","title": "【新品】XX品牌丝绒口红 持久不脱色","price": 199.00,"images": ["https://sns-img-qc.xhscdn.com/image1.jpg","https://sns-img-qc.xhscdn.com/image2.jpg"],"sales": 1200,"shop": {"shop_id": "987654321","name": "XX旗舰店","rating": 4.9}}],"pagination": {"total": 150,"page_no": 1,"page_size": 10}}}

五、注意事项

1. 频率限制
   • 默认每分钟100次，超限需联系平台申请提额。
2. 分页处理
   • 通过 page_no和 page_size遍历全部结果，例如：

     pythonfor page in range(1, total_pages + 1):params["page_no"] = page# 发送请求...

3. 数据合规
   • 禁止爬取用户隐私数据（如手机号、地址）。
   • 遵守《网络安全法》和《个人信息保护法》。
4. 错误排查
   • 401错误：检查 app_key或签名是否正确。
   • 404错误：确认接口地址无误。
   • 500错误：稍后重试或联系技术支持。

六、扩展功能

• 筛选排序：部分接口支持按价格、销量排序（需查阅文档确认参数）。
• 类目过滤：通过 category_id指定商品类目（如美妆、服饰）。

如需高级功能（如实时库存查询），需联系小红书商务团队定制接口。