EasyDown REST API platform guide
Short share URLs are resolved before the note workflow runs. EasyDown maps content media only and avoids mixing author avatars into the downloadable image list.
Parse public Xiaohongshu and RedNote video or image notes with an authenticated REST API that preserves every note image, video, first frame, and cover candidate.
RedNote download API · Xiaohongshu media API
Production REST endpoint
POST https://api.easydown.org/api/v1/parsexhslink.com/{code}xiaohongshu.com/explore/{noteId}xiaohongshu.com/discovery/item/{noteId}rednote.com/explore/{noteId}https://www.xiaohongshu.com/discovery/item/67f75b07000000000b0154b3?source=webshare&xhsshare=pc_web&xsec_token=ABUzYYSiMJkyRD5slTtuDPFvfSOmaGPxm2X4Unms9L1FY=&xsec_source=pc_share
curl -X POST https://api.easydown.org/api/v1/parse \
-H "Authorization: Bearer ed_live_xxx" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.xiaohongshu.com/discovery/item/67f75b07000000000b0154b3?source=webshare&xhsshare=pc_web&xsec_token=ABUzYYSiMJkyRD5slTtuDPFvfSOmaGPxm2X4Unms9L1FY=&xsec_source=pc_share"}'The shared envelope stays stable while this platform determines which media arrays and attributes are populated.
Image notes return every available content image and first-frame candidate. Video notes return mapped videos plus related content images while keeping source order.
{
"status": 200,
"data": {
"platform": "xiaohongshu",
"title": "Example xiaohongshu public post",
"thumbnail": "https://cdn.example.com/thumbnail.jpg",
"duration": 24,
"images": [
{
"url": "https://cdn.example.com/content-image.jpg",
"width": 1080,
"height": 1350
}
],
"videos": [
{
"url": "https://cdn.example.com/video.mp4",
"quality": "HD",
"mimeType": "video/mp4",
"width": 1080,
"height": 1920,
"hasAudio": true,
"source": "direct"
}
],
"audios": []
},
"msg": "success"
}Use Referer: https://www.xiaohongshu.com/ and a browser User-Agent from your backend. Image and video CDNs can enforce anti-hotlinking, cookies, expiring URLs, and regional access.
User-Agent: Mozilla/5.0
Referer: https://www.xiaohongshu.com/
Range: bytes=0-Profiles, search pages, collections, private notes, deleted notes, login-only media, and region-unavailable content are unsupported.
Only process public media you have the right to use. EasyDown does not bypass privacy controls, DRM, deleted content, or platform access restrictions.
Keep the full note URL when it contains access parameters required by the public page.
Proxy media instead of requesting Xiaohongshu CDNs directly from a browser.
Re-parse short or expired media URLs before retrying a download.
Create a private API token and allow this platform in its permissions.
POST one complete public post URL to the shared endpoint.
Select and proxy the required items from images, videos, and audios.
Use the MCP endpoint for AI agents, or open the browser tool for a manual public-media workflow.
Supported public single-post formats include xhslink.com/{code}, xiaohongshu.com/explore/{noteId}, xiaohongshu.com/discovery/item/{noteId}, rednote.com/explore/{noteId}. Profiles, search pages, collections, private notes, deleted notes, login-only media, and region-unavailable content are unsupported.
Image notes return every available content image and first-frame candidate. Video notes return mapped videos plus related content images while keeping source order.
Use Referer: https://www.xiaohongshu.com/ and a browser User-Agent from your backend. Image and video CDNs can enforce anti-hotlinking, cookies, expiring URLs, and regional access.
A response containing at least one image, video, or audio URL costs 1 credit. Failed, unsupported, authentication, and empty-media results do not consume credits.