Skip to content

Xiaohongshu (RedNote) Note Comments API (V2) ​

GET
API health status
Healthy Available Limited Mostly unavailable No data
Loading health status...

Retrieves comments for a Xiaohongshu (RedNote) note with cursor pagination and normal, latest, or like-count sorting. Use it to support feedback review, discussion analysis, and comment moderation workflows.

Highlights ​

Guidance

We recommend using the latest sort by default. If comments cannot be retrieved for some notes with latest, try again using normal.

Parameters ​

NameInTypeRequiredDefaultDescription
tokenquerystringYes-Access token for this API service.
noteIdquerystringYes-A Xiaohongshu note ID or an explore URL containing /explore/.
lastCursorquerystringNo-Pagination cursor from the previous page (use the cursor value returned by the last response).
sortquerystringNolatestSort strategy for the result set.


Available Values:

- normal: Normal

- latest: Latest

- like_count: Like Count

Code Samples ​

bash
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/xiaohongshu/get-note-comment/v2?token=YOUR_API_KEY&noteId=VALUE'
text
I want to use the "Note Comments (V2)" API from JustOneAPI.
Base URL: https://api.justoneapi.com.
API Path: /api/xiaohongshu/get-note-comment/v2?token=YOUR_API_KEY&noteId=VALUE
API Endpoint: BASE_URL + /api/xiaohongshu/get-note-comment/v2?token=YOUR_API_KEY&noteId=VALUE
HTTP Method: GET
Authentication: Append the "token" query parameter to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/xiaohongshu-rednote/note-comments-v2-en.json

Parameters:
- token (query): Access token for this API service. (Required)
- noteId (query): A Xiaohongshu note ID or an explore URL containing /explore/. (Required)
- lastCursor (query): Pagination cursor from the previous page (use the cursor value returned by the last response).
- sort (query): Sort strategy for the result set.

Available Values:
- `normal`: Normal
- `latest`: Latest
- `like_count`: Like Count

Return format: safely handle JSON or text according to the actual Content-Type.

Response Handling & Error Codes:
1. Business results should be determined by the "code" field in the response body (code 0 means success).
2. Timeout Recommendation: Set the request timeout to 120 seconds. If 120 seconds is too long for your use case, use at least 60 seconds, but a small number of requests may time out before receiving a result.
3. Business Code Reference:
   - 0: Success
   - 100: Invalid or Inactive Token
   - 301: Collection Failed. Please Retry.
   - 302: Rate Limit Exceeded
   - 303: Daily Quota Exceeded
   - 400: Invalid Parameters
   - 500: Internal Server Error
   - 600: Permission Denied
   - 601: Insufficient Balance
   - 602: Token Budget Exceeded
4. Code 601 means the shared account balance is insufficient. Code 602 means the current API token's own cumulative budget limit has been reached. Token budget limits do not transfer funds out of the shared account balance.

Please help me write a script in my preferred programming language to call this API and handle the response.
python
import requests

BASE_URL = "https://api.justoneapi.com"  # Provided by OpenAPI servers

url = BASE_URL + "/api/xiaohongshu/get-note-comment/v2?token=YOUR_API_KEY&noteId=VALUE"
response = requests.get(url, timeout=120)
print(response.status_code)
if response.content:
    content_type = response.headers.get("content-type", "").lower()
    if "json" in content_type:
        try:
            print(response.json())
        except ValueError:
            print(response.text)
    elif content_type.startswith("text/") or "xml" in content_type or content_type.split(";", 1)[0].strip() in {"application/javascript", "application/x-www-form-urlencoded", "application/graphql"}:
        print(response.text)
    else:
        with open("response.bin", "wb") as output:
            output.write(response.content)
        print(f"Saved {len(response.content)} bytes to response.bin")
js
const BASE_URL = "https://api.justoneapi.com"; // Provided by OpenAPI servers
const url = BASE_URL + "/api/xiaohongshu/get-note-comment/v2?token=YOUR_API_KEY&noteId=VALUE";

const response = await fetch(url, {
  method: "GET",
  signal: AbortSignal.timeout(120000)
});
console.log(response.status);
const responseBytes = await response.arrayBuffer();
if (responseBytes.byteLength) {
  const contentType = (response.headers.get("content-type") || "").toLowerCase();
  const mediaType = contentType.split(";", 1)[0].trim();
  const textual = contentType.startsWith("text/") || contentType.includes("json") || contentType.includes("xml") || ["application/javascript", "application/x-www-form-urlencoded", "application/graphql"].includes(mediaType);
  if (textual) {
    const responseText = new TextDecoder().decode(responseBytes);
    let data = responseText;
    if (contentType.includes("json")) {
      try { data = JSON.parse(responseText); } catch { /* Keep the raw body. */ }
    }
    console.log(data);
  } else {
    console.log(`Received ${responseBytes.byteLength} binary bytes`);
  }
}
java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;

public class Main {
    public static void main(String[] args) throws Exception {
        final String BASE_URL = "https://api.justoneapi.com"; // Provided by OpenAPI servers
        final String url = BASE_URL + "/api/xiaohongshu/get-note-comment/v2?token=YOUR_API_KEY&noteId=VALUE";

        HttpClient client = HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(120)).build();
        HttpRequest.Builder builder = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .timeout(Duration.ofSeconds(120))
            .method("GET", HttpRequest.BodyPublishers.noBody());

        HttpRequest request = builder.build();

        HttpResponse<byte[]> response = client.send(request, HttpResponse.BodyHandlers.ofByteArray());
        System.out.println(response.statusCode());
        String contentType = response.headers().firstValue("content-type").orElse("").toLowerCase();
        String mediaType = contentType.split(";", 2)[0].trim();
        if (contentType.startsWith("text/") || contentType.contains("json") || contentType.contains("xml") || mediaType.equals("application/javascript") || mediaType.equals("application/x-www-form-urlencoded") || mediaType.equals("application/graphql")) {
            System.out.println(new String(response.body(), StandardCharsets.UTF_8));
        } else {
            Files.write(Path.of("response.bin"), response.body());
            System.out.println("Saved " + response.body().length + " bytes to response.bin");
        }
    }
}
go
package main

import (
	"fmt"
	"io"
	"os"
	"strings"
	"net/http"
	"time"
)

const BASE_URL = "https://api.justoneapi.com" // Provided by OpenAPI servers

func main() {
	client := &http.Client{Timeout: 120 * time.Second}
	url := BASE_URL + "/api/xiaohongshu/get-note-comment/v2?token=YOUR_API_KEY&noteId=VALUE"
	req, _ := http.NewRequest("GET", url, nil)
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	fmt.Println(resp.StatusCode)
	bodyBytes, _ := io.ReadAll(resp.Body)
	contentType := strings.ToLower(resp.Header.Get("Content-Type"))
	mediaType := strings.TrimSpace(strings.SplitN(contentType, ";", 2)[0])
	if strings.HasPrefix(contentType, "text/") || strings.Contains(contentType, "json") || strings.Contains(contentType, "xml") || mediaType == "application/javascript" || mediaType == "application/x-www-form-urlencoded" || mediaType == "application/graphql" {
		fmt.Println(string(bodyBytes))
	} else {
		os.WriteFile("response.bin", bodyBytes, 0600)
		fmt.Printf("Saved %d bytes to response.bin\n", len(bodyBytes))
	}
}
php
<?php
$BASE_URL = 'https://api.justoneapi.com'; // Provided by OpenAPI servers
$url = $BASE_URL . '/api/xiaohongshu/get-note-comment/v2?token=YOUR_API_KEY&noteId=VALUE';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 120);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$contentType = strtolower((string) curl_getinfo($ch, CURLINFO_CONTENT_TYPE));
curl_close($ch);
echo $status . PHP_EOL;
$mediaType = trim(explode(';', $contentType, 2)[0]);
if (str_starts_with($contentType, 'text/') || str_contains($contentType, 'json') || str_contains($contentType, 'xml') || in_array($mediaType, ['application/javascript', 'application/x-www-form-urlencoded', 'application/graphql'], true)) {
    echo $response;
} else {
    file_put_contents('response.bin', $response);
    echo 'Saved ' . strlen($response) . ' bytes to response.bin' . PHP_EOL;
}

Response Fields ​

Key fields in a successful response (code = 0).

Comment list and pagination13 fields

data

Fields returned when the response contains a page of Xiaohongshu note comments.

FieldTypeDescription
commentsarrayTop-level comments on the returned page.
user_idstringThe Xiaohongshu user ID of the note author.
comment_countintegerThe overall comment count reported by Xiaohongshu for the note.
comment_count_l1integerThe reported count of top-level comments across the note's pages.
has_morebooleanWhether the response reports another page of top-level comments.
cursorstringThe top-level comment continuation cursor. When available, pass it unchanged as lastCursor for the same note and sort. It can be empty or absent at the end.
page_contextstringOpaque page context returned by Xiaohongshu.
current_sort_strategystringThe sort strategy code reported with the response. Its value can differ from the requested sort value.
all_sort_strategiesarraySort options reported with this page, when returned.
all_sort_strategies[]objectA sort option reported with this page.
all_sort_strategies[].typestringThe sort option code reported by Xiaohongshu.
all_sort_strategies[].optional_namestringThe primary display label for the sort option.
all_sort_strategies[].suffix_namestringThe supplementary display label for the sort option.
Comment content7 fields

data.comments[]

A top-level comment on the note.

FieldTypeDescription
idstringThe unique Xiaohongshu comment ID.
note_idstringThe ID of the note associated with this comment.
contentstringThe comment text returned by Xiaohongshu.
timeintegerThe comment creation time as a Unix timestamp in seconds.
ip_locationstringThe IP location label shown for the comment, when returned.
statusintegerThe status code returned for the comment.
comment_typeintegerThe platform comment type code.
Comment author9 fields

data.comments[].user

The author of this top-level comment.

FieldTypeDescription
useridstringThe Xiaohongshu user ID of this account.
red_idstringThe visible Xiaohongshu account ID, which can be empty.
nicknamestringThe display name of this account.
imagesstringThe profile avatar URL returned for this account.
current_userstringThe platform current-user indicator, returned as a string.
ai_agentbooleanWhether the platform marks this account as an AI agent.
levelobjectLevel information returned for this account.
level.imagestringThe image returned for the account level.
additional_tagsobjectAdditional account tag metadata, which can be empty.
Engagement and status11 fields

data.comments[]

FieldTypeDescription
like_countintegerThe number of likes reported for the comment.
likedbooleanWhether the platform marks this comment as liked in the response context.
downvotedbooleanWhether the platform marks this comment as downvoted in the response context.
collectedbooleanWhether the platform marks this comment as saved in the response context.
hiddenbooleanWhether the platform marks this comment as hidden.
show_typestringThe display type code returned for the comment.
scoreintegerThe platform-reported comment score.
track_idstringThe trace identifier attached to the comment by Xiaohongshu.
translation_strategyintegerThe platform code for comment translation behavior.
share_strategyintegerThe platform code for comment sharing behavior.
friend_liked_msgstringThe platform message about likes by friends, which can be empty.
Images, topics, and mentions39 fields

data.comments[]

FieldTypeDescription
at_usersarrayAccounts mentioned in the comment.
at_users[]objectAn account mentioned in the comment.
at_users[].useridstringThe Xiaohongshu user ID of the mentioned account.
at_users[].nicknamestringThe display name of the mentioned account.
at_users[].ai_agentbooleanWhether the platform marks the mentioned account as an AI agent.
at_users[].levelobjectLevel information for the mentioned account.
at_users[].level.imagestringThe image returned for the mentioned account's level.
hash_tagsarrayHashtags associated with the comment, when returned.
hash_tags[]objectA hashtag associated with the comment.
hash_tags[].namestringThe display name of the hashtag.
hash_tags[].linkstringThe link associated with the hashtag.
hash_tags[].typestringThe platform hashtag type code.
hash_tags[].disable_jumpbooleanWhether the platform disables navigation from the hashtag.
show_tagsarrayDisplay tags returned for the comment. The array can be empty.
show_tags_v2arrayStructured display tags returned for the comment.
show_tags_v2[]objectA structured display tag.
show_tags_v2[].typestringThe platform type code for the tag.
show_tags_v2[].textstringThe display text for the tag.
show_tags_v2[].style_idstringThe display style identifier for the tag.
show_tags_v2[].posstringThe display position code for the tag.
biz_labelobjectBusiness and rich-text markers for the comment.
biz_label.product_reviewbooleanWhether the platform marks this item as a product review.
biz_label.group_invitestringGroup invitation metadata returned as a string.
biz_label.rich_textstringRich-text metadata returned as a string.
picturesarrayImage or sticker attachments, when returned.
pictures[]objectAn image or sticker attachment to the comment.
pictures[].file_idstringThe platform file ID of the attachment.
pictures[].urlstringThe attachment image URL returned for display.
pictures[].origin_urlstringThe original attachment image URL returned by the platform.
pictures[].widthintegerThe width value returned for the attachment image.
pictures[].heightintegerThe height value returned for the attachment image.
pictures[].box_wintegerThe display box width value returned for the attachment.
pictures[].box_hintegerThe display box height value returned for the attachment.
pictures[].meme_packageobjectMetadata for a sticker or meme associated with the attachment.
pictures[].meme_package.meme_idstringThe ID of the sticker or meme, when returned.
pictures[].meme_package.image_urlstringThe sticker or meme image URL, when returned.
pictures[].meme_package.widthintegerThe width value returned for the sticker or meme.
pictures[].meme_package.heightintegerThe height value returned for the sticker or meme.
media_source_typeintegerThe platform media source type code for the comment attachment.
Reply list and pagination3 fields

data.comments[]

FieldTypeDescription
sub_comment_countintegerThe number of replies reported for this top-level comment.
sub_comment_cursorstringOptional reply pagination context for this top-level comment. The reply endpoint supplies its own continuation cursor.
sub_commentsarrayReplies embedded in the comment page. The list can be partial or empty even when sub_comment_count is positive.
Reply author9 fields

data.comments[].sub_comments[].user

The author of the embedded reply.

FieldTypeDescription
useridstringThe Xiaohongshu user ID of this account.
red_idstringThe visible Xiaohongshu account ID, which can be empty.
nicknamestringThe display name of this account.
imagesstringThe profile avatar URL returned for this account.
current_userstringThe platform current-user indicator, returned as a string.
ai_agentbooleanWhether the platform marks this account as an AI agent.
levelobjectLevel information returned for this account.
level.imagestringThe image returned for the account level.
additional_tagsobjectAdditional account tag metadata, which can be empty.
Replied-to comment12 fields

data.comments[].sub_comments[].target_comment

Information about the comment that this reply addresses.

FieldTypeDescription
idstringThe ID of the addressed comment.
statusintegerThe status code returned for the addressed comment.
userobjectThe author of the addressed comment.
user.useridstringThe Xiaohongshu user ID of this account.
user.red_idstringThe visible Xiaohongshu account ID, which can be empty.
user.nicknamestringThe display name of this account.
user.imagesstringThe profile avatar URL returned for this account.
user.current_userstringThe platform current-user indicator, returned as a string.
user.ai_agentbooleanWhether the platform marks this account as an AI agent.
user.levelobjectLevel information returned for this account.
user.level.imagestringThe image returned for the account level.
user.additional_tagsobjectAdditional account tag metadata, which can be empty.
Reply content and status29 fields

data.comments[].sub_comments[]

A reply embedded under a top-level comment.

FieldTypeDescription
idstringThe Xiaohongshu ID of the reply.
note_idstringThe ID of the note associated with this reply.
contentstringThe reply text returned by Xiaohongshu.
timeintegerThe reply creation time as a Unix timestamp in seconds.
ip_locationstringThe IP location label shown for the reply, when returned.
like_countintegerThe number of likes reported for the reply.
likedbooleanWhether the platform marks the reply as liked in the response context.
downvotedbooleanWhether the platform marks the reply as downvoted in the response context.
collectedbooleanWhether the platform marks the reply as saved in the response context.
hiddenbooleanWhether the platform marks the reply as hidden.
statusintegerThe status code returned for the reply.
comment_typeintegerThe platform reply type code.
show_typestringThe display type code returned for the reply.
scoreintegerThe platform-reported reply score.
translation_strategyintegerThe platform code for reply translation behavior.
share_strategyintegerThe platform code for reply sharing behavior.
friend_liked_msgstringThe platform message about likes by friends, which can be empty.
at_usersarrayAccounts mentioned in the reply. The array can be empty.
show_tagsarrayDisplay tags returned for the reply. The array can be empty.
show_tags_v2arrayStructured display tags returned for the reply.
show_tags_v2[]objectA structured display tag.
show_tags_v2[].typestringThe platform type code for the tag.
show_tags_v2[].textstringThe display text for the tag.
show_tags_v2[].style_idstringThe display style identifier for the tag.
show_tags_v2[].posstringThe display position code for the tag.
biz_labelobjectBusiness and rich-text markers for the reply.
biz_label.product_reviewbooleanWhether the platform marks this item as a product review.
biz_label.group_invitestringGroup invitation metadata returned as a string.
biz_label.rich_textstringRich-text metadata returned as a string.

Response Example ​

Loading the response example...