RedNote (Xiaohongshu) API

RedNote (Xiaohongshu) 搜索 API

按关键词搜索小红书笔记，返回带分页的标准化笔记记录。

免费开始下载示例或 JSON

US$10.00/千次请求，按请求付费，无需订阅。

Rmatcha latte - 小红书搜索
xiaohongshu.com/search_result?keyword=matcha%20latte
R小红书创作服务登录
综合笔记视频用户商品

iced matcha latte (starbucks copycat)

Sasha Delarosa9,800
0
0
0
0
API 返回的内容notes[0]
{
"noteId": "867bdca64aa3e4bb3af66f35",
"title": "iced matcha latte (starbucks copycat)",
"description": "3 ingredients only and it's so good, cheaper than the app too",
"type": "normal",
"image": "https://sns-webpic-qc.xhscdn.com/202609051130/aa21f0/1040g3k831hf7sasha1example!nd_dft_wlteh_webp_3",
"likeCount": 9800,
"commentCount": 210,
"collectCount": 3100,
... 还有 8 个字段
}
可用率
97.94%
30d · 3,110 次调用
请求数
3,112
30d · 按周，近 12 周
响应时间
2.5s
中位数 · 30d

价格与服务商

RedNote (Xiaohongshu) 搜索 API 价格：一个 API，2 个可互换的服务商

最便宜的服务商优先响应。如果它失败，下一个会在同一次调用中接手。

你需支付
US$100.00
US$10.00/千次请求，只为实际用量付费。没有月度套餐。
有了 US$0.10 的初始余额，你的前 10 次请求免费。

试一试

一个请求获取 RedNote (Xiaohongshu) 搜索

打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。

这个示例展示了 21 个字段中的 19 个。查看全部字段

{
  "found": true,
  "data": {
    "nextCursor": "eyJwYWdlIjoyfQ==",
    "notes": [
      {
        "noteId": "867bdca64aa3e4bb3af66f35",
        "title": "iced matcha latte (starbucks copycat)",
        "description": "3 ingredients only and it's so good, cheaper than the app too",
        "type": "normal",
        "image": "https://sns-webpic-qc.xhscdn.com/202609051130/aa21f0/1040g3k831hf7sasha1example!nd_dft_wlteh_webp_3",
        "likeCount": 9800,
        "commentCount": 210,
        "collectCount": 3100,
        "shareCount": 88,
        "authorUserId": "432b22370878795ef391fdf5",
        "authorNickname": "Sasha Delarosa",
        "authorImage": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo319sashaexample.jpg",
        "authorRedId": "sasha.kitchen",
        "xsecToken": "ABExampleXsecToken5678",
        "updatedUtc": 1788607200
      },
      {
        "noteId": "41152d687633c3ea495fa273",
        "title": "matcha oat milk latte, no strainer needed",
        "description": "the sieve trick that fixed my clumpy matcha forever",
        "type": "video",
        "image": "https://sns-webpic-qc.xhscdn.com/202609101640/bb32f1/1040g3k831hf8owen1example!nd_dft_wlteh_webp_3",
        "likeCount": 6200,
        "commentCount": 145,
        "collectCount": 1900,
        "shareCount": 54,
        "authorUserId": "57ee759b3ec4e21bd885d5b2",
        "authorNickname": "Owen Delacroix",
        "authorImage": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo319owenexample.jpg",
        "authorRedId": "owen.brews",
        "xsecToken": "ABExampleXsecToken9012",
        "updatedUtc": 1789058400
      },
      {
        "noteId": "0e25ba775ada0456ff9813ab",
        "title": "brown sugar matcha latte, layered like the cafe",
        "description": "the trick is letting the syrup set for a minute before you pour",
        "type": "normal",
        "image": "https://sns-webpic-qc.xhscdn.com/202609221830/cc43a2/1040g3k831hf9priya1example!nd_dft_wlteh_webp_3",
        "likeCount": 4100,
        "commentCount": 76,
        "collectCount": 980,
        "shareCount": 22,
        "authorUserId": "31e0b3cba67225f5d4b0ee78",
        "authorNickname": "Priya Nandakumar",
        "authorImage": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo319priyaexample.jpg",
        "authorRedId": "priya.tea",
        "xsecToken": "ABExampleXsecToken3456",
        "updatedUtc": 1790064900
      }
    ]
  }
}

完整的参数与响应参考：这个接口的每个字段、类型和示例。

参考

一个请求，一种响应结构。

你发送的每个字段和收到的每个字段，都附有真实示例。

最近验证于 2026-11-14 · 可用率和延迟按 30d 统计

请求体

JSON，POST 到这个接口。

  • querystring

    matcha latte

    要在小红书上搜索的关键词。

  • cursorstring

    来自上一次响应的分页游标。

  • sortenum

    general

    匹配笔记的排序方式。

你发送。 一个简短的 JSON 请求体。显示的值只是示例，请换成你自己的。

响应

JSON，每个字段一个示例值。

datadata

Wrapper holding the notes array plus pagination, or null when nothing was found.

  • nextCursorstring

    eyJwYWdlIjoyfQ==

    Opaque cursor for the next page of notes, or null when this lane has no more. Pass it back as cursor to continue.

each notedata.notes[]

Notes matching the search. Populated whenever the provider has data for the entity.

  • authorImagestring

    https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo319sashaexample.jpg

    URL of the author's avatar. Populated whenever the provider has data for the entity.

  • authorNicknamestring

    Sasha Delarosa

    Display name of the note author. Populated whenever the provider has data for the entity.

  • authorRedIdstring

    sasha.kitchen

    Author's public RedNote ID. Populated whenever the provider has data for the entity.

  • authorUserIdstring

    432b22370878795ef391fdf5

    Identifier of the note author. Populated whenever the provider has data for the entity.

  • collectCountinteger

    3100

    Number of times the note was collected.

  • commentCountinteger

    210

    Number of comments on the note.

  • createdUtcnumber

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • descriptionstring

    3 ingredients only and it's so good, cheaper than the app too

    Note body text. Populated whenever the provider has data for the entity.

  • imagestring

    https://sns-webpic-qc.xhscdn.com/202609051130/aa21f0/1040g3k831hf7sasha1example!nd_dft_wlteh_webp_3

    URL of the note cover image. Populated whenever the provider has data for the entity.

  • likeCountinteger

    9800

    Number of likes on the note.

  • noteIdstring

    867bdca64aa3e4bb3af66f35

    Note identifier. Populated whenever the provider has data for the entity.

  • shareCountinteger

    88

    Number of times the note was shared.

  • titlestring

    iced matcha latte (starbucks copycat)

    Note title. Populated whenever the provider has data for the entity.

  • typestring

    normal

    Note type, e.g. "normal" or "video". Populated whenever the provider has data for the entity.

  • updatedUtcnumber

    1788607200

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • xsecTokenstring

    ABExampleXsecToken5678

    Security token required to fetch the note's full detail. Populated whenever the provider has data for the entity.

top level
  • foundboolean

    true

    True when matching notes were found; false when the search returned nothing.

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

你收到。 字段有名称、有类型，无论哪个数据源响应，结构都一样。

常见问题

关于 RedNote (Xiaohongshu) 搜索 API

AnyAPI 的 RedNote (Xiaohongshu) 搜索 API 只需一次 POST 请求 /v1/run/rednote.search，就以统一格式的 JSON 返回 RedNote (Xiaohongshu) 数据。按关键词搜索小红书笔记，返回带分页的标准化笔记记录。AnyAPI 会在 2 个数据源之间路由每个请求，某个数据源失败时自动切换。费用：每千次请求 US$10 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 RedNote (Xiaohongshu) 搜索 API 调用中有 97.9% 成功，响应时间中位数为 2.5 秒，共测量 3,110 次调用。

费用：每千次请求 US$10 起，以美元计价，无需订阅，也没有每月最低消费。你只需为一个美元钱包充值，每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用，我们按成本原价转嫁，不加价；错误响应会显示收取的金额。

按关键词搜索小红书笔记，返回带分页的标准化笔记记录。响应是统一格式的 JSON，外层结构与每个 AnyAPI 接口相同，所以解析另一个接口只需换一个 URL，别的都不用改。

过去 30 天，通过 AnyAPI 发起的 RedNote (Xiaohongshu) 搜索 API 调用中有 97.9% 成功，响应时间中位数为 2.5 秒，共测量 3,110 次调用。这些是 AnyAPI 对经过网关的流量的自有测量，持续重新计算，并非公开承诺的服务等级目标。

可以。新的 AnyAPI 账户自带 US$0.10 免费余额，无需绑卡，足够调用 10 次 RedNote (Xiaohongshu) 搜索，每次 US$0.01。

AnyAPI 会在同一个请求中依次尝试它的 2 个数据源，从最便宜的开始，所以一个数据源宕机不会让你的调用失败。

向 https://api.getanyapi.com/v1/run/rednote.search 发送 POST 请求，在 “Authorization: Bearer” 请求头中放入你的 AnyAPI 密钥，并以 JSON 请求体传入参数。同一个密钥和同一个钱包适用于所有 AnyAPI 接口。

不需要。你向一个预付费的 AnyAPI 余额充值美元，每个请求从中扣费。没有月度套餐，也没有最低消费，同一个余额可用于所有 AnyAPI 接口。

有。TypeScript 用 npm 安装 @getanyapi/sdk，Python 用 pip 安装 getanyapi。两者都用同一个密钥调用所有 AnyAPI 接口，任何 HTTP 客户端也都可以。

可以。智能体可以连接 https://api.getanyapi.com/mcp 上的 AnyAPI MCP 服务器，或者向 https://api.getanyapi.com/agent/signup 发送一次无需认证的 POST 来创建自己的免费试用密钥，再通过 HTTP 调用这个接口。
更多接口

RedNote (Xiaohongshu) 的其他接口

笔记/千次请求 US$12.00 起笔记评论/千次请求 US$12.00 起主页/千次请求 US$10.00 起搜索用户/千次请求 US$12.00 起用户笔记/千次请求 US$10.00 起