rednote/
user-profile

Ein öffentliches Rednote-Profil über eine unterstützte Konto-URL oder user_id abrufen – mit normalisierter Identität, Profilbildern, Kontomerkmalen, sichtbaren Zahlen und Erfassungszeitpunkt.

Rednote User Profile API

URL oder user_id
Ein normalisiertes Konto
Aufgabe zu pauschal 1 Credit
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 User Profile

Öffentliche Rednote-Profile können eine Kontokennung, den Rednote-Handle, den Anzeigenamen, die Biografie, Profilbilder, eine Website, Kontomerkmale sowie die sichtbaren Zahlen zu Followern, Gefolgten und Beiträgen offenlegen. Ein normalisierter Datensatz hält diese verfügbaren Identitätsfelder und Momentaufnahme-Signale zusammen und eignet sich für den Kontoabgleich, den Vergleich ausgewählter Profile und die Analyse wiederholter Aufnahmen.

Funktionen der Rednote User Profile API

  • Zwei Abfragewege mit ausdrücklicher PrioritätErmittelt ein Profil über eine unterstützte Rednote-URL oder eine öffentliche user_id. Sind beide Felder angegeben, wird für die Abfrage bei der Quelle die ausdrückliche user_id verwendet.
  • Einheitlicher öffentlicher IdentitätsdatensatzNormalisiert die verfügbare Konto-ID, Quell-URL, den Rednote-Handle, Anzeigenamen, die Biografie, das Profilbild, Titelbild, die Website sowie die Merkmale für Verifizierung und Datenschutz.
  • Sichtbare Kontosignale mit ZeitstempelLiefert die verfügbaren Zahlen zu Followern, Gefolgten und Beiträgen zusammen mit collected_at, sodass jedes Ergebnis eine Momentaufnahme bleibt und kein aktueller Gesamtwert ist.

Parameter der Rednote User Profile API

ParameterErforderlichBeschreibung
urlErforderlich (mindestens eines)Es ist entweder url oder user_id erforderlich. Der geparste Hostname muss xiaohongshu.com, xhslink.com oder eine Subdomain eines dieser Hosts sein. Ist zusätzlich user_id angegeben, hat user_id Vorrang.
user_idErforderlich (mindestens eines)Es ist entweder user_id oder url erforderlich. Verwenden Sie 1 bis 256 ASCII-Buchstaben, Ziffern, Doppelpunkte, Unterstriche oder Bindestriche. Diese ausdrückliche Kennung hat Vorrang, wenn zusätzlich url angegeben ist.

So verwenden Sie die Rednote User Profile API

Senden Sie eine unterstützte Kontoreferenz, verfolgen Sie die asynchrone Aufgabe und lesen Sie das normalisierte Konto aus der Seite mit den gespeicherten Ergebnissen.

  1. Bereiten Sie eine aktuelle öffentliche user_id oder eine URL vor, deren geparster Hostname xiaohongshu.com, xhslink.com oder eine Subdomain eines dieser Hosts ist.
  2. Senden Sie user_id, url oder beides an /v1/rednote/user-profile; sind beide vorhanden, hat user_id Vorrang. 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 das Konto in data.results.items. Verwenden Sie next_cursor nur, wenn der Reader für gespeicherte Ergebnisse has_more mit true meldet.
REDNOTE_USER_ID=''
# Paste a current public Rednote account identifier before running.
curl -X POST "https://api.socq.ai/v1/rednote/user-profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"user_id\":\"$REDNOTE_USER_ID\"}"

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; follow next_cursor only while has_more is true

Anwendungsfälle der Rednote User Profile API

  • Anreicherung bekannter Konten: Machen Sie aus einer vorhandenen Referenz auf ein öffentliches Rednote-Konto einen einheitlichen Identitätsdatensatz mit den verfügbaren Profiltexten, Bildern, der Website und den Kontomerkmalen.
  • Vergleich von Profil-Momentaufnahmen: Vergleichen Sie ausgewählte Konten oder wiederholte Erfassungen anhand stabiler Ergebnis-IDs, collected_at und der Zahlen zu Followern, Gefolgten und Beiträgen, die zum Erfassungszeitpunkt verfügbar waren.

Profi-Tipps zur Rednote User Profile API

  • Geben Sie mindestens eine Eingabe an. Sind url und user_id beide vorhanden, verwendet das Backend die ausdrückliche user_id und sendet die URL nicht an die Abfrage bei der Quelle.
  • Bevorzugen Sie user_id, wenn Sie die öffentliche Kontokennung bereits haben; so sind Sie nicht von der Struktur einer geteilten oder Konto-URL abhängig.
  • Validieren Sie user_id vor dem Senden mit ^[A-Za-z0-9:_-]{1,256}$ und verlangen Sie, dass der geparste URL-Hostname xiaohongshu.com, xhslink.com oder einer Subdomain entspricht.
  • Fügen Sie weder results_limit noch einen Quell-Cursor hinzu. Dieser Endpunkt stellt eine einzige Detailanfrage, und next_cursor gehört ausschließlich zum Reader für gespeicherte SocQ-Ergebnisse.
  • Behandeln Sie Biografie, Profilbilder, Website, Merkmale und jede Kennzahl als optional. Behalten Sie null-Werte bei, statt fehlende Felder in leere Zeichenfolgen oder 0 umzuwandeln.
  • Ein früheres Rednote-Kontoergebnis kann seine kanonische id als user_id liefern. Halten Sie diese Kennung getrennt vom zurückgegebenen username, der den verfügbaren Rednote-Handle darstellt.

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

Rednote User Profile API ruft höchstens ein öffentliches Rednote-Profil über eine unterstützte Konto-URL oder user_id ab und gibt einen normalisierten Kontodatensatz zurück.

Verwenden Sie user_id, wenn sie bekannt ist. Sie dürfen beide Felder senden, aber die ausdrückliche user_id hat Vorrang, und die URL wird nicht an die Abfrage bei der Quelle weitergegeben.

Eine URL muss zu xiaohongshu.com, xhslink.com oder einer Subdomain geparst werden. user_id muss aus 1 bis 256 ASCII-Buchstaben, Ziffern, Doppelpunkten, Unterstrichen oder Bindestrichen bestehen.

Ein Ergebnis kann ID, Quell-URL, Rednote-Handle, Anzeigenamen, Biografie, Profilbild, Titelbild, Website, Merkmale für Verifizierung und Datenschutz, die Zahlen zu Followern, Gefolgten und Beiträgen sowie den Erfassungszeitpunkt enthalten. Einzelne Felder können null sein.

Nein. user_id ist eine akzeptierte Kennung für die Abfrage, und das kanonische Ergebnis hat eine eigene id. username enthält den Rednote-Handle, sofern die Quelle einen liefert; Aufrufer sollten ihn daher nicht ungeprüft als user_id verwenden, ohne den Wert der Quelle zu verifizieren.

Nein. Eine Aufgabe stellt eine einzige Anfrage nach Profildetails und kann höchstens ein Konto speichern. Die gemeinsame Antwort mit dem Aufgabenergebnis enthält dennoch items, next_cursor und has_more zum Lesen der von SocQ gespeicherten Datensätze.

Jede erfolgreiche Aufgabe von Rednote User Profile kostet pauschal 1,00 SocQ-Credit. Die Anfrage wird weder nach der Anzahl der Felder noch nach der Anzahl der gespeicherten Ergebnisse berechnet.