rednote/
note-detail

Eine öffentliche Rednote-Note aus einer URL mit Token auf xiaohongshu.com oder xhslink.com abrufen – mit normalisiertem Text, Autor, Medien, Zeitstempeln und sichtbarer Interaktion.

Rednote Note Detail API

Note-URL mit Token
Details einer einzelnen Note
Normalisierter Beitragsdatensatz
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 Detail

Rednote-Notes sind öffentliche Inhaltsobjekte, die Text und Medien mit Autorenidentität, Themenverweisen, Veröffentlichungszeit und sichtbarer Interaktion verbinden. Diese Felder unterstützen die Anreicherung bekannter Links, die inhaltliche Prüfung und den Vergleich ausgewählter Notes per Momentaufnahme.

Funktionen der Rednote Note Detail API

  • Abfrage einer Note mit TokenLöst eine bekannte öffentliche Note-URL nur dann auf, wenn akzeptierter Host, Note-Detail-Pfad und ein nicht leeres xsec_token eine vollständige Abfrage bei der Quelle ermöglichen.
  • Kontext zu Note und AutorLiefert normalisierte Note-Identität, Quell-URL, Text, Zeitstempel und die verfügbaren Angaben zu Autoren-ID, Benutzername, Anzeigename, Profil-URL, Avatar und Kontomerkmalen.
  • Medien und Momentaufnahme der InteraktionBehält verfügbare Medienverweise, Vorschaubilder, Abmessungen, Dauer, Themenverweise und die sichtbaren Zahlen zu Likes, Kommentaren, Teilen und Aufrufen mit dem Erfassungszeitpunkt bei.

Parameter der Rednote Note Detail API

ParameterErforderlichBeschreibung
urlErforderlichErforderliche, nicht leere URL auf xiaohongshu.com, xhslink.com oder einer Subdomain. Ihr Pfad muss /explore/{note_id} oder /discovery/item/{note_id} enthalten, und ihre Query muss ein nicht leeres xsec_token enthalten.

So verwenden Sie die Rednote Note Detail API

Geben Sie eine aktuelle Note-URL mit Token an, senden Sie die asynchrone Anfrage und lesen Sie nach dem Abschluss den einzelnen normalisierten Beitragsdatensatz.

  1. Kopieren Sie eine aktuelle öffentliche Note-URL, deren akzeptierter Host, Note-Detail-Pfad und Query-Zeichenfolge ein nicht leeres xsec_token enthalten.
  2. Senden Sie die url per POST an /v1/rednote/note-detail und speichern Sie data.task_id aus der Antwort auf das Senden.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler meldet.
  4. Lesen Sie nach einem Erfolg data.results.items. Die Abfrage bei der Quelle ist eine einzelne Detailanfrage; next_cursor blättert nur durch von SocQ gespeicherte Datensätze.
REDNOTE_NOTE_URL=''
# Paste a current public note URL with xsec_token between the quotes

curl -X POST "https://api.socq.ai/v1/rednote/note-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"url\":\"$REDNOTE_NOTE_URL\"}"

# Poll GET /v1/tasks/{task_id}
# Read the normalized post from data.results.items

Anwendungsfälle der Rednote Note Detail API

  • Anreicherung eines Katalogs bekannter Notes: Machen Sie aus einer qualifizierten Note-URL normalisierte Felder zu Identität, Text, Autor, Veröffentlichungszeit und Quelle für einen bestehenden Inhaltsindex.
  • Prüfung ausgewählter Note-Inhalte: Nutzen Sie Text, Autorenkontext, Medienverweise und Themenfelder, um eine definierte Menge einzelner öffentlicher Notes zu untersuchen.
  • Vergleich von Beobachtungen der Interaktion: Kombinieren Sie die sichtbaren Zahlen zu Likes, Kommentaren, Teilen und Aufrufen mit collected_at über getrennt gesendete Abfragen hinweg, um Momentaufnahmen zu vergleichen.

Profi-Tipps zur Rednote Note Detail API

  • Verwenden Sie die vollständige Note-URL mit Host, dem Pfad /explore/ oder /discovery/item/ und dem Query-Parameter xsec_token; eine bloße Note-ID besteht die Validierung nicht.
  • Belassen Sie xsec_token in der Query der URL, denn die Anfrage akzeptiert nur url und lehnt ein separates Token-Feld ab.
  • Wenn Sie eine URL aus dem Ergebnis eines anderen SocQ-Rednote-Note-Endpunkts wiederverwenden, prüfen Sie, ob xsec_token noch vorhanden ist; Note Detail kann ein fehlendes Token nicht rekonstruieren.
  • Senden Sie pro Aufgabe eine URL, denn dieser Detail-Endpunkt hat kein Feld für Stapel, kein results_limit und keine Eingabe für einen Quell-Cursor.
  • Behandeln Sie next_cursor ausschließlich als Paginierung gespeicherter Ergebnisse; die Quelle führt eine einzelne Detailabfrage aus und erzeugt normalerweise höchstens einen Datensatz.
  • Speichern Sie Felder zu Autor, Medien, Thema, Zeitstempel und Interaktion defensiv und kombinieren Sie sichtbare Zähler mit collected_at, denn optionale öffentliche Werte können fehlen.

Ergänzend zur Rednote Note Detail 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 Detail API — FAQ

Rednote Note Detail API ruft eine öffentliche Rednote-Note aus einer URL mit Token auf einem akzeptierten Host ab und liefert normalisierte Felder zu Note-Identität, Text, Autor, Medien, Themenverweisen, Zeitstempeln und sichtbarer Interaktion.

Verwenden Sie eine nicht leere URL auf xiaohongshu.com, xhslink.com oder einer Subdomain. Ihr Pfad muss /explore/{note_id} oder /discovery/item/{note_id} enthalten, und ihre Query muss ein nicht leeres xsec_token enthalten.

Nein. Das öffentliche Schema der Anfrage akzeptiert nur url; SocQ entnimmt note_id und xsec_token aus dieser URL.

Senden Sie eine aktuelle öffentliche Note-URL, die xsec_token bereits enthält. Eine URL, die ein anderer SocQ-Rednote-Note-Endpunkt zurückgibt, ist nur wiederverwendbar, wenn dieser Query-Parameter noch vorhanden ist; Note Detail erzeugt kein fehlendes Token.

Der normalisierte Beitragsdatensatz kann Note-Identität, URL, Text, Veröffentlichungs- und Erfassungszeit, Autorendetails, Medien, Hashtags, Erwähnungen und die sichtbaren Zahlen zu Likes, Kommentaren, Teilen und Aufrufen enthalten. Optionale öffentliche Felder können null sein.

Nein. Die Quelle führt eine einzelne Detailabfrage aus und speichert höchstens einen Datensatz. Der gemeinsame Leser der Aufgabenergebnisse stellt für von SocQ gespeicherte Datensätze weiterhin limit, next_cursor und has_more bereit.

Der Endpunkt ist auf pauschal 1,00 SocQ-Credit pro Aufgabe konfiguriert. Die Schätzung wächst nicht mit der Zahl der zurückgegebenen Datensätze.