{"id":37528681,"url":"https://github.com/hostinger-bot/rednote-api","last_synced_at":"2026-01-16T08:27:57.488Z","repository":{"id":325534780,"uuid":"1101533104","full_name":"hostinger-bot/rednote-api","owner":"hostinger-bot","description":"Fast, free, and open-source Rednote (小红书) video/image downloader built with Rust + Axum.","archived":false,"fork":false,"pushed_at":"2025-11-21T22:52:17.000Z","size":32,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-21T23:18:08.833Z","etag":null,"topics":["api","axum","downloader","rust","rust-api","xiaohongshu"],"latest_commit_sha":null,"homepage":"https://rednote-api-nzkldq.fly.dev","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hostinger-bot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-21T20:13:35.000Z","updated_at":"2025-11-21T22:52:20.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hostinger-bot/rednote-api","commit_stats":null,"previous_names":["hostinger-bot/rednote-api"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/hostinger-bot/rednote-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hostinger-bot%2Frednote-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hostinger-bot%2Frednote-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hostinger-bot%2Frednote-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hostinger-bot%2Frednote-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hostinger-bot","download_url":"https://codeload.github.com/hostinger-bot/rednote-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hostinger-bot%2Frednote-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28478047,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T06:30:42.265Z","status":"ssl_error","status_checked_at":"2026-01-16T06:30:16.248Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","axum","downloader","rust","rust-api","xiaohongshu"],"created_at":"2026-01-16T08:27:56.600Z","updated_at":"2026-01-16T08:27:57.462Z","avatar_url":"https://github.com/hostinger-bot.png","language":"Rust","readme":"## Rednote (Xiaohongshu / 小红书) Unofficial API\n\nFast, free, and open-source Rednote (小红书) video/image downloader built with Rust + Axum.\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/hostinger-bot/rednote-api/actions/workflows/rust.yml\"\u003e\n    \u003cimg src=\"https://github.com/hostinger-bot/rednote-api/actions/workflows/rust.yml/badge.svg\" alt=\"Rust\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/hostinger-bot/rednote-api/actions/workflows/rust-clippy.yml\"\u003e\n    \u003cimg src=\"https://github.com/hostinger-bot/rednote-api/actions/workflows/rust-clippy.yml/badge.svg\" alt=\"rust-clippy\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\n---\n\n## 🚀 About This Project\n\nThis is an unofficial, reverse-engineered API for downloading Rednote (Xiaohongshu) media.  \nIt extracts:\n- Post information\n- High-resolution images\n- Original video URLs (no watermark)\n- Title, keywords, description\n- Engagement data (likes, comments, collects)\n\nFully open-source and optimized for performance.\n\n---\n\n## ✨ Features\n\n- Download Xiaohongshu videos without watermark  \n- Extract all post images  \n- Built with async Rust  \n- Supports GET and POST  \n- CORS enabled (browser-friendly)  \n- Complete OpenAPI 3.0 documentation  \n- Every response includes `status: true/false`  \n\n---\n\n## 📦 Installation\n\n```sh\ngit clone https://github.com/hostinger-bot/rednote-api.git\ncd rednote-api\ncargo build\ncargo build --release\n```\n\n### Start the Server\n\n```sh\ncargo run\n# or for production\ncargo run --release\n```\n\nDefault URL: http://localhost:4000\n\n### Development Commands\n\n```sh\ncargo check\ncargo fmt\ncargo clippy\n```\n\n### Testing\n\n```sh\ncargo test\n```\n\n---\n\n## 🔥 API Endpoints\n\n### GET /api/rednote\n\nQuery Parameters:\n- `url` (string, required)\n\nExample:\n```\n/api/rednote?url=http://xhslink.com/o/21DKXV988zp\n```\n\n### POST /api/rednote\n\nBody:\n\n```json\n{\n  \"url\": \"http://xhslink.com/o/21DKXV988zp\"\n}\n```\n\n---\n\n## 📤 Success Response Example\n\n```json\n{\n  \"desc\": \"这碗面不仅是食物，更是快乐的来源！好吃到想每天吃!\",\n  \"downloads\": [],\n  \"duration\": \"\",\n  \"engagement\": {\n    \"collects\": \"0\",\n    \"comments\": \"2\",\n    \"likes\": \"1\"\n  },\n  \"images\": [\n    \"http://sns-webpic-qc.xhscdn.com/202601081924/6bd0dbeff2d295034320d652e5920a11/1040g00831ej7ki91h26g5ps768227md5hqjjk70!nd_dft_wlteh_jpg_3\"\n  ],\n  \"keywords\": \"\",\n  \"nickname\": \"这碗面不仅是食物，更是快乐的来源！好吃到想每天吃!\",\n  \"noteId\": \"67c6308c000000002a00fff2\",\n  \"status\": true,\n  \"title\": \"这碗面不仅是食物，更是快乐的来源！好吃到想每天吃! - 小红书\"\n}\n```\n\n---\n\n## ❌ Error Response Example\n\n```json\n{\n  \"status\": false,\n  \"error\": \"Invalid Xiaohongshu URL\"\n}\n```\n\n---\n\n## 📚 API Documentation\n\n- GET `/openapi.json`\n- GET `/docs`\n\n---\n\n## 🧩 Response Schema\n\n| Field | Type | Description |\n|-------|------|-------------|\n| noteId | string | Unique Rednote post ID |\n| nickname | string | Author name |\n| title | string | Post title |\n| desc | string | Description |\n| keywords | string | Extracted keywords |\n| duration | string | Video duration |\n| engagement | object | Likes, comments, collects |\n| images | string[] | List of image URLs |\n| downloads | object[] | Video download sources |\n| status | bool | API success flag |\n| error | string | Error message (only on failure) |\n\n---\n\n## 🤝 Contributing\n\nPRs are welcome. Open issues, submit fixes, or suggest new features.\n\n---\n\n## 📄 License\n\nMIT License © 2025 Tio (BOTCAHX)\n\n---\n\n## ⭐ Support\n\nGive this project a ★ on [GitHub](https://github.com/hostinger-bot/rednote-api).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhostinger-bot%2Frednote-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhostinger-bot%2Frednote-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhostinger-bot%2Frednote-api/lists"}