Prepare a Xiaohongshu note’s title, text and ordered images in the web app or your own system. Create a link or QR code for the publisher to review on their phone, attempt to open the Xiaohongshu editor, and confirm publication themselves.
No Xiaohongshu password needed · The publisher confirms the final post
这是一篇集中验证的测试笔记：长正文、多张图片、长图和话题都在同一篇里…… (Home preview; see all 967 characters in the demo.)
Prepare, review and open the editor. You confirm the final post.
Use PNG, JPEG or static WebP, up to 10 MB per image. Long images keep their original dimensions and can be viewed in full on the phone.
Keep the title, text and image order together, with fewer files and ordering instructions to pass through chat.
A successful creation costs one credit. Retries with the same account, idempotency key and content do not charge again; a new key creates a new billable draft.
Links last up to 7 days and expire earlier if hosted images do. Check the actual expiry; the creator can revoke a link.
Deliver the content to a phone and attempt to open the editor. The publisher reviews and confirms publication in Xiaohongshu.
Use a computer or phone to prepare the title, text and ordered images, then create a link and QR code.
Create a handoffAfter your content tool prepares the text and images, call the API and pass the handoff link to the publisher. Keep the original request and idempotency key when retrying.
Read developer docsBuy handoffs in packs with no credit expiry date. See current plans and prices. View plans and prices →
Before choosing the service, check what the handoff API does, its image limits and billing. Visit usage help for detailed steps and troubleshooting.
No. The API creates a draft handoff link; it does not publish automatically or unattended. The publisher opens the link on their phone, checks the draft and confirms publication in the Xiaohongshu editor.
You do not provide a Xiaohongshu password or Cookie. Use this service’s API Key to create the handoff; the publisher reviews and confirms it using their own Xiaohongshu account on their phone.
Prepare the draft or show its QR code on a computer, then confirm on a phone. Use Safari on iPhone or the system browser on Android. Results depend on the OS, browser and Xiaohongshu version, so verify the fields in the editor.
A handoff accepts 1–18 images. Hosted uploads support PNG, JPEG and static WebP up to 10 MB each. Long images can be viewed at full height on the handoff page. Video is not supported.
Creating a handoff uses one credit. Retrying with the same account, idempotency key and content, or viewing an existing link again, does not incur another charge. A new key creates and charges for a new handoff.
A handoff lasts at most seven days and no longer than its earliest expiring hosted image. Check the actual expiry time. The creator can revoke it earlier. Anyone holding the link can view and forward it, so share it deliberately.
Having trouble opening the editor, loading images, retrying or checking an order?
Open usage help and troubleshooting
