小红书话题笔记 API

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

{
  "code": "ok",
  "request_id": "1aafc0fd-f19d-4ea1-9b99-3d2405affe1c",
  "data": {
    "items": [
      {
        "id": "640ab64d00000000ee506058",
        "url": "https://www.xiaohongshu.com/explore/640ab64d00000000ee506058",
        "type": "image",
        "title": "周末露营入门指南：一篇讲清楚",
        "text": "把周末露营从头到尾讲清楚，看完少走弯路",
        "published_at": "2024-12-10T02:42:21.000Z",
        "author": {
          "id": "6df8c4da00000000e9e94b3d",
          "name": "橘子汽水不加冰",
          "avatar_url": "https://sns-avatar-qc.xhscdn.com/avatar/69156b4200000000cb44be55.jpg"
        },
        "metrics": {
          "likes": 274,
          "comments": 13,
          "shares": 21,
          "favorites": 36
        },
        "images": [
          "https://sns-webpic-qc.xhscdn.com/20261015/f9dbfb648591a844a5e2!nd_dft_wlteh_webp_3",
          "https://sns-webpic-qc.xhscdn.com/20261013/c321232901170b8cfeb5!nd_dft_wlteh_webp_3",
          // … 另有 16 条
        ],
        "hashtags": [
          "户外生活",
          "好物分享",
          // … 另有 8 条
        ],
        "mentions": [
          { "id": "6505c820000000004a32c1e7", "name": "阿杰爱折腾" },
          { "id": "6a83014b0000000083fbf705", "name": "山野咖啡馆" },
          // … 另有 21 条
        ]
      },
      // … 另有 9 条
    ]
  },
  "page": {
    "next_cursor": null,
    "cursor_expires_at": null,
    "has_more": false,
    "returned": 10
  },
  "warnings": [],
  "meta": {
    "capability": "xiaohongshu.topics.notes.list",
    "result_status": "complete",
    "fetched_at": "2026-10-12T18:43:56.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "lang": "capability",
      "author.username": "capability",
      "author.verified": "capability",
      "author.followers": "capability",
      "metrics.views": "platform",
      "metrics.reposts": "platform",
      "mentions.username": "platform",
      "is_pinned": "capability",
      "post_id": "platform",
      "parent_id": "platform",
      "root_id": "platform"
    },
    "billing": {
      "amount": "0.02",
      "currency": "USD",
      "balance_after": "9.98"
    }
  }
}

取自 2026-10-12 18:43 UTC 录下的真实返回。名字、正文和编号是示例，链接也是，都不是录到的原文（页面不展示任何人的个人信息）；数字是原样。长列表做了截断。请求号、游标和余额是示意。

返回大小：标准档 30.4 KB（精简 12.3 KB，完整 30.4 KB）。

{
  "code": "ok",
  "request_id": "03c1296a-649a-46af-9bc7-37252a613305",
  "data": { "items": [] },
  "page": {
    "next_cursor": null,
    "cursor_expires_at": null,
    "has_more": false,
    "returned": 0
  },
  "warnings": [],
  "meta": {
    "capability": "xiaohongshu.topics.notes.list",
    "result_status": "empty",
    "fetched_at": "2026-10-12T18:44:38.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "lang": "capability",
      "author.username": "capability",
      "author.verified": "capability",
      "author.followers": "capability",
      "metrics.views": "platform",
      "metrics.reposts": "platform",
      "mentions.username": "platform",
      "is_pinned": "capability",
      "post_id": "platform",
      "parent_id": "platform",
      "root_id": "platform"
    },
    "billing": {
      "amount": "0.02",
      "currency": "USD",
      "balance_after": "9.98"
    }
  }
}

取自 2026-10-12 18:44 UTC 录下的真实返回。请求号和余额是示意。

返回大小：标准档 702 B（精简 702 B，完整 702 B）。

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

from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.xiaohongshu.topics.notes.list(id="5eb2e2ffbd997100014327bc")
print(result["data"]["items"])

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

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

dataxapi call xiaohongshu.topics.notes.list id=5eb2e2ffbd997100014327bc

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

把这段加进你的 MCP 客户端，然后让你的 AI 调用 xiaohongshu.topics.notes.list。