Rednote Note Comments
Kommentare zu Rednote-Notes sind öffentliche Reaktionen auf eine bestimmte Note und können Antworttext, Autorenidentität, Veröffentlichungszeit, Thread-Verweis und sichtbare Interaktionszahlen enthalten. Sie helfen Forschenden, festzuhalten, was Menschen rund um eine gewählte Note gesagt haben, und halten jede Beobachtung mit ihrer Quelle und dem Erfassungszeitpunkt verknüpft.
Funktionen der Rednote Note Comments API
- Flexible Eingabe über Rednote-Share-LinksSenden Sie einen Verweis auf xiaohongshu.com, xhslink.com oder einer Subdomain; der Validator von note-comments verlangt weder einen bestimmten Pfad noch eine Query-Zeichenfolge oder ein xsec_token.
- Stabile KommentardatensätzeErhalten Sie Kommentar-IDs, Text, Quell-URLs, Zeitstempel und die verfügbare Autorenidentität in der normalisierten Ergebnisform CommentItem 1.0.
- Verweise auf Note und ThreadBehält post_id und parent_id bei, sofern vorhanden, damit zurückgegebene Kommentare ihrer Note und dem verfügbaren übergeordneten Kontext zugeordnet bleiben.
- Interaktionsfelder als MomentaufnahmeBehält verfügbare likes_count und replies_count neben collected_at bei, ohne fehlende Werte in null umzuwandeln oder eine vollständige Abdeckung der Antworten zu unterstellen.
Parameter der Rednote Note Comments API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich | Erforderlicher, nicht leerer Verweis. Die Validierung zur Laufzeit akzeptiert xiaohongshu.com, xhslink.com und deren Subdomains, ohne einen Pfadnamen zu erzwingen oder xsec_token zu verlangen; verwenden Sie einen echten Share-Link zu einer Note, damit der Anbieter die gemeinte Note auflösen kann. |
So verwenden Sie die Rednote Note Comments API
Senden Sie einen unterstützten Rednote-Note-Link, verfolgen Sie die asynchrone Aufgabe und lesen Sie die gespeicherten normalisierten Kommentare.
- Kopieren Sie einen echten Rednote-Share-Link zu einer Note auf xiaohongshu.com oder xhslink.com.
- Senden Sie url per POST an /v1/rednote/note-comments und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler meldet.
- Lesen Sie data.results.items; folgen Sie next_cursor nur, wenn has_more den Wert true hat, um durch gespeicherte Aufgabenergebnisse zu blättern.
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 trueAnwendungsfälle der Rednote Note Comments API
- Qualitative Kodierung von Reaktionen: Sichten Sie zurückgegebene öffentliche Texte und den verfügbaren Autorenkontext, um Fragen, Reaktionen oder wiederkehrende Diskussionsthemen zu einer ausgewählten Note zu ordnen.
- Kommentararchive mit Quellenbezug: Bewahren Sie Kommentar-IDs, Quell-URLs, post_id, parent_id, published_at und collected_at für nachvollziehbare Forschungsdatensätze auf.
- Auswertung der Interaktion per Momentaufnahme: Vergleichen Sie die verfügbaren Zahlen zu Likes und Antworten über die zurückgegebenen Kommentare hinweg und verankern Sie jede Beobachtung in ihrem Erfassungszeitpunkt.
Profi-Tipps zur Rednote Note Comments API
- Verwenden Sie den vollständigen Share-Link, der für die gemeinte Note kopiert wurde; die bestandene Prüfung des Hostnamens allein garantiert nicht, dass der Anbieter einen fremden Pfad auflösen kann.
- Erfinden Sie xsec_token nicht und verlangen Sie es nicht gesondert. Diese Regel gehört zur Spezifikation von note-detail, nicht zu rednote/note-comments.
- Senden Sie weder results_limit noch einen Cursor des Anbieters: Das Senden umfasst nur url und stellt eine Quellanfrage.
- Behandeln Sie parent_id, post_id, Zeitstempel, Autorenattribute und Kennzahlen als Quellfelder, die null sein können, und nicht als garantierte Werte.
- Halten Sie die Tiefe der Quellerfassung von next_cursor getrennt, der nur normalisierte Datensätze durchblättert, die für eine abgeschlossene Aufgabe bereits gespeichert sind.
Verwandte APIs
Ergänzend zur Rednote Note Comments API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Rednote-Daten benötigen.