rednote/
note-comments

The Rednote Note Comments API collects one page of public Rednote comments from a xiaohongshu.com or xhslink.com note URL, returning text, authors, timestamps, note references, and visible engagement.

Rednote Note Comments API

Note URL input
One source request
Normalized comments
1 credit / request
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Rednote Note Comments

Rednote note comments are public responses associated with a specific note and can include the response text, author identity, publication time, thread reference, and visible interaction counts. They help researchers preserve what people said around a chosen note while keeping each observation linked to its source and collection time.

Rednote Note Comments API Features

  • Flexible Rednote share-link inputSubmit one reference hosted on xiaohongshu.com, xhslink.com, or a subdomain; the note-comments validator does not require a particular path, query string, or xsec_token.
  • Stable comment recordsThe Rednote Note Comments API returns comment IDs, text, source URLs, timestamps, and available author identity in the normalized CommentItem 1.0 result shape.
  • Note and thread referencesRetain post_id and parent_id when supplied so returned comments can stay associated with their note and available parent context.
  • Point-in-time engagement fieldsKeep available likes_count and replies_count beside collected_at without converting missing values into zero or implying complete reply coverage.

Rednote Note Comments API Parameters

ParametersRequiredDescription
urlRequiredRequired non-empty reference. Runtime validation accepts xiaohongshu.com, xhslink.com, and their subdomains without enforcing a pathname or requiring xsec_token; use an actual note share link so the provider can resolve the intended note.

How to Use the Rednote Note Comments API

Give the Rednote Note Comments API one supported note link, follow the asynchronous task, and read its stored normalized comments.

  1. Copy an actual Rednote note share link on xiaohongshu.com or xhslink.com.
  2. POST url to /v1/rednote/note-comments and save the returned task_id.
  3. Poll /v1/tasks/{task_id} until the task succeeds or reports a failure.
  4. Read data.results.items; follow next_cursor only when has_more is true to page through stored task results.
curl -X POST "https://api.socq.ai/v1/rednote/note-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://xhslink.com/{share_code}"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Rednote Note Comments API Use Cases

  • Qualitative response coding: Review the public text and author context returned by the Rednote Note Comments API to organize questions, reactions, or recurring discussion themes around one selected note.
  • Source-linked comment archives: Preserve comment IDs, source URLs, post_id, parent_id, published_at, and collected_at for traceable research records.
  • Engagement snapshot review: Compare available like and reply counts across returned comments while anchoring every observation to its collection time.

Rednote Note Comments API Pro Tips

  • Use the complete share link copied for the intended note; passing hostname validation alone does not guarantee that the provider can resolve an unrelated path.
  • Do not invent or separately require xsec_token. That rule belongs to the note-detail contract, not rednote/note-comments.
  • Do not send results_limit or a provider cursor: the submission owns only url and makes one source request.
  • Treat parent_id, post_id, timestamps, author attributes, and metrics as nullable source fields rather than guaranteed values.
  • Keep source collection depth separate from next_cursor, which only paginates normalized records already stored for a completed task.

Explore other platforms

Combine Rednote data with public data from other supported social platforms.

Rednote Note Comments API — FAQ

Rednote Note Comments API collects one source response page of public comments associated with a specified Rednote note link.

The runtime requires one non-empty url whose parsed hostname is xiaohongshu.com, xhslink.com, or a subdomain. It does not enforce a specific path or query, but an actual note share link is necessary for meaningful provider resolution.

No. rednote/note-comments applies the shared Rednote hostname validator only. The stricter path and xsec_token checks apply to the separate note-detail contract.

No. The submit contract accepts only url, and the provider integration makes one source request without caller-controlled source pagination.

The shared task-result reader can page through CommentItem records already stored by a succeeded task. That opaque SocQ cursor does not request another Rednote source page.

A successful Rednote Note Comments API task costs a fixed 1.00 SocQ credit, independent of the number of comments returned by the one source request.