小红书获取用户作品列表API接口操作指南

一、前期准备

  1. 注册开放平台账号
    • 访问小红书开放平台,完成实名认证。
    • 创建应用,选择"电商"或"数据分析"类目,获取App Key 和App Secret(密钥需妥善保管)。
  2. 申请接口权限
    • 在开发者控制台申请item_search_shop_video(用户作品列表)或item_get_video(笔记详情)接口权限,审核通过后生效。
二、API调用流程

1. 接口地址与参数

  • 用户作品列表接口 :
    GET https://api.xiaohongshu.com/api/v1/search/shop_video
    必填参数 :
    • user_id:用户唯一标识(通过用户主页URL解析)
    • page:分页页码(默认1)
    • page_size:每页数量(最大50)
    • sort:排序方式(如create_time按时间排序)

2. 请求示例(Python)

复制代码

python

|--------------------------------------------------------------------------------|
| import requests |
| |
| app_key = "YOUR_APP_KEY" |
| app_secret = "YOUR_APP_SECRET" |
| user_id = "目标用户ID" |
| |
| url = "https://api.xiaohongshu.com/api/v1/search/shop_video" |
| params = { |
| "user_id": user_id, |
| "page": 1, |
| "page_size": 30, |
| "sort": "create_time" |
| } |
| headers = {"Authorization": f"Bearer {app_key}"} |
| |
| response = requests.get(url, headers=headers, params=params) |
| if response.status_code == 200: |
| data = response.json() |
| # 解析作品列表 |
| for item in data["data"]["items"]: |
| print(f"作品ID: {item['num_iid']}, 标题: {item['title']}, 点赞数: {item['likes']}") |
| else: |
| print(f"请求失败,状态码: {response.status_code}") |

3. 响应数据结构

复制代码

json

|------------------------------------------|
| { |
| "code": 200, |
| "message": "success", |
| "data": { |
| "items": [ |
| { |
| "num_iid": "作品ID", |
| "title": "作品标题", |
| "likes": 150, |
| "comments": 20, |
| "create_time": "2025-01-01T00:00:00Z", |
| "detail_url": "作品链接" |
| } |
| ], |
| "pagination": { |
| "current_page": 1, |
| "total_pages": 5 |
| } |
| } |
| } |

三、关键注意事项
  1. 频率限制
    • 普通开发者QPS≤10,企业认证后可提升至100,每日调用上限50,000次。
    • 高频调用建议使用缓存(如Redis,过期时间30分钟)。
  2. 合规性要求
    • 禁止存储用户敏感信息(如手机号、地址)。
    • 图片需通过CDN代理引用,避免直接使用小红书源链接。
    • 遵守《小红书机器人协议》(robots.txt),避免高频访问。
  3. 错误处理
    • 错误码示例:
      • 10001:参数错误
      • 30001:权限不足
    • 需根据小红书API文档页面排查错误。
四、替代方案(非官方)

若官方API无法满足需求,可通过合法爬虫模拟浏览器请求,但需注意:

  • 使用requests或selenium库,设置合理请求间隔(如2秒/次)。
  • 仅抓取公开数据,避免侵入用户隐私。
  • 示例代码(爬虫):
复制代码

python

|--------------------------------------------------------------|
| import requests |
| from bs4 import BeautifulSoup |
| |
| url = "https://www.xiaohongshu.com/user/profile/{user_id}" |
| headers = {"User-Agent": "Mozilla/5.0"} |
| response = requests.get(url, headers=headers) |
| soup = BeautifulSoup(response.text, 'html.parser') |
| # 解析作品列表(需根据页面结构调整) |

五、总结

通过小红书开放平台API可高效获取用户作品列表,需严格遵守平台规则。建议优先使用官方接口,若需补充数据可结合爬虫(需合规)。开发过程中需关注接口文档更新,并定期检查调用权限状态。

相关推荐
Flynn Liang21 小时前
I/O 密集型高并发实战:Java 服务 10 维优化,从线程打满到 10 万 QPS
java·spring boot·性能优化·高并发·系统设计·虚拟线程·io密集型
吃我一窝jio1 天前
Python与Go线程模型深度对比
java·开发语言·python
这个昵称不容易1 天前
SpringBoot 购物推荐网站的设计与实现:120 个 Java 文件、147 个接口、13 张表,附真实运行截图
java·springboot·毕设
文丑颜不良啊1 天前
LeetCode3041~3060题目解析
java·leetcode
zwd20051 天前
Manim 怎么放大画面的某一部分?
python·动画·可视化·manim·数学动画
屿华AI1 天前
AUTOSAR 实战-诊断工具 | UDS 0x27 安全访问的配置化实现:种子密钥算法插件化设计
python·测试工具·汽车
RobinDevNotes1 天前
Claude Code 剪视频,不上传、不要 API Key
人工智能·python·音视频·开发工具·ipython
文丑颜不良啊1 天前
LeetCode3101~3120题目解析
java·leetcode
Resean02231 天前
SpringMVC 6+源码分析(十一)视图渲染与异步请求(收尾篇)
java·spring·springmvc
靠沿1 天前
MySQL数据库进阶——存储过程和触发器
java·数据库·mysql