Rednote User Notes
Rednote-Benutzernotizen sind öffentliche Veröffentlichungen eines Kontos mit Text, Autorenzuordnung, Medien, Veröffentlichungszeitpunkt und sichtbaren Interaktionszahlen. Diese Inhalts- und Kontextfelder eignen sich für Kontorecherche, die Prüfung von Veröffentlichungsmustern, den Vergleich von Formaten und die Leistungsanalyse als Momentaufnahme.
Funktionen der Rednote User Notes API
- Zwei Eingaben zur Kontoidentität mit festgelegtem VorrangAkzeptiert entweder eine unterstützte Rednote-Benutzerreferenz oder user_id; sind beide Felder angegeben, wird die ausdrückliche user_id verwendet.
- Notizen eines Kontos von einer SeiteRuft die öffentlichen Notizen ab, die eine Quellanfrage für das gewählte Konto zurückliefert – ohne Quell-Cursor und ohne vom Aufrufer festgelegte Ergebnisgrenze.
- Normalisierte Notiz- und AutorendatenLiefert Notiz-IDs, öffentliche URLs, Text, Autoridentität, Medienverweise, Veröffentlichungszeitpunkt und Erfassungszeitpunkt in einer einheitlichen PostItem-Struktur.
- Momentaufnahmen der sichtbaren InteraktionBehält die verfügbaren Zahlen zu Likes, Kommentaren, Shares und Aufrufen zusammen mit collected_at bei, damit sich Werte zeitlich abgegrenzt vergleichen lassen.
Parameter der Rednote User Notes API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich (mindestens eines) | Eine nicht leere Rednote-Benutzerreferenz, deren geparster Hostname xiaohongshu.com, xhslink.com oder eine Subdomain eines dieser Hosts ist. Ein bestimmtes Pfadmuster ist nicht erforderlich; enthält die URL /user/<identifier> und ist user_id leer, wird diese Kennung verwendet, andernfalls dient die akzeptierte URL als Kontoreferenz. |
user_id | Erforderlich (mindestens eines) | Eine Rednote-Benutzerkennung aus 1 bis 256 ASCII-Buchstaben, Ziffern, Doppelpunkten, Unterstrichen oder Bindestrichen. Geben Sie url oder user_id an; sind beide vorhanden, hat die ausdrückliche user_id Vorrang. |
So verwenden Sie die Rednote User Notes API
Senden Sie eine unterstützte Rednote-Kontoidentität, verfolgen Sie die asynchrone Aufgabe und blättern Sie anschließend durch die gespeicherten normalisierten Notizdatensätze.
- Bereiten Sie entweder eine nicht leere Rednote-Benutzer-URL auf einem akzeptierten Host oder eine gültige user_id vor; lassen Sie das jeweils andere Feld leer, wenn Sie es nicht benötigen.
- Senden Sie url oder user_id per POST an /v1/rednote/user-notes 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 und folgen Sie next_cursor, solange has_more den Wert true hat; dieser Cursor paginiert gespeicherte Datensätze und keine weiteren Rednote-Quellseiten.
curl -X POST "https://api.socq.ai/v1/rednote/user-notes" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"url\":\"$REDNOTE_USER_URL\"}"
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der Rednote User Notes API
- Bestand veröffentlichter Inhalte eines öffentlichen Kontos: Katalogisieren Sie die zurückgegebene Konto-Momentaufnahme anhand von Notiz-IDs, öffentlichen URLs, Text, Autorenzuordnung und Veröffentlichungszeitpunkt.
- Prüfung von Inhaltsformaten: Vergleichen Sie die verfügbaren Bild- und Videoverweise, Abmessungen, Vorschaubilder und Notiztexte über die zurückgegebenen Notizen des Kontos hinweg.
- Analyse von Veröffentlichungsmustern: Sortieren Sie Notizen nach published_at und betrachten Sie Text und Medien gemeinsam, um den sichtbaren Veröffentlichungsmix des Kontos innerhalb der Momentaufnahme zu beurteilen.
- Vergleich der Interaktion als Momentaufnahme: Vergleichen Sie sichtbare Likes, Kommentare, Shares und Aufrufe und halten Sie jede Beobachtung mit collected_at an ihren Erfassungszeitpunkt gebunden.
Profi-Tipps zur Rednote User Notes API
- Verwenden Sie eine stabile user_id, wenn Sie bereits eine haben; sie hat Vorrang vor url und vermeidet Unklarheiten zwischen zwei Kontoreferenzen.
- Prüfen Sie bei der Übergabe von url den Hostnamen gegen xiaohongshu.com oder xhslink.com; ein bestimmtes Pfadmuster ist nicht erforderlich.
- Enthält eine unterstützte URL /user/<identifier>, bestätigen Sie, dass der Pfad das gewünschte Konto bezeichnet, denn diese Kennung wird verwendet, solange user_id leer ist.
- Fügen Sie der Anfrage weder results_limit noch einen Quell-Cursor hinzu; jede Aufgabe stellt genau eine Quellanfrage für eine Seite.
- Verwenden Sie cursor und limit erst nach Abschluss und ausschließlich bei GET /v1/tasks/{task_id}; limit ist standardmäßig 50 und akzeptiert für gespeicherte Ergebnisse 1 bis 500.
- Behandeln Sie Text, Autorenfelder, Medien, Veröffentlichungszeitpunkt, Hashtags, Erwähnungen und einzelne Kennzahlen als nullable und maskieren Sie öffentlichen Text, bevor Sie ihn anzeigen.
Verwandte APIs
Ergänzend zur Rednote User Notes API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Rednote-Daten benötigen.