{
"openapi": "3.0.1",
"info": {
"title": "RedNote Videos Scraper | Downloader, Transcripts and Stats",
"description": "RedNote Videos Scraper for Xiaohongshu (ε°ηΊ’δΉ¦): turn video links, share links or the trending Explore feed into rows with the watermark-free video file, the transcript with its English translation, likes, saves, comments, shares, author and hashtags. 12 videos in 2 seconds, 32 fields each, no account.",
"version": "1.0",
"x-build-id": "eRXQl9n5OboYUGEVq"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/silentflow~rednote-videos-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-silentflow-rednote-videos-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/silentflow~rednote-videos-scraper/runs": {
"post": {
"operationId": "runs-sync-silentflow-rednote-videos-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/silentflow~rednote-videos-scraper/run-sync": {
"post": {
"operationId": "run-sync-silentflow-rednote-videos-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",
"properties": {
"videoUrls": {
"title": "π¬ Video links or share links",
"type": "array",
"description": "The videos to read, one per line. Three formats work:
β’ Video link copied from the browser: https://www.xiaohongshu.com/explore/6a83b279000000003400ff6a?xsec_token=...
β’ Share link from the app: https://xhslink.com/a/...
β’ The whole share message copied from the app (the link inside is found for you)
A note id alone cannot be opened: copy the full link, it carries the access code the site asks for. Picture posts are skipped. Leave the list empty to read the Explore feed below instead.",
"items": {
"type": "string"
}
},
"keywords": {
"title": "π Keywords",
"type": "array",
"description": "Find videos about a topic in the live Explore feed: the actor reads the feed chosen below and keeps the videos whose title, description or hashtags contain one of these words, for example vlog, ηΎι£ or ζ»η₯. Broad words in Chinese find the most videos; pick the matching feed (Food for ηΎι£, Travel for ζ»η₯). The app's own search box needs an account and is not used. Leave empty to keep every video.",
"items": {
"type": "string"
}
},
"category": {
"title": "π§ Explore feed",
"enum": [
"recommend",
"fashion",
"food",
"cosmetics",
"movie",
"career",
"love",
"home",
"gaming",
"travel",
"fitness"
],
"type": "string",
"description": "The Explore feed to read when no video link is given, or when keywords are set. Recommended is the home feed of the site; the others are its topic feeds. The feed changes every few seconds, so two runs return different videos.",
"default": "recommend"
},
"maxItems": {
"title": "π’ Max videos",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "The most videos to save in this run, across the links and the feed. Each video is one row. With keywords the feed is read until this many matching videos are found or about 400 videos were checked.",
"default": 20
},
"includeTranscript": {
"title": "π Transcripts",
"type": "boolean",
"description": "Add the spoken text of each video (transcript) and its English translation (transcriptEnglish) when the site has subtitles for it, which is the case for most videos with speech. Turn off for slightly faster runs.",
"default": true
},
"debugMode": {
"title": "π Debug log",
"type": "boolean",
"description": "Adds detailed diagnostic messages to the run log. Leave off for normal runs.",
"default": false
}
}
},
"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
},
"PROXY_UNBLOCKER_UNITS": {
"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
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}