# Rednote Transcript API – AI Video to Text for Developers (`apple_yang/rednote-transcripts-scraper`) Actor Xiaohongshu(Rednote) Transcript API for converting video audio into accurate text using AI. Extract transcripts, spoken content, and metadata from public videos. Fast, reliable, and built for developers, AI agents, and automation workflows. - **URL**: https://apify.com/apple\_yang/rednote-transcripts-scraper.md - **Developed by:** [APISmith](https://apify.com/apple_yang) (community) - **Categories:** AI, Social media, Videos - **Stats:** 9 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### Xiaohongshu Video Transcripts Scraper A powerful Apify Actor that extracts video metadata and automatically transcribes speech to text from Xiaohongshu (小红书/Rednote) videos. ### What does Xiaohongshu Video Transcripts Scraper do? This Actor extracts comprehensive video metadata from Xiaohongshu (also known as Rednote) and generates accurate speech-to-text transcripts. Simply provide a Xiaohongshu video URL, and the Actor will return the video title, description, author information, engagement metrics, and a full text transcription with time-stamped subtitle segments. Try it with any Xiaohongshu video URL like: `https://www.xiaohongshu.com/explore/68fb4b0d0000000004014668?xsec_token=xxx&xsec_source=pc_search` ### Why use Xiaohongshu Video Transcripts Scraper? - **Content creators**: Repurpose video content into text format for blogs, captions, or accessibility - **Researchers**: Analyze Xiaohongshu video content at scale with transcripts - **Marketers**: Extract and analyze video content for trend analysis and sentiment - **Language learners**: Get accurate transcriptions of Chinese video content - **API access**: Integrate with your existing workflows via Apify's API and scheduling ### How to use Xiaohongshu Video Transcripts Scraper 1. Open the Actor in Apify Console or via API 2. Provide a Xiaohongshu video URL in the `url` field 3. Optionally provide a `web_session` for premium/vip content 4. Run the Actor and receive video metadata with transcript ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `url` | string | Yes | Xiaohongshu video page URL (must be HTTPS with valid xsec_token) | | `web_session` | string | No | web_session ID for accessing premium or member-only content | #### Input JSON Example ```json { "url": "https://www.xiaohongshu.com/explore/68fb4b0d0000000004014668?xsec_token=ABtLEHExFo_twyUd7eXjKITljTuYH4gsikacd4soZERxw=&xsec_source=pc_search" } ```` ### Output The Actor outputs a JSON object with comprehensive video metadata and transcript data: ```json { "url": "https://www.xiaohongshu.com/explore/68fb4b0d0000000004014668?xsec_token=ABtLEHExFo_twyUd7eXjKITljTuYH4gsikacd4soZERxw=&xsec_source=pc_search&source=web_explore_feed", "noteId": "68fb4b0d0000000004014668", "noteType": "video", "title": "买车听劝❗毒舌辣评——比亚迪海鸥", "desc": "跟着毒舌一起看完优缺点\n你还会考虑比亚迪海鸥吗⁉️\n欢迎车主分享补充！\n#比亚迪[话题]## #比亚迪海鸥[话题]## #买车避坑[话题]## #买车那点事儿[话题]## #用车感受[话题]## #新手买车[话题]## #汽车[话题]## #值得入手的车[话题]## #汽车讲解[话题]## #买车那些事儿[话题]#", "img": "http://sns-webpic-qc.xhscdn.com/202605211356/a0f521617c50e9626166271fcaefd174/spectrum/1040g0k031o134c67l0005q2920onastfterbev0!nd_dft_wlteh_webp_3", "imgs": [ "http://sns-webpic-qc.xhscdn.com/202605211356/a0f521617c50e9626166271fcaefd174/spectrum/1040g0k031o134c67l0005q2920onastfterbev0!nd_dft_wlteh_webp_3" ], "videoUrl": "http://sns-video-v6.xhscdn.com/stream/1/110/259/01e8fb4abd254c61010370039a159d7b08_259.mp4?sign=b02f1d412dba0f113a4b0e89bc3d715d&t=6a133be0", "audioUrl": "", "duration": 56.379, "userId": "68491031000000001d0173af", "userName": "毒舌说车", "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31it5ft1ggo605q2920onastfsqlfkeg", "likedCount": 174, "commentCount": 22, "collectedCount": 83, "shareCount": 110, "createTime": 1761299213000, "lastUpdateTime": 1761299214000, "tags": "比亚迪 比亚迪海鸥 买车避坑 买车那点事儿 用车感受 新手买车 汽车 值得入手的车 汽车讲解 买车那些事儿", "errMsg": "", "timestamp": "2026-05-21T05:57:00.952Z", "text": "每周独舍一款车 今天是比亚迪海鸥 定位小型轿车 价格在6.98万至8.58万之间 综合续航305至405千米 12.03至15.38秒的百公里加速 配备伏迪磷磷酸铁锂电池 优点 外观青春小小 深受女生喜爱 空间灵活 后排座椅放倒后可扩展至930升 单身贵足够用 全系标配ESP加4系囊 高配含主动刹车和车道保持 10.1英寸旋转屏加D-Link系统 支持语音控制和远程启动 缺点 车主反馈车窗容易起雾 侧窗生向不能挂掉外面附着的雨水 有一定安全隐患 倒车影像质量不稳定 会出现失灵问题 会无故出现熄火停车 或者无法启动的问题 部分车主反馈 出风口会喷粉 属于凭控盖制事件 总体来说 这个价位的车咱也不能挑剔太多 喜欢就值得入手 你买我推荐 问我我不买 当然 有没有真实车主进来说说使用感受 欢迎补充", "segments": [ { "start": 0, "end": 1.1, "text": "每周独舍一款车" }, { "start": 1.1, "end": 2.76, "text": "今天是比亚迪海鸥" }, { "start": 2.76, "end": 4.24, "text": "定位小型轿车" }, { "start": 4.24, "end": 7.1, "text": "价格在6.98万至8.58万之间" }, { "start": 7.1, "end": 9.6, "text": "综合续航305至405千米" }, { "start": 9.6, "end": 12.44, "text": "12.03至15.38秒的百公里加速" }, { "start": 12.44, "end": 14.34, "text": "配备伏迪磷磷酸铁锂电池" }, { "start": 14.34, "end": 14.96, "text": "优点" }, { "start": 14.96, "end": 16.18, "text": "外观青春小小" }, { "start": 16.18, "end": 17.18, "text": "深受女生喜爱" }, { "start": 17.18, "end": 17.86, "text": "空间灵活" }, { "start": 17.86, "end": 20.48, "text": "后排座椅放倒后可扩展至930升" }, { "start": 20.48, "end": 21.6, "text": "单身贵足够用" }, { "start": 21.6, "end": 23.64, "text": "全系标配ESP加4系囊" }, { "start": 23.64, "end": 25.92, "text": "高配含主动刹车和车道保持" }, { "start": 25.92, "end": 28.7, "text": "10.1英寸旋转屏加D-Link系统" }, { "start": 28.7, "end": 30.56, "text": "支持语音控制和远程启动" }, { "start": 30.56, "end": 31.2, "text": "缺点" }, { "start": 31.2, "end": 32.82, "text": "车主反馈车窗容易起雾" }, { "start": 32.82, "end": 35.14, "text": "侧窗生向不能挂掉外面附着的雨水" }, { "start": 35.14, "end": 36.14, "text": "有一定安全隐患" }, { "start": 36.14, "end": 37.74, "text": "倒车影像质量不稳定" }, { "start": 37.74, "end": 38.9, "text": "会出现失灵问题" }, { "start": 38.9, "end": 40.62, "text": "会无故出现熄火停车" }, { "start": 40.62, "end": 41.9, "text": "或者无法启动的问题" }, { "start": 41.9, "end": 43.06, "text": "部分车主反馈" }, { "start": 43.06, "end": 44.06, "text": "出风口会喷粉" }, { "start": 44.06, "end": 45.58, "text": "属于凭控盖制事件" }, { "start": 45.58, "end": 46.6, "text": "总体来说" }, { "start": 46.6, "end": 48.58, "text": "这个价位的车咱也不能挑剔太多" }, { "start": 48.92, "end": 49.88, "text": "喜欢就值得入手" }, { "start": 49.88, "end": 51.04, "text": "你买我推荐" }, { "start": 51.04, "end": 52.44, "text": "问我我不买" }, { "start": 52.44, "end": 52.96, "text": "当然" }, { "start": 52.96, "end": 55.22, "text": "有没有真实车主进来说说使用感受" }, { "start": 55.22, "end": 56, "text": "欢迎补充" } ] } ``` You can download the dataset in JSON, HTML, CSV, or Excel format from Apify Console. ### Data Table | Field | Type | Description | |-------|------|-------------| | `url` | string | Original Xiaohongshu video URL | | `noteId` | string | Unique video identifier | | `noteType` | string | Content type (usually "video") | | `title` | string | Video title | | `desc` | string | Video description | | `img` | string | Cover image URL | | `imgs` | string\[] | All images in the post | | `videoUrl` | string | Direct video stream URL | | `audioUrl` | string | Audio stream URL (if available) | | `duration` | number | Video duration in seconds | | `userId` | string | Author's user ID | | `userName` | string | Author's display name | | `avatar` | string | Author's avatar URL | | `likedCount` | number | Number of likes | | `commentCount` | number | Number of comments | | `collectedCount` | number | Number of times saved | | `shareCount` | number | Number of shares | | `createTime` | number | Unix timestamp of creation | | `lastUpdateTime` | number | Unix timestamp of last update | | `tags` | string | Space-separated list of tags | | `text` | string | Full transcript text | | `segments` | array | Time-stamped subtitle segments | | `timestamp` | string | ISO timestamp of when data was extracted | ### Pricing This Actor uses Apify's speech-to-text service which bills per minute of audio transcribed. Free users are limited to videos under 5 minutes. Paid users have no duration restriction. #### Cost Estimation - **Compute units**: Approximately 1-2 AU per video depending on duration - **Speech-to-text**: Billed per billable minute (rounded up from 60-second intervals) - **Free tier**: Videos up to 5 minutes are supported - **Paid users**: No video duration limit ### Tips and Advanced Options - **Web\_session ID**: Provide a valid `web_session` cookie from Xiaohongshu to access premium or region-restricted content - **Batch processing**: Call this Actor programmatically in a loop to process multiple videos - **Webhook integration**: Use Apify webhooks to get notified when transcription completes - **API access**: Integrate via Apify API for automated workflows ### Limitations and Disclaimer - This Actor is provided for educational and personal use only - Respect copyright and intellectual property rights when using transcriptions - Video availability depends on Xiaohongshu's current service status - Some premium content may require valid authentication For issues, feature requests, or custom solutions, visit the [Issues tab](https://github.com/your-repo/issues). # Actor input Schema ## `videoUrl` (type: `string`): The URL of the rednote(xiaohongshu) you want to get the data from. ## Actor input object example ```json { "videoUrl": "https://www.xiaohongshu.com/explore/6428b7be000000001300d335?xsec_token=ABjGZokYoKG4YPWXxLcGE9PCmavUE_h1MaytwfjcmrCyw=&xsec_source=pc_cfeed" } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "videoUrl": "https://www.xiaohongshu.com/explore/6428b7be000000001300d335?xsec_token=ABjGZokYoKG4YPWXxLcGE9PCmavUE_h1MaytwfjcmrCyw=&xsec_source=pc_cfeed" }; // Run the Actor and wait for it to finish const run = await client.actor("apple_yang/rednote-transcripts-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "videoUrl": "https://www.xiaohongshu.com/explore/6428b7be000000001300d335?xsec_token=ABjGZokYoKG4YPWXxLcGE9PCmavUE_h1MaytwfjcmrCyw=&xsec_source=pc_cfeed" } # Run the Actor and wait for it to finish run = client.actor("apple_yang/rednote-transcripts-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "videoUrl": "https://www.xiaohongshu.com/explore/6428b7be000000001300d335?xsec_token=ABjGZokYoKG4YPWXxLcGE9PCmavUE_h1MaytwfjcmrCyw=&xsec_source=pc_cfeed" }' | apify call apple_yang/rednote-transcripts-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=apple_yang/rednote-transcripts-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Rednote Transcript API – AI Video to Text for Developers", "description": "Xiaohongshu(Rednote) Transcript API for converting video audio into accurate text using AI. Extract transcripts, spoken content, and metadata from public videos. Fast, reliable, and built for developers, AI agents, and automation workflows.", "version": "0.0", "x-build-id": "YQsKgCST58wiFmgEV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apple_yang~rednote-transcripts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apple_yang-rednote-transcripts-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/apple_yang~rednote-transcripts-scraper/runs": { "post": { "operationId": "runs-sync-apple_yang-rednote-transcripts-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/apple_yang~rednote-transcripts-scraper/run-sync": { "post": { "operationId": "run-sync-apple_yang-rednote-transcripts-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "videoUrl" ], "properties": { "videoUrl": { "title": "The URL of the rednote(xiaohongshu)", "type": "string", "description": "The URL of the rednote(xiaohongshu) you want to get the data from." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```