RedNote (Xiaohongshu) API

RedNote (Xiaohongshu) Search API

Search RedNote (Xiaohongshu) notes by keyword and return normalized note records with pagination.

Start freeDownload sampleor JSON

$12.00/1k req, pay per request, no subscription.

What the API returnednotes[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 more fields
}
Uptime
99.87%
30d · 1,554 calls
Requests
1,554
30d · weekly, last 12 wks
Response
2.1s
median · 30d

Pricing

RedNote (Xiaohongshu) Search API pricing

You pay
$120.00
$12.00/1k req, only for what you use. No monthly plan.
Your first 8 requests are free with the $0.10 starting balance.

Try it

Get RedNote (Xiaohongshu) search in one request

Open in
Get a free key
Sample response
Free runs return only the first 3 results. Fund a key to get the full response.

This sample shows 19 of 21 fields. See every field

{
  "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
      }
    ]
  }
}

Full parameter and response reference - every field, type, and example for this endpoint.

Reference

One request, one response shape.

Every field you send and every field you get back, each with a real example.

Last verified 2026-10-31 · uptime and latency measured over 30d

Request body

JSON, posted to this endpoint.

  • querystring

    matcha latte

    Keyword to search for on RedNote (Xiaohongshu).

  • cursorstring

    Pagination cursor from the previous response.

  • sortenum

    general

    Sort order for matching notes.

You send. A small JSON body. The values shown are examples to replace with your own.

Response

JSON, one example value per field.

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.

You get back. Named, typed fields in the same shape whichever source answers.

FAQ

About the RedNote (Xiaohongshu) Search API

The AnyAPI RedNote (Xiaohongshu) Search API returns RedNote (Xiaohongshu) search data as normalized JSON from one POST call to /v1/run/rednote.search. Search RedNote (Xiaohongshu) notes by keyword and return normalized note records with pagination. AnyAPI returns one normalized schema whichever source serves it. It costs from $12 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 99.9% of RedNote (Xiaohongshu) search calls through AnyAPI succeeded, with a median response time of 2.1 seconds across 1,554 measured calls.

It costs from $12 per 1,000 requests, in US dollars with no subscription and no monthly minimum. You fund one USD wallet and each call draws it down. Some failed wallet-funded requests incur processing charges that we pass through at cost, with no markup; the error response shows the amount charged.

Search RedNote (Xiaohongshu) notes by keyword and return normalized note records with pagination. The response is normalized JSON with the same envelope every AnyAPI endpoint returns, so parsing a second endpoint is a change of URL and nothing else.

Over the last 30 days, 99.9% of RedNote (Xiaohongshu) search calls through AnyAPI succeeded, with a median response time of 2.1 seconds across 1,554 measured calls. These are AnyAPI's own measurements of traffic through the gateway, recomputed continuously, not a published service-level target.

Yes. A new AnyAPI account starts with $0.10 of free balance and no card required, which covers 8 RedNote (Xiaohongshu) Search calls at $0.012 each.

Send a POST request to https://api.getanyapi.com/v1/run/rednote.search with your AnyAPI key in an "Authorization: Bearer" header and the input as a JSON body. The same key and the same wallet work on every AnyAPI endpoint.

No. You add US dollars to one prepaid AnyAPI balance and each request draws it down. There is no monthly plan and no minimum, and the same balance pays for every AnyAPI endpoint.

Yes. Install @getanyapi/sdk from npm for TypeScript or getanyapi from pip for Python. Both call every AnyAPI endpoint with the same key, and any HTTP client works too.

Yes. An agent can connect to the AnyAPI MCP server at https://api.getanyapi.com/mcp, or create its own free-trial key with one unauthenticated POST to https://api.getanyapi.com/agent/signup and call this endpoint over HTTP.
More to call

Other RedNote (Xiaohongshu) endpoints

Notefrom $12.00 /1k reqNote commentsfrom $12.00 /1k reqProfilefrom $12.00 /1k reqSearch usersfrom $12.00 /1k reqUser notesfrom $12.00 /1k req