# 如何按关键词搜索并导出小红书笔记

用 2 个接口：小红书笔记搜索 → 小红书笔记详情。下面的示例一共 13 次调用，合计 $0.26；失败的调用不收费。

按关键词一页页搜小红书笔记，再按编号取完整正文和话题标签。最后得到一张笔记表：标题、正文、作者、点赞收藏评论分享数、图片。

## 一步一步做

### 第 1 步：小红书笔记搜索

按搜索词取一页笔记，`sort` 选综合、最新或最热。要更多，就把 `page.next_cursor` 作为 `cursor` 接着翻。这里的 `text` 只是搜索卡片上的摘录，标题也去掉了表情；每条的 `id` 拿去下一步取全文。（[小红书笔记搜索](https://dataxapi.com/zh/apis/xiaohongshu/notes/search/)，$0.0200 / 一次）

cURL

```bash
curl -G "https://api.dataxapi.com/v1/xiaohongshu/notes/search" \
  --data-urlencode "query=咖啡" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"
```

Python

```python
from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.xiaohongshu.notes.search(query="咖啡")
print(result["data"]["items"])
```

TypeScript

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

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.xiaohongshu.notes.search({ query: "咖啡" });
console.log(result.data.items);
```

命令行

```bash
dataxapi call xiaohongshu.notes.search 'query=咖啡'
```

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

```jsonc
{
  "code": "ok",
  "request_id": "d2403177-e4f6-4d04-99eb-afce599b4c31",
  "data": {
    "items": [
      {
        "id": "67d5e2be00000000d803d22d",
        "url": "https://www.xiaohongshu.com/explore/67d5e2be00000000d803d22d",
        "type": "image",
        "title": "实测一个月咖啡，结论有点意外",
        "text": "把咖啡从头到尾讲清楚，看完少走弯路",
        "published_at": "2026-05-17T05:25:25.000Z",
        "author": {
          "id": "6130783200000000883b2a1e",
          "username": "coffee_lab_sh",
          "name": "山野咖啡馆",
          "avatar_url": "https://sns-avatar-qc.xhscdn.com/avatar/610f17040000000049dd4887.jpg",
          "verified": false
        },
        "metrics": {
          "likes": 48,
          "comments": 21,
          "shares": 5,
          "favorites": 10
        },
        "images": [
          "https://sns-webpic-qc.xhscdn.com/20261010/2d7c7c32da67d3c3d839!nd_dft_wlteh_webp_3"
        ]
      },
      // … 另有 14 条
    ]
  },
  "page": {
    "next_cursor": "c1.Ip12-f4dS4HmSDpdPex7WuLPBr1zJAbdhL_Wj8K0",
    "cursor_expires_at": "2026-10-12T19:43:26.000Z",
    "has_more": true,
    "returned": 15
  },
  "warnings": [],
  "meta": {
    "capability": "xiaohongshu.notes.search",
    "result_status": "complete",
    "fetched_at": "2026-10-12T18:43:26.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "lang": "capability",
      "metrics.views": "platform",
      "metrics.reposts": "platform",
      "author.followers": "capability",
      "hashtags": "capability",
      "mentions": "capability",
      "is_pinned": "capability",
      "post_id": "platform",
      "parent_id": "platform",
      "root_id": "platform"
    },
    "billing": {
      "amount": "0.02",
      "currency": "USD",
      "balance_after": "9.98"
    }
  }
}
```

### 第 2 步：小红书笔记详情

把笔记编号放进 `id`（也可以传笔记的网页长链接 `url`），返回完整正文、话题标签 `hashtags`、提到的账号 `mentions` 和图片 `images`。（[小红书笔记详情](https://dataxapi.com/zh/apis/xiaohongshu/notes/get/)，$0.0200 / 一次）

cURL

```bash
curl -G "https://api.dataxapi.com/v1/xiaohongshu/notes/get" \
  --data-urlencode "id=6ac76250000000000a021233" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"
```

Python

```python
from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.xiaohongshu.notes.get(id="6ac76250000000000a021233")
print(result["data"]["item"])
```

TypeScript

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

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.xiaohongshu.notes.get({ id: "6ac76250000000000a021233" });
console.log(result.data.item);
```

命令行

```bash
dataxapi call xiaohongshu.notes.get id=6ac76250000000000a021233
```

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

```jsonc
{
  "code": "ok",
  "request_id": "f71a940b-5096-4ae5-8062-eb8542c0840d",
  "data": {
    "item": {
      "id": "64e3473100000000d2df6d97",
      "url": "https://www.xiaohongshu.com/explore/64e3473100000000d2df6d97",
      "type": "image",
      "title": "周末露营装备清单，新手照着买就行",
      "text": "周末露营｜第一次尝试就爱上了，清单放评论区",
      "lang": "zh-Hans",
      "published_at": "2026-10-09T01:00:34.000Z",
      "author": {
        "id": "61a2711e000000007b58eefa",
        "username": "aya_living",
        "name": "认真生活的阿雅",
        "avatar_url": "https://sns-avatar-qc.xhscdn.com/avatar/61177eaf00000000f2be6e0c.jpg"
      },
      "metrics": {
        "likes": 927,
        "comments": 122,
        "shares": 256,
        "favorites": 59
      },
      "images": [
        "https://sns-webpic-qc.xhscdn.com/20261013/beb7fc7264c0ffc27302!nd_dft_wlteh_webp_3",
        "https://sns-webpic-qc.xhscdn.com/20261012/355cf1169dfdc76d1395!nd_dft_wlteh_webp_3",
        // … 另有 7 条
      ],
      "hashtags": [
        "户外生活",
        "好物分享",
        // … 另有 3 条
      ],
      "mentions": [],
      "is_pinned": false
    }
  },
  "warnings": [],
  "meta": {
    "capability": "xiaohongshu.notes.get",
    "result_status": "complete",
    "fetched_at": "2026-10-10T12:46:15.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "metrics.views": "platform",
      "metrics.reposts": "platform",
      "author.verified": "capability",
      "author.followers": "capability",
      "mentions.username": "platform",
      "post_id": "platform",
      "parent_id": "platform",
      "root_id": "platform"
    },
    "billing": {
      "amount": "0.02",
      "currency": "USD",
      "balance_after": "9.98"
    }
  }
}
```

## 示例花多少钱

翻 3 页搜索结果，再取其中 10 篇笔记的完整内容

| 接口 | 调用次数 | 单价 | 小计 |
| --- | --- | --- | --- |
| [小红书笔记搜索](https://dataxapi.com/zh/apis/xiaohongshu/notes/search/) | 3 | $0.0200 | $0.0600 |
| [小红书笔记详情](https://dataxapi.com/zh/apis/xiaohongshu/notes/get/) | 10 | $0.0200 | $0.20 |
| 合计 | 13 |  | $0.26 |

价格是生成本页时的现行价格。失败的调用、不存在的对象都不收费。

## 在 AI 里做（MCP）

把 DataXAPI 接进你的 AI 客户端，只要接一次。之后直接说要什么，代理自己找到这些接口、看好价格，用你的余额调用。

这样说：在小红书搜“咖啡”，翻 3 页，再取前 10 篇笔记的完整正文和话题标签，整理成一张表。

代理发给 call 工具的参数：

```json
{
  "capability": "xiaohongshu.notes.search",
  "query": "咖啡",
  "idempotency_key": "<a new UUID>"
}
```

[了解 MCP 服务](https://dataxapi.com/zh/mcp/)

## 用 Skill 做

“关键词搜索与提及”这个 Skill 把这件事做成了现成的任务，带花费上限。 “这个品牌或关键词，各平台上在说什么？” 它的示例运行：3 次调用，最多 $0.0240。 [关键词搜索与提及](https://dataxapi.com/zh/skills/mentions/)

## 要知道的

- 搜索一页最多 20 条。平台夹在结果里的广告不是笔记，会被去掉，所以一页可能不满 20 条。`page.next_cursor` 一小时内有效。
- 搜索结果里没有作者粉丝数和话题标签；两个接口都没有浏览数（`metrics.views`），这类字段写在 `meta.unavailable` 里。
- 笔记详情只收笔记编号或网页长链接，短链接和分享口令不收。笔记不存在时返回“不存在”，不扣费；搜索没有结果也照常扣费。
- 用命令行导出最省事：`dataxapi call` 加 `--pages` 连翻几页（每页单独计费，`--max-spend` 限定总花费），加 `--out` 把结果写成 JSON 文件。

## 用到的接口

- [小红书笔记搜索](https://dataxapi.com/zh/apis/xiaohongshu/notes/search/)
- [小红书笔记详情](https://dataxapi.com/zh/apis/xiaohongshu/notes/get/)

## 小红书的更多内容

- [小红书 API](https://dataxapi.com/zh/apis/xiaohongshu/)
- [如何批量获取小红书笔记评论](https://dataxapi.com/zh/guides/xiaohongshu-note-comments/)
- [如何查小红书蒲公英博主报价和粉丝画像](https://dataxapi.com/zh/guides/xiaohongshu-pgy-creator-rates/)
- [小红书数据怎么导出？](https://dataxapi.com/zh/answers/export-xiaohongshu-data/)
- [ChatGPT 能读小红书吗？](https://dataxapi.com/zh/answers/can-chatgpt-read-xiaohongshu/)

---

目录修订号 c48ce454ae6c4c65。 [网页版](https://dataxapi.com/zh/guides/xiaohongshu-search-export-notes/)