Rednote Comment Replies
Antworten auf Rednote-Kommentare sind öffentliche Reaktionen, die unter einem ausgewählten Kommentar zu einer Note verschachtelt sind und Antworttext, Autorenkontext, Zeitstempel sowie verfügbare Felder zu Beziehungen oder Interaktion enthalten. Die normalisierten Datensätze helfen Teams, einen bekannten Gesprächszweig zu untersuchen, ohne die Kennung des Quellkommentars mit der Paginierung gespeicherter Ergebnisse zu vermischen.
Funktionen der Rednote Comment Replies API
- Gekoppelter Thread-VerweisSprechen Sie einen Gesprächszweig mit der öffentlichen Note-URL und der dazugehörigen Kommentarkennung gezielt an.
- Erfassung der Antworten einer SeiteFührt eine Quellanfrage aus und speichert die Antworten, die auf dieser Seite zurückgegeben werden – ohne Cursor des Anbieters und ohne Ergebnislimit beim Senden.
- Normalisierter AntworttextLiefert Antwort-ID, öffentlichen Text, Quell-URL, Veröffentlichungszeit und Erfassungszeit in der gemeinsamen Struktur CommentItem.
- Öffentlicher AutorenkontextBehält verfügbare Autoren-ID, Benutzername, Anzeigename, Profil-URL, Avatar und Kontomerkmale bei jeder Antwort bei.
- Beziehungen im GesprächBehält verfügbare Verknüpfungen über parent_id und post_id zusammen mit den sichtbaren Zahlen zu Likes und Antworten für eine Verarbeitung mit Thread-Bezug bei.
Parameter der Rednote Comment Replies API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich | Erforderliche öffentliche URL, deren Host xiaohongshu.com, xhslink.com oder eine Subdomain von beiden ist. Dieser Endpunkt ergänzt weder ein Pfadmuster noch die Pflicht zu einem xsec_token in der Query. |
comment_id | Erforderlich | Erforderliche Kennung des Quellkommentars, bestehend aus 1 bis 256 ASCII-Buchstaben, Ziffern, Doppelpunkten, Unterstrichen oder Bindestrichen. |
So verwenden Sie die Rednote Comment Replies API
Senden Sie die passende Rednote-Note-URL und Kommentar-ID und lesen Sie das Ergebnis mit einer Seite Antworten über den asynchronen Aufgabenablauf von SocQ.
- Wählen Sie eine öffentliche Note-URL auf xiaohongshu.com oder xhslink.com und prüfen Sie, ob die Kommentar-ID zu genau dieser Note passt.
- Senden Sie url und comment_id per POST an /v1/rednote/comment-replies und bewahren Sie die zurückgegebene task_id auf.
- Fragen Sie GET /v1/tasks/{task_id} ab, solange die Aufgabe in der Warteschlange ist, läuft oder wiederholt wird; beenden Sie bei succeeded oder failed.
- Lesen Sie nach einem Erfolg data.results.items und verwenden Sie data.results.next_cursor nur, um Antwortzeilen zu durchblättern, die SocQ bereits gespeichert hat.
curl -X POST "https://api.socq.ai/v1/rednote/comment-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"url\":\"$REDNOTE_NOTE_URL\",\"comment_id\":\"$REDNOTE_COMMENT_ID\"}"
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after status becomes succeededAnwendungsfälle der Rednote Comment Replies API
- Gezielte Durchsicht eines Gesprächs: Lesen Sie öffentliche Antworttexte und Zeitstempel für einen ausgewählten Kommentarzweig, statt Antworten einer ganzen Note zu vermischen.
- Anreicherung um Teilnehmerkontext: Ordnen Sie jeder Antwort die verfügbare normalisierte Autorenidentität zu, wenn Sie Datensätze für Moderationsforschung oder manuelle Prüfung vorbereiten.
- Abbilden von Thread-Beziehungen: Nutzen Sie Antwort-IDs mit parent_id und post_id, um gespeicherte Datensätze wieder mit ihrem Quellkommentar und ihrer Note zu verbinden, sofern diese Felder vorhanden sind.
- Momentaufnahmen von Reaktionen: Bewahren Sie collected_at neben den sichtbaren Zahlen zu Likes oder Antworten auf, damit getrennte Durchläufe unterscheidbare Beobachtungen bleiben.
Profi-Tipps zur Rednote Comment Replies API
- Prüfen Sie, ob comment_id zur gesendeten Note-URL gehört; der Endpunkt validiert das Format jedes Felds, stellt diese Beziehung aber vor der Quellanfrage nicht her.
- Verwenden Sie eine vollständige, öffentliche URL auf xiaohongshu.com, xhslink.com oder einer akzeptierten Subdomain, auch wenn dieser Validator weder einen bestimmten Note-Pfad noch den Query-Parameter xsec_token verlangt.
- Halten Sie comment_id innerhalb des akzeptierten ASCII-Kennungsmusters von 1 bis 256 Zeichen und ersetzen Sie sie nicht durch eine interne Datenbank-ID oder eine SocQ-Aufgaben-ID.
- Behandeln Sie eine Kommentar-ID aus einer anderen Erfassung als bedingte Eingabe: Normalisierte Kommentar-IDs sind optional, prüfen Sie also vor dem Senden, ob ein verwendbarer Wert vorhanden ist.
- Fügen Sie der Sendenutzlast weder results_limit noch einen Quell-Cursor hinzu; dieser Endpunkt führt eine Anfrage an den Anbieter für eine Quellseite aus.
- Halten Sie next_cursor des Aufgabenergebnisses von comment_id getrennt, denn dieser Cursor blättert nur durch normalisierte Zeilen, die nach dem Erfolg der Aufgabe gespeichert wurden.
- Erlauben Sie für Identität, Beziehungen, Zeitstempel und Kennzahlen den Wert null und maskieren Sie öffentlichen Antworttext, bevor Sie ihn in einem anderen Produkt darstellen.
Verwandte APIs
Ergänzend zur Rednote Comment Replies API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Rednote-Daten benötigen.