获取用户笔记列表/Get user posted notes
Changed on[中文]
用途:
- 获取指定用户已发布的笔记列表,使用游标分页
⚠️ 计费提示:
- 如果传入错误或不存在的用户ID(或分享链接解析失败),接口仍会正常响应,但 data 中会返回上游"服务异常"信息,该请求 同样会正常计费扣费,请在调用前确保参数有效。
参数:
- user_id: 用户ID,如 "61b46d790000000010008153"
- share_text: 小红书分享链接,支持APP和Web端分享链接,支持 xiaohongshu.com 长链接、xhslink.com 和 xhslink.cn 短链接
- 优先使用user_id,如果没有则使用share_text,两个参数二选一,如都携带则以user_id为准。
- cursor: 分页游标,首次请求留空,翻页时传入上一次响应中返回的 cursor 值
- 通常cursor取值方式为notes列表的最后一条笔记的 note_id
- JSON路径示例: $.data.data.notes[-1].cursor
返回:
- 用户笔记列表数据,包含笔记基本信息和分页信息
翻页说明:
- 首次请求:cursor留空
- 翻页请求:传入上一次响应中返回的 cursor 值
[English]
Purpose:
- Get list of notes posted by a specified user, using cursor pagination
⚠️ Billing Notice:
- If a wrong or non-existent user ID is passed (or the share link fails to parse), the endpoint still responds normally, but the data field will contain an upstream "service error" message. Such requests will still be billed as normal. Please make sure the parameters are valid before calling.
Parameters:
- user_id: User ID, e.g. "61b46d790000000010008153"
- share_text: Xiaohongshu sharing link, supports APP and Web sharing links, including xiaohongshu.com full links, xhslink.com and xhslink.cn short links
- Prefer to use user_id, if not, use share_text, one of the two parameters is required, if both are carried, user_id shall prevail.
- cursor: Pagination cursor, leave empty for first request, pass cursor value from previous response for next page
- The cursor is usually the note_id of the last note in the notes list
- JSON path example: $.data.data.notes[-1].cursor
Return:
- User posted notes list data, including basic note info and pagination info
Pagination Guide:
- First request: leave cursor empty
- Next page: pass cursor value from previous response
[示例/Example]
user_id="61b46d790000000010008153"
Request
- Base URLhttps://api.tikhub.io (the document declares no server; this is the origin it was published from)
- AuthHTTP bearer
Query parameters
用户ID/User ID
分享链接,支持xiaohongshu.com/xhslink.com/xhslink.cn/Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn
分页游标,首次请求留空/Pagination cursor, leave empty for first request
Response
Successful Response
Changes
- info
added the optional property
//to the response with the status - info
added the optional property
//to the response with the status
- info
- info
the
response's property default value changed fromThis request will be cached. You can access the cached result directly using the URL belowvalid for 24 hours. Accessing the cache will not incur additional charges.toThis response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.for the status - info
the
response's property default value changed from本次请求将被缓存,你可以使用下面的 URL 直接访问缓存结果,有效期为 24 小时,访问缓存不会产生额外费用。to本次响应已缓存,可通过下方 URL 直接查看,有效期 24 小时,访问缓存链接无额外费用。缓存仅用于请求溯源,不影响接口数据的时效性,也不会再次通过接口返回。for the status
- info