Pricing

from $4.99 / 1,000 results

RedNote (Xiaohongshu) Search Scraper - 500 Notes/30s

Extract Xiaohongshu (RedNote / 小红书) search results by keyword. Get author profile, engagement counts (likes, comments, collects), image galleries, and playable video stream URLs — 24 fields per note. No headless browser, no captcha. 500 notes in 30s. Filter by note type. JSON/CSV/Excel export.

Pricing

from $4.99 / 1,000 results

Rating

0.0

(0)

Developer

Zen Studio

Actor stats

Bookmarked

Total users

Monthly active users

5 hours ago

Last modified

Categories

Social media

Videos

Automation

You can access the RedNote (Xiaohongshu) Search Scraper - 500 Notes/30s 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 Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.0",
    "x-build-id": "sVW7cWielYQ7ktQoj"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/zen-studio~rednote-search-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-zen-studio-rednote-search-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/zen-studio~rednote-search-scraper/runs": {
      "post": {
        "operationId": "runs-sync-zen-studio-rednote-search-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/zen-studio~rednote-search-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-zen-studio-rednote-search-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": [
          "keywords"
        ],
        "properties": {
          "keywords": {
            "title": "🔍 Search keywords",
            "minItems": 1,
            "type": "array",
            "description": "Add one or more search terms.<br><br>• Chinese works: <code>美食推荐</code>, <code>咖啡</code>, <code>穿搭</code><br>• English works too: <code>lululemon</code>, <code>iphone</code>, <code>tokyo</code><br><br>Each keyword runs independently with its own <b>Max results</b> budget.",
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "📊 Max results per keyword",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "How many unique notes to collect for <b>each keyword</b>. Every result counts toward your bill.<br><br>Narrow keywords (e.g., <code>lululemon align pants size 6</code>) may yield fewer than the cap because the source has a finite catalogue per query.",
            "default": 100
          },
          "sortType": {
            "title": "Sort by",
            "enum": [
              "general",
              "popularity_descending",
              "time_descending"
            ],
            "type": "string",
            "description": "How the source ranks results.<br><br>• <b>Most relevant</b> — curated relevance ranker (default; balanced for most queries)<br>• <b>Most popular</b> — by engagement (likes + comments); surfaces viral hits<br>• <b>Newest first</b> — by publish time; for trend monitoring",
            "default": "general"
          },
          "topUpFromOtherSorts": {
            "title": "Combine all sort modes for more unique notes",
            "type": "boolean",
            "description": "Run your chosen <b>Sort by</b> first. If that sort runs out of unique notes before hitting your <b>Max results per keyword</b> target, also fetch from the other two sort modes and merge them — duplicates removed automatically.<br><br><b>Recommended ON</b> (default). Same per-result price, but you typically get <b>2&ndash;3&times; more unique notes</b> for broad keywords like <code>美食</code> or <code>lululemon</code>.<br><br>Turn OFF if you only want notes from your chosen sort order (strict ranking).",
            "default": true
          },
          "noteType": {
            "title": "Note type",
            "enum": [
              "all",
              "video",
              "image",
              "live"
            ],
            "type": "string",
            "description": "Restrict to a single note format.<br><br>• <b>All types</b> — image + video + live (default)<br>• <b>Video notes</b> — only entries with playable video<br>• <b>Image notes</b> — only photo galleries<br>• <b>Live notes</b> — only livestream replays (rare)",
            "default": "all"
          },
          "timeFilter": {
            "title": "Time window",
            "enum": [
              "all",
              "1d",
              "1w",
              "6mo"
            ],
            "type": "string",
            "description": "Restrict to notes published in a recent window. Use for trend monitoring or to avoid stale content.",
            "default": "all"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

RedNote (Xiaohongshu) Search Scraper - 500 Notes/30s 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 RedNote (Xiaohongshu) Search Scraper - 500 Notes/30s 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:

RedNote (Xiaohongshu) Search Scraper - 500 Notes/30s API in Python

RedNote (Xiaohongshu) Search Scraper - 500 Notes/30s API in JavaScript

RedNote (Xiaohongshu) Search Scraper - 500 Notes/30s API through CLI

RedNote (Xiaohongshu) Search Scraper - 500 Notes/30s API

Xiaohongshu (RedNote) Scraper — Notes, Users & Search

sian.agency/xiaohongshu-rednote-scraper

Xiaohongshu + RedNote (Little Red Book) scraper — note details, user profiles, full note catalogs, comments, search across notes and users. KOL discovery, engagement metrics, lifestyle trend mining for China market research. Six operations, one clean dataset per run. No API key.

SIÁN OÜ

Xiaohongshu (RedNote) Comments Scraper - Reply Threads

zen-studio/rednote-comments-scraper

Extract every Xiaohongshu (RedNote) comment with nested reply threads, author profile, avatar URL, IP city, like counts, attached pictures, and @-mentions. Paste note URLs or 24-character note IDs. 30+ fields per comment, export to JSON, CSV, or Excel.

Zen Studio

Rednote (Xiaohongshu) Profile Scraper

parsebird/rednote-profile-scraper

Scrape Rednote (Xiaohongshu / 小红书) user profiles — bio, follower count, following, likes, RedID, location, gender, tags. No login required. JSON/CSV/Excel export. Pay per result.

ParseBird

All In One Rednote (Xiaohongshu) Scraper

laishaohang/all-in-one-rednote-xiaohongshu-scraper

Effortlessly scrape Xiaohongshu (RedNote) data with this all-in-one tool: search notes by keywords/tracking, analyze comments, download media (videos/images). Insights for e-commerce, marketing, and research. Start free trial!

少航来

103

5.0

Rednote (Xiaohongshu) Posts Scraper

parsebird/rednote-posts-scraper

Scrape all posts from Rednote (Xiaohongshu) user profiles — titles, cover images, likes, post type. No login required. Pay per result.

ParseBird

Rednote(Xiaohongshu) Download

paul_44/rednote-download-actor

Download RedNote / Xiaohongshu videos & images from any note URL. Returns direct CDN URL (no watermark) + metadata: title, author, stats, hashtags. Supports xhslink short URLs. No login needed.

paul_44

5.0

RedNote(Xiaohongshu) Search Scraper 🔍

easyapi/rednote-xiaohongshu-search-scraper

Scrape RedNote (Xiaohongshu) search results with advanced features. Extract posts, user info, and engagement metrics from China's leading lifestyle platform. Perfect for market research, trend analysis, and social listening.

EasyApi

816

1.5

RedNote (Xiaohongshu) Profile Scraper 🔍

easyapi/rednote-xiaohongshu-profile-scraper

Extract user profile data from RedNote (Xiaohongshu) including basic information, follower counts, and interaction metrics. Perfect for influencer analysis and social media research.

EasyApi

117

RedNote (Xiaohongshu) Comments Scraper 🔍

easyapi/rednote-xiaohongshu-comments-scraper

Scrape comments from RedNote (Xiaohongshu) posts efficiently. Extract detailed comment data including user info, timestamps, locations, and nested replies. Perfect for social media analysis, user research, and engagement tracking.

EasyApi

208

1.0

RedNote / Xiaohongshu Scraper — Search, Posts, Users, Comments

dltik/rednote-xiaohongshu-scraper

All-in-one RedNote (Xiaohongshu) scraper: search by keyword, fetch post details, user posts, comments. Get title, content, images, hashtags, likes, collects, comments count, author. China's #1 lifestyle platform, 250M MAU. Cookie-based, $0.005/result.