Pricing

from $4.99 / 1,000 dataset items

Try for free

Go to Apify Store

小红书数据 API | SocialDataX Xiaohongshu XHS RedNote

Try for free

社媒数据助手 SocialDataX 提供只读小红书 / Xiaohongshu / XHS / RedNote data API，支持笔记搜索 / note search、评论 / comments、笔记详情 / note details、博主作品列表 / creator posts（creator notes）、博主信息 / creator profiles、评论回复 / comment replies 和搜索热榜 / search hot list。结果可导出 Apify Dataset、CSV、Excel；无需配置 SocialDataX API Key。

Pricing

from $4.99 / 1,000 dataset items

Rating

5.0

(1)

Developer

SocialDataX

Actor stats

Bookmarked

747

Total users

158

Monthly active users

3 days ago

Last modified

Categories

Social media

Automation

Developer tools

You can access the 小红书数据 API | SocialDataX Xiaohongshu XHS RedNote 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": "ctWIsiWFd0YirYuCL"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/socialdatax~socialdatax-xhs-data-api/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-socialdatax-socialdatax-xhs-data-api",
        "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/socialdatax~socialdatax-xhs-data-api/runs": {
      "post": {
        "operationId": "runs-sync-socialdatax-socialdatax-xhs-data-api",
        "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/socialdatax~socialdatax-xhs-data-api/run-sync": {
      "post": {
        "operationId": "run-sync-socialdatax-socialdatax-xhs-data-api",
        "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": [
          "operation"
        ],
        "properties": {
          "operation": {
            "title": "操作 / Operation",
            "enum": [
              "search_notes",
              "get_note_comments",
              "get_note_detail",
              "list_user_notes",
              "get_user_info",
              "get_note_sub_comments",
              "search_hot_list"
            ],
            "type": "string",
            "description": "先选择要调用的小红书 / Xiaohongshu / XHS / RedNote 数据能力，然后只填写该 operation 需要的字段；无关字段会被忽略。持续使用需要 Apify paid plan；free plan 用户有 5 次 SocialDataX API request 试用额度。Choose the operation first, then fill only the fields used by that operation.",
            "default": "search_notes"
          },
          "keyword": {
            "title": "关键词 / Keyword",
            "type": "string",
            "description": "仅 operation=search_notes 时必填；其它 operation 可留空。",
            "default": "露营"
          },
          "sort_type": {
            "title": "排序 / Sort type",
            "enum": [
              "general",
              "default",
              "time_descending",
              "like_count_descending",
              "comment_count_descending",
              "collect_count_descending"
            ],
            "type": "string",
            "description": "operation=search_notes 时可选 general、time_descending、like_count_descending、comment_count_descending、collect_count_descending；operation=get_note_comments 时可选 default、time_descending、like_count_descending。其它 operation 会忽略该字段。",
            "default": "general"
          },
          "note_type": {
            "title": "笔记类型 / Note type",
            "enum": [
              "all",
              "image",
              "video"
            ],
            "type": "string",
            "description": "仅 operation=search_notes 时使用。",
            "default": "all"
          },
          "publish_time_range": {
            "title": "发布时间 / Publish time",
            "enum": [
              "all",
              "day",
              "week",
              "half_year"
            ],
            "type": "string",
            "description": "仅 operation=search_notes 时使用。",
            "default": "all"
          },
          "note_id": {
            "title": "笔记 ID / Note ID",
            "type": "string",
            "description": "operation=get_note_detail、get_note_comments、get_note_sub_comments 时使用；如果只有笔记链接、短链接或分享文案，请直接填 note_url。详情和评论列表至少提供 note_id 或 note_url 之一，同时提供时优先使用 note_url。误填到 note_id 时，Actor 会尽量自动识别笔记链接。评论回复必须使用 get_note_comments Dataset 行里的真实 note_id + comment_id，不支持链接或分享文案。"
          },
          "note_url": {
            "title": "笔记链接 / Note URL",
            "type": "string",
            "description": "operation=get_note_detail、get_note_comments 时至少提供 note_url 或 note_id 之一；同时提供时优先使用 note_url。推荐直接粘贴小红书笔记链接、短链接或分享文案。评论回复 get_note_sub_comments 不使用 note_url；请先运行 get_note_comments，再复制 Dataset 行里的真实 note_id + comment_id。"
          },
          "user_id": {
            "title": "用户 ID / User ID",
            "type": "string",
            "description": "operation=get_user_info、list_user_notes 时至少提供 user_id 或 profile_url 之一；同时提供时优先使用 profile_url。只填真实 user_id/author_user_id，不要填昵称、主页名称或小红书号；如果只有主页链接、短链接或分享文案，请直接填 profile_url。误填到 user_id 时，Actor 会尽量自动按 profile_url 处理。"
          },
          "profile_url": {
            "title": "主页链接 / Profile URL",
            "type": "string",
            "description": "operation=get_user_info、list_user_notes 时至少提供 profile_url 或 user_id 之一；同时提供时优先使用 profile_url。强烈推荐直接粘贴小红书主页链接、短链接或分享文案。"
          },
          "comment_id": {
            "title": "一级评论 ID / Comment ID",
            "type": "string",
            "description": "仅 operation=get_note_sub_comments 时必填。先运行 get_note_comments，在 Dataset 里找到 reply_count > 0 的一级评论行，复制该行的 comment_id；不要填评论内容、昵称或其它文本。"
          },
          "page_token": {
            "title": "分页令牌 / Page token",
            "type": "string",
            "description": "搜索、评论、评论回复、博主作品列表继续翻页时传入上一页返回的完整 next_page_token；第一页留空。auto_paginate=true 时通常不用手动填写。"
          },
          "max_items": {
            "title": "最大结果数 / Max items",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "最多写入多少条 Dataset item。对搜索、评论、评论回复、博主作品列表用于限制自动翻页结果；对搜索热榜用于限制本次导出的热榜条目数。较大的值可能触发多次 SocialDataX API request。",
            "default": 20
          },
          "auto_paginate": {
            "title": "自动翻页 / Auto paginate",
            "type": "boolean",
            "description": "开启后 Actor 会按 next_page_token 继续请求，直到达到 max_items 或没有下一页。关闭时只请求当前 page_token。每翻一页计 1 次 SocialDataX API request。When enabled, each page request counts as one SocialDataX API request.",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

小红书数据 API | Xiaohongshu search, comments, XHS RedNote 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 小红书数据 API | SocialDataX Xiaohongshu XHS RedNote 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:

小红书数据 API | SocialDataX Xiaohongshu XHS RedNote API in Python

小红书数据 API | SocialDataX Xiaohongshu XHS RedNote API in JavaScript

小红书数据 API | SocialDataX Xiaohongshu XHS RedNote API through CLI

小红书数据 API | SocialDataX Xiaohongshu XHS RedNote API

小红书 API | Xiaohongshu (XHS / RedNote) Pro Scraper

habit.zhou/xiaohongshu-pro-scraper

小红书 / Xiaohongshu / XHS / RedNote data API. Seven modes: keyword search, note details, comments, creator profile, topic feed, hot list, keyword suggestions. Returns likes, collects, comments, hashtags, images, location, time. No cookies or login. For SEO, market research, KOL discovery, AI datasets.

Seller Aim

392

5.0

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Ü

542

5.0

RedNote Xiaohongshu Scraper — Posts, Comments, Profiles, Video

zhorex/rednote-xiaohongshu-scraper

Scrape RedNote (Xiaohongshu) creator posts, note details, comment threads, profiles and video — six modes in one Actor. Creator posts and profiles need no login. Delta mode returns only what is NEW since the last run, so a daily brand monitor bills the new reviews and nothing else.

Sami

5.0

Xiaohongshu (RedNote) User Profile & Notes Scraper

zen-studio/rednote-user-profile-scraper

Extract any Xiaohongshu (RedNote) creator's full profile and every note they posted: nickname, bio, follower counts, IP city, verification, plus per-note likes, collects, comments, images and video URLs. Paste profile URLs or user IDs. 68 profile fields, export to JSON, CSV, or Excel.

Zen Studio

443

Xiaohongshu Comments Scraper - Reply Threads (RedNote)

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

3.6K

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

zen-studio/rednote-search-scraper

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.

Zen Studio

2.9K

3.1

RedNote (Xiaohongshu) Note Detail Scraper - 500 Notes/60s

zen-studio/rednote-note-detail-scraper

Get the full detail of any Xiaohongshu (RedNote) note from one link: title, description, images, video stream URLs, like, collect, comment and share counts, author profile, tags, and location. Optionally download the MP4, cover, and gallery images to your storage. Export to JSON, CSV, or Excel.

Zen Studio

704

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

1.1K

1.5

RedNote(Xiaohongshu) Search Scraper

datapilot/rednote-xiaohongshu-search-scraper

Just provide the keyword. Post title, description, author details, images — all data will be collected and stored directly in your Apify dataset. Works with residential proxies for reliable and stable scraping. Fast, accurate, and simple — optimized for keyword-based data extraction from Facebook.

Data Pilot

1.0

Pinterest Scraper Pins·Boards·Profiles·Ideas·Comments·Products

memo23/pinterest-scraper

[Only $1.45💰] Pinterest Scraper — pull pins, boards, profiles, search results and ideas hubs in one actor. Get images, video, descriptions, links, engagement, creator and board info, comments, plus product/price fields and optional sentiment + category tags. JSON/CSV, no login, usage-based pricing.