<p class="crumbs"><a href="/apis/">Data APIs</a> / <a href="/apis/xiaohongshu/">Xiaohongshu (RedNote)</a></p>

# Xiaohongshu note search API

Search notes by keyword, ordered by relevance, newest or most liked, within a time range.

| Item | Value |
| --- | --- |
| Endpoint | `GET https://api.feedmcp.com/v1/xiaohongshu/notes/search` |
| ID | `xiaohongshu.notes.search` |
| Price | **$0.02** / call |
| Returns | A page of Post objects |
| Auth | `Authorization: Bearer $FEEDMCP_API_KEY` |

## Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `keyword` | string | yes | Search keyword |
| `sort` | `general` / `latest` / `likes` | no | Order: general, latest or likes; default `general` |
| `type` | `any` / `video` / `image` | no | Note type: any, video or image; default `any` |
| `time` | `any` / `day` / `week` / `half_year` | no | Published within: any, day, week or half_year; default `any` |
| `cursor` | string | no | Pagination cursor. Leave it out for the first page; pass page.next_cursor for the next. Each page is billed on its own |

Every endpoint also takes `view=full` to include the platform's raw data as `raw`, at the same price.

## Returned fields

`data.items` is a list of Post objects, with the same fields on every platform:

| Field | Type | Description |
| --- | --- | --- |
| `id` | string | The platform ID, which the platform's detail endpoint takes: TikTok or Douyin video ID, YouTube video ID, Instagram or Threads code, X post ID, Telegram "channel/number", Reddit short ID, LinkedIn activity number, Pinterest pin number, Kuaishou 3x… video ID, WeChat Channels object ID, Zhihu answer, question or article ID, Xiaohongshu note ID, BV ID, Weibo ID or article ID |
| `platform` | string | Platform: tiktok, youtube, instagram, x, threads, telegram, reddit, linkedin, facebook, pinterest, xiaohongshu, douyin, kuaishou, wechat_mp, wechat_channels, weibo, zhihu or bilibili |
| `type` | string | video, note, article, post (Weibo, X, Threads, Telegram, Reddit, LinkedIn, Facebook, Pinterest, Instagram photos), question or answer (Zhihu) |
| `url` | string | Link to the original |
| `title` | string \| null | Title (YouTube, Reddit, Pinterest, Bilibili, Xiaohongshu and WeChat; for a Zhihu answer, its question; null elsewhere) |
| `text` | string \| null | Body text or caption |
| `created_at` | string \| null | Published at, ISO 8601, UTC |
| `author.id` | string \| null | Author ID; pass it straight to that platform's account endpoints |
| `author.name` | string \| null | Author name |
| `metrics.views` | number \| null | Views or plays (null when the platform hides it) |
| `metrics.likes` | number \| null | Likes (score on Reddit, total reactions on Facebook) |
| `metrics.comments` | number \| null | Comments |
| `metrics.shares` | number \| null | Shares or reposts (reposts on X) |
| `metrics.quotes` | number \| null | Quotes (X and Threads) |
| `metrics.reactions` | number \| null | Total reactions (Telegram only) |
| `metrics.answers` | number \| null | Answers (Zhihu questions only) |
| `metrics.upvote_ratio` | number \| null | Upvote ratio from 0 to 1 (Reddit only) |
| `metrics.repins` | number \| null | Repins (Pinterest only) |
| `metrics.favorites` | number \| null | Saves (bookmarks on X, saves on Pinterest) |
| `cover` | string \| null | Cover image URL |
| `duration_seconds` | number \| null | Video length in seconds |
| `tags` | string[] | Hashtags (the flair on Reddit) |
| `community` | string \| null | Subreddit (Reddit only) |
| `link` | string \| null | The page a pin links to (Pinterest only) |

## When you are charged

$0.02 per successful call, including an empty result (an empty search is still an answer). Bad parameters, platform errors and timeouts are free.

Each answer carries `meta.billing`: what this call cost and the balance left.

## Request

### cURL

```bash
curl "https://api.feedmcp.com/v1/xiaohongshu/notes/search?keyword=%E9%9C%B2%E8%90%A5" \
  -H "Authorization: Bearer $FEEDMCP_API_KEY"
```

### Python

```python
import os, requests

r = requests.get(
    "https://api.feedmcp.com/v1/xiaohongshu/notes/search",
    params={"keyword": "露营"},
    headers={"Authorization": f"Bearer {os.environ['FEEDMCP_API_KEY']}"},
    timeout=30,
)
print(r.json())
```

### JavaScript

```js
const res = await fetch("https://api.feedmcp.com/v1/xiaohongshu/notes/search?keyword=%E9%9C%B2%E8%90%A5", {
  headers: { Authorization: `Bearer ${process.env.FEEDMCP_API_KEY}` },
});
console.log(await res.json());
```

### MCP

From an AI with FeedMCP installed, the `call` tool:

```json
{
  "endpoint": "xiaohongshu.notes.search",
  "params": {
    "keyword": "露营"
  },
  "max_price": "0.02"
}
```

## Response

The data below is made up; the shape is the real one.

```json
{
  "code": "ok",
  "request_id": "req_7Qm2kXb9TzLp",
  "data": {
    "items": [
      {
        "id": "6752f0f6000000000700e501",
        "platform": "xiaohongshu",
        "type": "note",
        "url": "https://www.xiaohongshu.com/explore/6752f0f6000000000700e501",
        "title": "新手露营一定要带的 10 样东西 1",
        "text": "第一次露营踩过的坑都在这里了 #露营",
        "created_at": "2025-11-18T19:06:40.000Z",
        "author": {
          "id": "5ff0e6410000000001008400",
          "name": "小林去露营",
          "avatar": "https://sns-avatar.xhscdn.com/a.jpg"
        },
        "metrics": {
          "likes": 12000,
          "comments": 356,
          "favorites": 8034,
          "shares": 120
        },
        "cover": "https://sns-img.xhscdn.com/cover.jpg",
        "tags": [
          "露营"
        ]
      },
      {
        "id": "6752f0f6000000000700e502",
        "platform": "xiaohongshu",
        "type": "note",
        "url": "https://www.xiaohongshu.com/explore/6752f0f6000000000700e502",
        "title": "新手露营一定要带的 10 样东西 2",
        "text": "第一次露营踩过的坑都在这里了 #露营",
        "created_at": "2025-11-18T17:06:40.000Z",
        "author": {
          "id": "5ff0e6410000000001008400",
          "name": "小林去露营",
          "avatar": "https://sns-avatar.xhscdn.com/a.jpg"
        },
        "metrics": {
          "likes": 12000,
          "comments": 356,
          "favorites": 8034,
          "shares": 120
        },
        "cover": "https://sns-img.xhscdn.com/cover.jpg",
        "tags": [
          "露营"
        ]
      }
    ]
  },
  "page": {
    "next_cursor": "eyJjdXJzb3IiOjIwfQ",
    "has_more": true
  },
  "warnings": [],
  "meta": {
    "endpoint": "xiaohongshu.notes.search",
    "platform": "xiaohongshu",
    "fetched_at": "2026-11-19T08:00:00.000Z",
    "source": "FeedMCP",
    "catalog_revision": "d09a736bd39e8b3f",
    "billing": {
      "charged": true,
      "amount": "0.02",
      "currency": "USD",
      "balance": "9.98"
    }
  }
}
```

Errors are described in [Errors](/docs/errors/): each says whether you were charged (`charged`) and whether to retry (`retry`).

## Other Xiaohongshu (RedNote) endpoints

- [Xiaohongshu note](/apis/xiaohongshu/notes/get/)：$0.02
- [Xiaohongshu note comments](/apis/xiaohongshu/notes/comments/list/)：$0.02
- [Xiaohongshu creator profile](/apis/xiaohongshu/users/get/)：$0.02
- [Xiaohongshu creator notes](/apis/xiaohongshu/users/notes/list/)：$0.02
- [Xiaohongshu comment replies](/apis/xiaohongshu/notes/comments/replies/list/)：$0.02
- [Xiaohongshu account search](/apis/xiaohongshu/users/search/)：$0.02
- [PGY blogger search](/apis/xiaohongshu/pgy/creators/search/)：$0.04
- [PGY blogger profile](/apis/xiaohongshu/pgy/creators/get/)：$0.04
- [PGY blogger overview](/apis/xiaohongshu/pgy/creators/metrics/)：$0.04
- [PGY blogger note performance](/apis/xiaohongshu/pgy/creators/performance/)：$0.04
- [PGY blogger daily figures](/apis/xiaohongshu/pgy/creators/costs/history/)：$0.04
- [PGY blogger follower profile](/apis/xiaohongshu/pgy/creators/followers/get/)：$0.04
- [PGY blogger follower quality](/apis/xiaohongshu/pgy/creators/followers/metrics/)：$0.04
- [PGY blogger follower history](/apis/xiaohongshu/pgy/creators/followers/history/)：$0.04
- [PGY blogger notes](/apis/xiaohongshu/pgy/creators/notes/list/)：$0.04
- [PGY similar bloggers](/apis/xiaohongshu/pgy/creators/similar/list/)：$0.04
- [PGY note figures](/apis/xiaohongshu/pgy/notes/get/)：$0.04
- [PGY trending notes](/apis/xiaohongshu/pgy/notes/trending/)：$0.04
- [PGY keyword overview](/apis/xiaohongshu/pgy/keywords/metrics/)：$0.04
- [PGY keyword daily index](/apis/xiaohongshu/pgy/keywords/history/)：$0.04
- [PGY related keywords](/apis/xiaohongshu/pgy/keywords/related/)：$0.04

## Questions

### How much does the Xiaohongshu note search endpoint cost?

$0.02 per successful call, including an empty result (an empty search is still an answer). Bad parameters, platform errors and timeouts are free.

### Do I need a platform account?

No. Only public data is read.

### Where do I find the ID or link?

A note ID is the part after /explore/ in a note link; a share link (xhslink.com) works too.

### How do I get more items?

When the answer has `page.next_cursor`, pass it back as `cursor` for the next page. Each page is billed on its own.

### How do I use it from an AI?

Install the [MCP server](/mcp/) and ask; your AI calls `xiaohongshu.notes.search`.

---

HTML version: https://feedmcp.com/apis/xiaohongshu/notes/search/
