For AI

Xiaohongshu (RedNote) API: notes, comments, creators

30 Xiaohongshu endpoints covering notes, accounts, hot lists, images, comments, topics, keywords, videos, PGY and shop, from $0.02 a call. No Xiaohongshu account or cookie needed.

Start free Try note search
Connect your AI

Paste this into your agent

Read https://okdata.online/agents.md and set up okdata for me; my key is in the OKDATA_API_KEY environment variable.

Claude Code, Cursor, Codex and other agents that can open a link set themselves up from it.

MCP serverhttps://api.okdata.online/mcp

Ask about Xiaohongshu from Claude, Cursor and other agents: the Xiaohongshu MCP page

Endpoints
30 endpoints
In 10 groups, one response format
Lowest price
From $0.02
A call, paid from a prepaid balance
Freshness
Live
Boards are a shared snapshot up to 10 minutes old
Monthly fee
$0
No subscription or minimum spend

Every Xiaohongshu endpoint

One row per endpoint: the request, what comes back and what one call costs.

Notes

3

Accounts

3

Images

1

Comments

1

Topics

2

Keywords

1

Videos

1

Prices are per call unless marked /item. A call that reached the data source is charged even when it comes back empty or fails.

What people do with Xiaohongshu data

Each job has its own page with the endpoints it takes, a worked run and its cost.

Start in three steps

The example is Xiaohongshu note search; every Xiaohongshu endpoint is called the same way and answers in the same shape.

  1. Get a key

    Create an account and a key in the console. A new key comes with $0.10 to try, no card.

    Open the console

  2. Connect your AI, or call it yourself

    Paste this sentence into Claude Code, Cursor, Codex or another agent that can open a link, and it sets itself up. Or send the request below with your key in the Authorization header.

    Set up okdata for me by following https://okdata.online/agents.md. Here is my okdata API key: okd_…. Keep it safe and use it for all okdata calls.

    Swap the placeholder for your own key, or sign in and copy it with the key filled in.

  3. Make the first call

    Items arrive in data.items (one object in data.item), the next page in page.next_cursor and what you were charged in meta.billing.amount.

    cURL

    curl -G "https://api.okdata.online/v1/xiaohongshu/notes/search" \
      -H "Authorization: Bearer $OKDATA_API_KEY" \
      --data-urlencode 'query=防晒霜 推荐'

    Python

    import os
    import requests
    
    resp = requests.get(
        "https://api.okdata.online/v1/xiaohongshu/notes/search",
        headers={"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"},
        params={"query": "防晒霜 推荐"},
        timeout=60,
    )
    body = resp.json()
    if body["code"] != "ok":
        raise RuntimeError(f"{body['code']}: {body['message']} (charged: {body['charged']})")
    
    for row in body["data"]["items"]:
        print(row["id"], row["metrics"]["likes"], row["text"][:60])
    print("cost: $" + body["meta"]["billing"]["amount"])

    TypeScript

    const url = new URL('https://api.okdata.online/v1/xiaohongshu/notes/search');
    url.searchParams.set('query', "防晒霜 推荐");
    
    const res = await fetch(url, {
      headers: {
        Authorization: `Bearer ${process.env.OKDATA_API_KEY}`,
      },
    });
    const body = await res.json();
    if (body.code !== 'ok') throw new Error(`${body.code}: ${body.message}`);
    
    for (const row of body.data.items) {
      console.log(row.id, row.metrics.likes, row.text.slice(0, 60));
    }
    console.log('cost: $' + body.meta.billing.amount);

    MCPtools/call

    {
      "name": "call",
      "arguments": {
        "capability": "xiaohongshu.notes.search",
        "query": "防晒霜 推荐"
      }
    }

Questions about the Xiaohongshu API

What does the Xiaohongshu API cost?

Each of the 30 endpoints has its own price, from $0.02 to $0.04 a call; the cheapest is Xiaohongshu comment replies at $0.02. You pay per call from a prepaid balance, with no subscription. A call that reaches the data source is charged even when it comes back empty, not found or failed; one stopped before that, such as for bad parameters, is free.

Do I need a Xiaohongshu account or cookie?

No. You call https://api.okdata.online with one okdata key and get public Xiaohongshu data back; no Xiaohongshu account, cookie or QR login is involved.

How fresh is the data?

Most endpoints read Xiaohongshu at the moment you call. Hot lists come from a shared snapshot that is at most 10 minutes old.

Can my AI agent use the Xiaohongshu API?

Yes. Connect the MCP server at https://api.okdata.online/mcp: its find tool lists these 30 endpoints with their prices, and its call tool runs them on your key.

Can I try it for free?

New accounts get $0.10 of trial credit with no card: enough for 5 calls to Xiaohongshu comment replies.

Connect once, then just ask.

Every new key comes with $0.10 to try it. One sentence connects your agent.

Start free
Connect your AI

Paste this into your agent

Read https://okdata.online/agents.md and set up okdata for me; my key is in the OKDATA_API_KEY environment variable.

Claude Code, Cursor, Codex and other agents that can open a link set themselves up from it.

MCP serverhttps://api.okdata.online/mcp