raw.xiaohongshu.user_notes_v3

Xiaohongshu (RedNote) user notes V3

LiveBeta

GEThttps://api.qovia.ai/v1/raw/xiaohongshu/user_notes_v3

Notes a user posted, returned as the platform answers them, in JSON: notes (title, interaction counts, cover and images), has_more, tags and more. Paging is supported: pass the cursor of the last note in notes back, and has_more tells whether there is more. Only an answer with data is charged; an empty answer or an error is not.

Typical uses: Vetting creators, monitoring accounts and benchmarking competitors' accounts.

Price: $0.02536 / call$25.36 per 1k · fixed price
Billing: Charged only for successful, non-empty resultsthe charge is in meta.charged_usd
Scope: raw:xiaohongshuThe API key needs this scope
Rate cap: Account limit onlyYour per-minute limit

Parameters

Sent as query parameters

Only these parameters are accepted; any other one returns 400.

user_idstringRequired

User ID (24 hex characters)

Pattern^[0-9a-f]{24}$

Example60014bac0000000001009be4

cursorstring

The cursor of the last note on the previous page (that note's id), passed back unchanged to get the next page; omit it for the first page

Pattern^[0-9a-f]{24}$

curl 'https://api.qovia.ai/v1/raw/xiaohongshu/user_notes_v3?user_id=60014bac0000000001009be4' \
  -H "Authorization: Bearer $QOVIA_KEY"

Replace $QOVIA_KEY with your API key

Example response200 OK

{
  "request_id": "00000000-0000-0000-0000-000000000000",
  "data": {
    "has_more": false,
    "notes": [
      {
        "advanced_widgets_groups": {
          "groups": [
            {
              "fetch_types": [
                "guos_test",
                "note_next_step"
              ],
              "mode": 1
            },
            {
              "fetch_types": [
                "guos_test",
                "vote_stickers"
              ],
              "mode": 0
            }
          ]
        },
        "ats": [],
        "collected_count": 2,
        "comments_count": 1,
        "create_time": 1778835624,
        "cursor": "6a06e0a8000000003502c562",
        "desc": "1️⃣如果你对股票的下跌感到恐惧，说明你买了你不了解的公司。\n\t\n2️⃣我所有的研究，都是在努力降低自己交易的频次。更多的研究，只为了更少的频次。\n\t\n3️⃣强势文化是自己做自己命运的主人，弱势文化是",
        "display_title": "投资教会我的事",
        "guide_context": "{\"show_goods_c2c\":false}",
        "has_music": false,
        "id": "6a06e0a8000000003502c562",
        "images_list": [
          {
            "fileid": "1040g0083206d1fts5g6g5pardl325gikpaqrar8",
            "height": 1600,
            "original": "",
            "trace_id": "1040g0083206d1fts5g6g5pardl325gikpaqrar8",
            "url": "https://sns-i27-ae.rednotecdn.com/1040g0083206d1fts5g6g5pardl325gikpaqrar8?imageView2/2/w/576/format/webp/q/87%7CimageMogr2/strip&redImage/frame/0&ap=12&sc=USR_PRV&sign=0fd96e85b70215bf866cc95aca585ffb&t=6ae34b07",
            "url_size_large": "https://sns-i27-ae.rednotecdn.com/1040g0083206d1fts5g6g5pardl325gikpaqrar8?imageView2/2/w/1440/format/webp&ap=12&sc=USR_DTL&sign=0fd96e85b70215bf866cc95aca585ffb&t=6ae34b07",
            "width": 1200
          }
        ],
        "infavs": false,
        "inlikes": false,
        "is_goods_note": false,
        "last_update_time": 1793097362,
        "likes": 8,
        "nice_count": 0,
        "niced": false,
        "price": 0,
        "recommend": {
          "desc": "",
          "icon": "",
          "target_id": "",
          "target_name": "",
          "track_id": "",
          "type": ""
        },
        "share_count": 0,
        "sticky": true,
        "time_desc": "05-15",
        "title": "投资教会我的事",
        "type": "normal",
        "user": {
          "followed": false,
          "fstatus": "none",
          "images": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo322ahdedbn06g5pardl325giktld5t4g?imageView2/2/w/80/format/jpg",
          "nickname": "Sophia",
          "red_official_verify_type": 0,
          "userid": "655b6d46000000000802c254"
        },
        "view_count": 0,
        "widgets_context": "{\"flags\":{},\"author_id\":\"655b6d46000000000802c254\",\"author_name\":\"Sophia\"}"
      },
      {
        "advanced_widgets_groups": {
          "groups": [
            {
              "fetch_types": [
                "guos_test",
                "note_next_step"
              ],
              "mode": 1
            },
            {
              "fetch_types": [
                "guos_test",
                "vote_stickers"
              ],
              "mode": 0
            }
          ]
        },
        "ats": [],
        "collected_count": 14,
        "comments_count": 1,
        "create_time": 1757322466,
        "cursor": "68be9ce1000000001c0361fa",
        "desc": "自用 持续更新\n——————\n1.向上不露穷，向下不露富。\n\t\n2.如无必要，勿增实体，进一出一。\n\t\n3.杜绝和低认知者、负能量者、磁场混浊者交流交往交际，杜绝在互联网上无意义争吵，拉黑屏蔽即可，没",
        "display_title": "ISFP处世原则",
        "guide_context": "{\"show_goods_c2c\":false}",
        "has_music": false,
        "id": "68be9ce1000000001c0361fa",
        "images_list": [
          {
            "fileid": "1040g00831m5nq4464s6g5pardl325gikbqhfdf0",
            "height": 1600,
            "original": "",
            "trace_id": "1040g00831m5nq4464s6g5pardl325gikbqhfdf0",
            "url": "https://sns-i27-ae.rednotecdn.com/1040g00831m5nq4464s6g5pardl325gikbqhfdf0?imageView2/2/w/576/format/webp/q/87%7CimageMogr2/strip&redImage/frame/0&ap=12&sc=USR_PRV&sign=4bdce8e6a57165aad1806beb345d690c&t=6ae34b07",
            "url_size_large": "https://sns-i27-ae.rednotecdn.com/1040g00831m5nq4464s6g5pardl325gikbqhfdf0?imageView2/2/w/1440/format/webp&ap=12&sc=USR_DTL&sign=4bdce8e6a57165aad1806beb345d690c&t=6ae34b07",
            "width": 1200
          }
        ],
        "infavs": false,
        "inlikes": false,
        "is_goods_note": false,
        "last_update_time": 1764200306,
        "likes": 50,
        "nice_count": 0,
        "niced": false,
        "price": 0,
        "recommend": {
          "desc": "",
          "icon": "",
          "target_id": "",
          "target_name": "",
          "track_id": "",
          "type": ""
        },
        "share_count": 0,
        "sticky": true,
        "time_desc": "2025-09-08",
        "title": "ISFP处世原则",
        "type": "normal",
        "user": {
          "followed": false,
          "fstatus": "none",
          "images": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo322ahdedbn06g5pardl325giktld5t4g?imageView2/2/w/80/format/jpg",
          "nickname": "Sophia",
          "red_official_verify_type": 0,
          "userid": "655b6d46000000000802c254"
        },
        "view_count": 0,
        "widgets_context": "{\"flags\":{},\"author_id\":\"655b6d46000000000802c254\",\"author_name\":\"Sophia\"}"
      }
    ],
    "tags": []
  },
  "meta": {
    "billed": true,
    "charged_usd": "0.025360",
    "balance_usd": "9.974640",
    "empty": false
  }
}

Catalog sample, not live data

Response

A success is HTTP 200 with the shared envelope: request_id, data (this endpoint's data, see the example) and meta (the charge). An empty result is also 200, with meta.empty true, not charged, and data may be an empty structure or null.

The response envelope in detail

Errors

Errors this endpoint can return
code	HTTP	Billing	Description
`scope_denied`	403	Not charged	This API key lacks the scope the endpoint requires.
`endpoint_unavailable`	503	Not charged	The endpoint is not available right now (no data source connected yet, or no price configured); nothing ran.
`invalid_params`	400	Not charged	The parameters failed validation: a required one is missing, a type or format is wrong, an array has more items than allowed, an unknown one was sent, or the POST body is not a JSON object. An error in one parameter starts with its name (`item_id: …`); a missing or unknown parameter starts with `params: …`.
`rate_limited`Retryable	429	Not charged	Over the account's per-minute limit (sliding 60-second window); wait for `Retry-After`.
`too_many_unbilled`Retryable	429	Not charged	In the last 10 minutes at least 50 of your calls to data sources, and over 80% of them, came back empty, not found or rejected; slow down.
`insufficient_balance`	402	Not charged	The balance cannot pay for this call; top up first.
`upstream_busy`Retryable	503	Refunded	The data source is busy or cooling down; refunded. Retry after `Retry-After`.
`upstream_timeout`	504	Refunded	The data source timed out; refunded.
`upstream_error`	502 / 503	Refunded	The data source failed; refunded.
`upstream_rejected`	400	Refunded	The data source rejected these parameters (well-formed, but not accepted); refunded.
`not_found`	404	Refunded	The data source has no such item (deleted, or the ID does not exist); refunded.
`reservation_expired`	504	Refunded	The call took too long and was refunded automatically; no data is returned.

Any request can also fail authentication: 401 invalid_api_key, 403 account_disabled, 429 too_many_auth_failures.

Every error code

Call it from your browser

Needs an account with a balance; playground calls are billed like API calls.

Try in the playground Create an API key

Parameters

Response

Errors

More Xiaohongshu (RedNote) endpoints