Xiaohongshu (RedNote) user notes API

curl -G "https://api.dataxapi.com/v1/xiaohongshu/users/notes/list" \
  --data-urlencode "id=63bed214000000002702b862" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

{
  "code": "ok",
  "request_id": "207ddb09-2a0d-4ff5-8cd3-9ddce35b46a5",
  "data": {
    "items": [
      {
        "id": "676ed1bc00000000d870f54e",
        "type": "video",
        "title": "实测一个月周末露营，结论有点意外",
        "text": "周末的周末露营日常，随手记录一下",
        "published_at": "2026-10-12T01:00:27.000Z",
        "author": {
          "id": "6998fff50000000046ca2f74",
          "name": "南边的风",
          "avatar_url": "https://sns-avatar-qc.xhscdn.com/avatar/6412ba1a00000000ff300cc2.jpg"
        },
        "metrics": {
          "likes": 8,
          "comments": 0,
          "shares": 0,
          "favorites": 2
        },
        "images": [
          "https://sns-webpic-qc.xhscdn.com/20261019/e38ec1fd03381eaef493!nd_dft_wlteh_webp_3"
        ],
        "mentions": [],
        "is_pinned": false
      },
      // … 19 more
    ]
  },
  "page": {
    "next_cursor": "c1.LwegQikqZdn9JGQkwTrpD-r4Bc3_yNoolTMdaIit",
    "cursor_expires_at": "2026-10-12T20:13:48.000Z",
    "has_more": true,
    "returned": 20
  },
  "warnings": [],
  "meta": {
    "capability": "xiaohongshu.users.notes.list",
    "result_status": "complete",
    "fetched_at": "2026-10-12T19:13:48.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "url": "capability",
      "lang": "capability",
      "author.username": "capability",
      "author.verified": "capability",
      "author.followers": "capability",
      "metrics.views": "platform",
      "metrics.reposts": "platform",
      "hashtags": "capability",
      "mentions.username": "platform",
      "post_id": "platform",
      "parent_id": "platform",
      "root_id": "platform"
    },
    "billing": {
      "amount": "0.02",
      "currency": "USD",
      "balance_after": "9.98"
    }
  }
}

From a response recorded 2026-10-12 19:13 UTC. Names, text and IDs are examples, and so are the links: none is the recorded one (the page shows no one's personal data); the figures are as recorded. Long lists are cut. The request ID, cursor and balance are made up.

Size as sent: 19.6 KB in the standard view (11.8 KB compact, 19.6 KB full).

{
  "code": "ok",
  "request_id": "7f88b9ae-c4d7-400e-8a67-85b6e5a5b8c8",
  "data": { "items": [] },
  "page": {
    "next_cursor": null,
    "cursor_expires_at": null,
    "has_more": false,
    "returned": 0
  },
  "warnings": [],
  "meta": {
    "capability": "xiaohongshu.users.notes.list",
    "result_status": "empty",
    "fetched_at": "2026-10-12T19:13:48.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "url": "capability",
      "lang": "capability",
      "author.username": "capability",
      "author.verified": "capability",
      "author.followers": "capability",
      "metrics.views": "platform",
      "metrics.reposts": "platform",
      "hashtags": "capability",
      "mentions.username": "platform",
      "post_id": "platform",
      "parent_id": "platform",
      "root_id": "platform"
    },
    "billing": {
      "amount": "0.02",
      "currency": "USD",
      "balance_after": "9.98"
    }
  }
}

From a recording of 2026-10-12 19:13 UTC, edited by hand to show this case. The request ID and balance are made up.

Size as sent: 719 B in the standard view (719 B compact, 719 B full).

curl -G "https://api.dataxapi.com/v1/xiaohongshu/users/notes/list" \
  --data-urlencode "id=63bed214000000002702b862" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.xiaohongshu.users.notes.list(id="63bed214000000002702b862")
print(result["data"]["items"])

import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.xiaohongshu.users.notes.list({ id: "63bed214000000002702b862" });
console.log(result.data.items);

dataxapi call xiaohongshu.users.notes.list id=63bed214000000002702b862

{
  "mcpServers": {
    "dataxapi": {
      "type": "http",
      "url": "https://api.dataxapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DATAXAPI_API_KEY}"
      }
    }
  }
}

Add this to your MCP client, then ask your agent to call xiaohongshu.users.notes.list.