Endpoint Playground

Try the Xiaohongshu public note detail API

Returns one public Xiaohongshu note normalized from the site's server-rendered page state: note id, type, title, description text (including hashtags), topic tags, image URLs, an optional stable video URL with duration, publish time, author card, and public interaction counters. Pass url with the note_url returned by /xiaohongshu/explore. The URL must be an xiaohongshu.com /explore/<id> or /discovery/item/<id> link carrying its xsec_token; a note id alone is not accessible anonymously, and a stale token returns not-found, so re-run /xiaohongshu/explore to mint a fresh one. Comments are not included because the anonymous page state does not carry them.

What a live request returned

30 Oct 2026: Single record response; 15 fields had a value in every checked item.

Observed request: GET /xiaohongshu/note?url=https%3A%2F%2Fwww.xiaohongshu.com%2Fexplore%2F6ac3f32e00000000180102b7%3Fxsec_token%3DABFiXJxtUcnIagsQE3zt9huzdd6A4s6MVGR7FnBjf_ZU8%3D%26xsec_source%3Dpc_feed
Fields with a value in every checked item: note_id, url, type, title, description, tags, image_urls, published_at

Sample value profiles: published_at: 2026-10-05; stats.liked_count: 48,000; type: “normal”.

Request: GET /xiaohongshu/note
Cost: 3 credits/request
Auth: apiKey

Xiaohongshu public note detail API documentation Xiaohongshu platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/xiaohongshu/note' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Description
url	string	No	Note URL carrying xsec_token, normally the note_url returned by /xiaohongshu/explore. Pass url, or both note_id and xsec_token.
note_id	string	No	24-character hex note id from an explore card (requires xsec_token)
xsec_token	string	No	Short-lived feed-issued token that accompanies note_id

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "note_id": "0123456789abcdef01234567",
    "url": "https://www.xiaohongshu.com/explore/0123456789abcdef01234567?xsec_token=SYNTHETIC-EXAMPLE-TOKEN-0001&xsec_source=pc_feed",
    "type": "video",
    "title": "Synthetic example note",
    "description": "Synthetic example description text #synthetic",
    "tags": [
      {
        "id": "00000000",
        "name": "synthetic_tag"
      }
    ],
    "image_urls": [
      "https://sns-img.example.test/synthetic-cover.jpg"
    ],
    "video_url": "https://sns-video.example.test/synthetic-video.mp4",
    "video_duration_seconds": 12,
    "published_at": "2026-09-22T04:03:46Z",
    "author": {
      "user_id": "000000000000000000000002",
      "nickname": "synthetic_user",
      "avatar_url": "https://sns-avatar.example.test/synthetic-avatar.jpg"
    },
    "stats": {
      "liked_count": 42,
      "collected_count": 7,
      "comment_count": 3,
      "share_count": 1
    }
  }
}

More Xiaohongshu endpoints

Anonymous Xiaohongshu explore/channel feed

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestxiaohongshu.noteResponseDocXiaohongshu

GET /xiaohongshu/note

Anonymous Xiaohongshu note detail

Response behavior

- `note_id` and `url` are the requested note's canonical identity; `url` is rebuilt on the canonical explore path with the supplied token. - `type` is the upstream note media type, such as `normal` (image note) or `video`. `image_urls` holds the note's public image URLs; `video_url` and `video_duration_seconds` are present only when the note carries a playable video stream. - `description` is the note's public text including its inline hashtags; `tags` holds the resolved topic tags with their ids and names when the page carries them. - `published_at` is RFC 3339 in UTC. `stats` holds integer `liked_count`, `collected_count`, `comment_count`, and `share_count`; upstream abbreviates large values in Chinese units (for example `1.4万`) and they are normalized to integers here. - `author` is a public card only (`user_id`, `nickname`, `avatar_url`). No account, contact, or private field is returned. - A malformed URL, a non-Xiaohongshu host, an unsupported note path, a missing or malformed `xsec_token`, or an invalid note id is rejected with `400` before any upstream request. A removed note or a stale token is `404`. A login or risk-control gate (HTTP 200 challenge page, redirect to `/login`, HTTP 461, or HTTP 403/406/429) is reported as an upstream `503`.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "note_id": "0123456789abcdef01234567",
    "url": "https://www.xiaohongshu.com/explore/0123456789abcdef01234567?xsec_token=SYNTHETIC-EXAMPLE-TOKEN-0001&xsec_source=pc_feed",
    "type": "video",
    "title": "Synthetic example note",
    "description": "Synthetic example description text #synthetic",
    "tags": [
      {
        "id": "00000000",
        "name": "synthetic_tag"
      }
    ],
    "image_urls": [
      "https://sns-img.example.test/synthetic-cover.jpg"
    ],
    "video_url": "https://sns-video.example.test/synthetic-video.mp4",
    "video_duration_seconds": 12,
    "published_at": "2026-09-22T04:03:46Z",
    "author": {
      "user_id": "000000000000000000000002",
      "nickname": "synthetic_user",
      "avatar_url": "https://sns-avatar.example.test/synthetic-avatar.jpg"
    },
    "stats": {
      "liked_count": 42,
      "collected_count": 7,
      "comment_count": 3,
      "share_count": 1
    }
  }
}

Try the Xiaohongshu public note detail API

What a live request returned

30 Oct 2026: Single record response; 15 fields had a value in every checked item.

Observed request: GET /xiaohongshu/note?url=https%3A%2F%2Fwww.xiaohongshu.com%2Fexplore%2F6ac3f32e00000000180102b7%3Fxsec_token%3DABFiXJxtUcnIagsQE3zt9huzdd6A4s6MVGR7FnBjf_ZU8%3D%26xsec_source%3Dpc_feed
Fields with a value in every checked item: note_id, url, type, title, description, tags, image_urls, published_at

Sample value profiles: published_at: 2026-10-05; stats.liked_count: 48,000; type: “normal”.

Request: GET /xiaohongshu/note
Cost: 3 credits/request
Auth: apiKey

Xiaohongshu public note detail API documentation Xiaohongshu platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/xiaohongshu/note' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Description
url	string	No	Note URL carrying xsec_token, normally the note_url returned by /xiaohongshu/explore. Pass url, or both note_id and xsec_token.
note_id	string	No	24-character hex note id from an explore card (requires xsec_token)
xsec_token	string	No	Short-lived feed-issued token that accompanies note_id

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "note_id": "0123456789abcdef01234567",
    "url": "https://www.xiaohongshu.com/explore/0123456789abcdef01234567?xsec_token=SYNTHETIC-EXAMPLE-TOKEN-0001&xsec_source=pc_feed",
    "type": "video",
    "title": "Synthetic example note",
    "description": "Synthetic example description text #synthetic",
    "tags": [
      {
        "id": "00000000",
        "name": "synthetic_tag"
      }
    ],
    "image_urls": [
      "https://sns-img.example.test/synthetic-cover.jpg"
    ],
    "video_url": "https://sns-video.example.test/synthetic-video.mp4",
    "video_duration_seconds": 12,
    "published_at": "2026-09-22T04:03:46Z",
    "author": {
      "user_id": "000000000000000000000002",
      "nickname": "synthetic_user",
      "avatar_url": "https://sns-avatar.example.test/synthetic-avatar.jpg"
    },
    "stats": {
      "liked_count": 42,
      "collected_count": 7,
      "comment_count": 3,
      "share_count": 1
    }
  }
}

Anonymous Xiaohongshu note detail

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "note_id": "0123456789abcdef01234567", "url": "https://www.xiaohongshu.com/explore/0123456789abcdef01234567?xsec_token=SYNTHETIC-EXAMPLE-TOKEN-0001&xsec_source=pc_feed", "type": "video", "title": "Synthetic example note", "description": "Synthetic example description text #synthetic", "tags": [ { "id": "00000000", "name": "synthetic_tag" } ], "image_urls": [ "https://sns-img.example.test/synthetic-cover.jpg" ], "video_url": "https://sns-video.example.test/synthetic-video.mp4", "video_duration_seconds": 12, "published_at": "2026-09-22T04:03:46Z", "author": { "user_id": "000000000000000000000002", "nickname": "synthetic_user", "avatar_url": "https://sns-avatar.example.test/synthetic-avatar.jpg" }, "stats": { "liked_count": 42, "collected_count": 7, "comment_count": 3, "share_count": 1 } } }