rednote/
note-comments

Eine Seite öffentlicher Rednote-Kommentare aus einer Note-URL auf xiaohongshu.com oder xhslink.com erfassen – mit Text, Autoren, Zeitstempeln, Verweisen auf die Note und sichtbarer Interaktion.

Rednote Note Comments API

Eingabe per Note-URL
Eine Quellanfrage
Normalisierte Kommentare
1 Credit pro Anfrage
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

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

ParameterErforderlichBeschreibung
urlErforderlichErforderlicher, 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.

  1. Kopieren Sie einen echten Rednote-Share-Link zu einer Note auf xiaohongshu.com oder xhslink.com.
  2. Senden Sie url per POST an /v1/rednote/note-comments und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler meldet.
  4. 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 true

Anwendungsfä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.

Ergänzend zur Rednote Note Comments API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Rednote-Daten benötigen.

Weitere Plattformen entdecken

Kombinieren Sie Rednote-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Rednote Note Comments API — FAQ

Rednote Note Comments API erfasst eine Antwortseite der Quelle mit öffentlichen Kommentaren zu einem angegebenen Rednote-Note-Link.

Die Laufzeit verlangt eine nicht leere url, deren ausgewerteter Hostname xiaohongshu.com, xhslink.com oder eine Subdomain ist. Ein bestimmter Pfad oder eine bestimmte Query wird nicht erzwungen, aber für eine sinnvolle Auflösung beim Anbieter ist ein echter Share-Link zu einer Note nötig.

Nein. rednote/note-comments wendet nur den gemeinsamen Hostnamen-Validator von Rednote an. Die strengeren Prüfungen von Pfad und xsec_token gelten für die separate Spezifikation von note-detail.

Nein. Die Spezifikation für das Senden akzeptiert nur url, und die Integration beim Anbieter stellt eine Quellanfrage ohne vom Aufrufer gesteuerte Paginierung der Quelle.

Der gemeinsame Leser der Aufgabenergebnisse kann durch CommentItem-Datensätze blättern, die eine erfolgreiche Aufgabe bereits gespeichert hat. Dieser undurchsichtige SocQ-Cursor fordert keine weitere Rednote-Quellseite an.

Eine erfolgreiche Aufgabe von Rednote Note Comments kostet pauschal 1,00 SocQ-Credit, unabhängig von der Zahl der Kommentare, die die eine Quellanfrage zurückgibt.