Rednote (Xiaohongshu / 小红书) Unofficial API

Fast, free, and open-source Rednote (小红书) video/image downloader built with Rust + Axum.

---

🚀 About This Project

This is an unofficial, reverse-engineered API for downloading Rednote (Xiaohongshu) media.
It extracts:

• Post information
• High-resolution images
• Original video URLs (no watermark)
• Title, keywords, description
• Engagement data (likes, comments, collects)

Fully open-source and optimized for performance.

---

✨ Features

• Download Xiaohongshu videos without watermark
• Extract all post images
• Built with async Rust
• Supports GET and POST
• CORS enabled (browser-friendly)
• Complete OpenAPI 3.0 documentation
• Every response includes status: true/false

---

📦 Installation

git clone https://github.com/hostinger-bot/rednote-api.git
cd rednote-api
cargo build
cargo build --release

Start the Server

cargo run
# or for production
cargo run --release

Default URL: http://localhost:4000

Development Commands

cargo check
cargo fmt
cargo clippy

Testing

cargo test

---

🔥 API Endpoints

GET /api/rednote

Query Parameters:

• url (string, required)

Example:

/api/rednote?url=http://xhslink.com/o/2jqifpr7GJ5

POST /api/rednote

Body:

{
  "url": "http://xhslink.com/o/2jqifpr7GJ5"
}

---

📤 Success Response Example

{
  "noteId": "6810c9a3000000002300ed1e",
  "nickname": "我想你的夜 (Wǒ xiǎng nǐ de yè)",
  "title": "我想你的夜 - 小红书",
  "desc": "最近无聊的时候写了一段歌词...",
  "keywords": "music, sunoai",
  "duration": "03:20",
  "engagement": {
    "likes": "4",
    "comments": "2",
    "collects": "0"
  },
  "images": [
    "https://..."
  ],
  "downloads": [
    {
      "quality": "Original",
      "url": "https://..."
    }
  ],
  "status": true
}

---

❌ Error Response Example

{
  "status": false,
  "error": "Invalid Xiaohongshu URL"
}

---

📚 API Documentation

• GET /openapi.json
• GET /docs

---

🧩 Response Schema

Field	Type	Description
noteId	string	Unique Rednote post ID
nickname	string	Author name
title	string	Post title
desc	string	Description
keywords	string	Extracted keywords
duration	string	Video duration
engagement	object	Likes, comments, collects
images	string[]	List of image URLs
downloads	object[]	Video download sources
status	bool	API success flag
error	string	Error message (only on failure)

---

🤝 Contributing

PRs are welcome. Open issues, submit fixes, or suggest new features.

---

📄 License

MIT License © 2025 Tio (BOTCAHX)

---

⭐ Support

Give this project a ★ on GitHub.