Pricing

from $0.90 / 1,000 note scrapeds

Try for free

Go to Apify Store

Xiaohongshu (RED) Scraper: Feeds + Creators

Try for free

Scrape Xiaohongshu / RedNote discovery feeds across 11 category channels, with note text, topics, engagement and video URLs, plus creator profiles with followers, bio and niche tags. No login or API key.

Pricing

from $0.90 / 1,000 note scrapeds

Rating

0.0

(0)

Developer

The Mine Works

Actor stats

Bookmarked

Total users

Monthly active users

9 days ago

Last modified

Categories

Social media

Marketing

You can access the Xiaohongshu (RED) Scraper: Feeds + Creators programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.1",
    "x-build-id": "ROvQ1zVOrKaugHzhb"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/themineworks~xiaohongshu-explore-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-themineworks-xiaohongshu-explore-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/themineworks~xiaohongshu-explore-scraper/runs": {
      "post": {
        "operationId": "runs-sync-themineworks-xiaohongshu-explore-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/themineworks~xiaohongshu-explore-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-themineworks-xiaohongshu-explore-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": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "What to scrape",
            "enum": [
              "feed",
              "creators"
            ],
            "type": "string",
            "description": "feed = Xiaohongshu's discovery feed, all of it or by category. creators = profile and recent posts for the creators you supply.",
            "default": "feed"
          },
          "categories": {
            "title": "Feeds to scrape (feed mode)",
            "type": "array",
            "description": "Pick the Explore feed and/or any of Xiaohongshu's 11 category channels, e.g. \"explore\" for the general feed or \"homefeed.food_v3\" for food content. Choosing several rotates between them so you get a share from each rather than filling up on the first.",
            "items": {
              "type": "string",
              "enum": [
                "explore",
                "homefeed.fashion_v3",
                "homefeed.food_v3",
                "homefeed.cosmetics_v3",
                "homefeed.movie_and_tv_v3",
                "homefeed.career_v3",
                "homefeed.love_v3",
                "homefeed.household_product_v3",
                "homefeed.gaming_v3",
                "homefeed.travel_v3",
                "homefeed.fitness_v3",
                "homefeed.video_v3"
              ],
              "enumTitles": [
                "Explore (all topics)",
                "Fashion 穿搭",
                "Food 美食",
                "Beauty 彩妆",
                "Film & TV 影视",
                "Career 职场",
                "Relationships 情感",
                "Home 家居",
                "Gaming 游戏",
                "Travel 旅行",
                "Fitness 健身",
                "Video 视频"
              ]
            },
            "default": [
              "explore"
            ]
          },
          "includeDetails": {
            "title": "Fetch full note details",
            "type": "boolean",
            "description": "Open each note to add its body text, topic tags, comment/share/save counts, all image URLs, the playable video URL and the publish date. This costs one extra request per note and is billed at the higher per-note rate.",
            "default": false
          },
          "creators": {
            "title": "Creator profile URLs (creators mode)",
            "type": "array",
            "description": "Paste full Xiaohongshu profile URLs, for example https://www.xiaohongshu.com/user/profile/5bc41ce0c2ffcc00015326e0?xsec_token=ABxxx. Use the full copied URL: Xiaohongshu serves a gate page to roughly 3 in 8 requests that lack the xsec_token, so a bare user ID is retried but not reliable.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Max records",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum billable records to return. In feed mode this counts notes; in creators mode it counts creators (their recent posts come included).",
            "default": 50
          },
          "monitorMode": {
            "title": "Monitor mode (only new records)",
            "type": "boolean",
            "description": "Run on a schedule and get ONLY records not delivered in a previous run, so a standing feed watch bills for new posts instead of re-billing the same feed every morning. Keep the input the same across 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Xiaohongshu (RED) Scraper: Feeds + Creators OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Xiaohongshu (RED) Scraper: Feeds + Creators from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Xiaohongshu (RED) Scraper: Feeds + Creators API in Python

Xiaohongshu (RED) Scraper: Feeds + Creators API in JavaScript

Xiaohongshu (RED) Scraper: Feeds + Creators API through CLI

Xiaohongshu (RED) Scraper: Feeds + Creators API

Rednote (Xiaohongshu) Note Detail Scraper

khadinakbar/xiaohongshu-note-detail-scraper

Scrape public Xiaohongshu (RedNote / 小红书) note details from note URLs or IDs — title, description, images/video URLs, likes, collects, comments, shares, author, tags. Cookieless; no Xiaohongshu login required. MCP-ready.

Khadin Akbar

RedNote (Xiaohongshu) Scraper - Trending Notes & Creators

scrapesage/rednote-xiaohongshu-scraper

Scrape RedNote / Xiaohongshu with no login or cookies: trending notes across 12 category feeds, full note detail (body, all images, video stream URLs, likes/collects/comments/shares as real numbers) and creator profiles with RedID, IP location, followers, engagement rate. Monitor-only-new mode.

Scrape Sage

📕 RedNote (Xiaohongshu) Note Detail Scraper

ethereal_wool/xiaohongshu-note-detail-scraper

Fetch full RedNote / Xiaohongshu (小红书) note details by ID or URL: text, creator, likes, comments, collects, shares, tags, location, images and video metadata. No login, structured JSON, pay per result.

Jackie Chen

RedNote Xiaohongshu Profile Scraper

lightmoon/rednote-profile-scraper

Look up public RedNote (Xiaohongshu) creators in bulk: nickname, Red ID, bio, IP location, followers, likes, plus their notes with titles, dates and likes. No login needed. Chinese social media influencer research - find creators, track engagement, export to CSV or Excel.

Stable

RedNote Xiaohongshu Search Scraper

khadinakbar/xiaohongshu-search-scraper

Search RedNote (Xiaohongshu) notes by keyword with an authorized session and return structured note cards with titles, creators, images, likes, URLs, and scrape time.

Khadin Akbar

📕 RedNote (Xiaohongshu) Note Search Scraper

ethereal_wool/xiaohongshu-note-search-scraper

Search RedNote / Xiaohongshu (小红书) notes by keyword and export title, text, creator, note type, likes, comments, collects and direct links. No login, structured JSON/CSV/Excel, pay per result.

Jackie Chen

Xiaohongshu (RedNote) User Profile Scraper

khadinakbar/xiaohongshu-user-profile-scraper

Scrape public Xiaohongshu (RedNote) user profiles from URLs, share links, or user IDs. Returns nickname, Red ID, bio, followers, likes, IP location, and verification. Cookieless; no login. Not comments, note detail, or search. $0.01 per found profile.

Khadin Akbar

RedNote Note Detail API – Xiaohongshu Video & Images

lance_api/xiaohongshu-note-detail-scraper-api

Extract structured RedNote (Xiaohongshu/XHS) note details from video and image posts, including author data, engagement metrics, tags, image galleries, covers, and playable video stream URLs.

LanceAPI

Xiaohongshu (RED) Explore Scraper — engagement by channel

entrogix_works/xiaohongshu-explore-scraper

Scrape Xiaohongshu explore feeds by channel and get notes with like counts plus a per-channel engagement breakdown. Unofficial; not affiliated with Xiaohongshu.

Entrogix Works

Xiaohongshu (RedNote) Scraper — Notes, Profiles & Search

crawloop/xiaohongshu-scraper

Scrape Xiaohongshu (RedNote) notes, creator profiles, comments, and keyword search. Get likes, collects, images, video URLs, and hashtags — explore and note pages work with no login. Export JSON via API, Python, Node.js, or MCP.