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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich (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_id | Erforderlich (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.
- 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.
- 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.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler meldet.
- 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 trueAnwendungsfä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.
Verwandte APIs
Ergänzend zur Rednote User Profile API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Rednote-Daten benötigen.