douyin/
user-profile

Ein öffentliches Douyin-Profil anhand einer unterstützten Profil-URL oder Benutzerkennung abrufen – mit normalisierter Identität, Biografie, Bildern, Kontomerkmalen und sichtbaren Zahlen.

Douyin User Profile API

URL oder Benutzer-ID
Ein einzelnes öffentliches Profil
Normalisierte Kontofelder
0,1 Credits pro Anfrage
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

Douyin User Profile

Douyin-Benutzerprofile sind öffentliche Kontoseiten mit Identität, Biografie, Profilbildern, Signalen zu Verifizierung und Datenschutz sowie den sichtbaren Zahlen zu Followern, Gefolgten und Beiträgen. Diese Felder unterstützen Kontoanreicherung, Identitätsprüfungen, Beobachtung per Momentaufnahme und vergleichende Profilrecherche.

Funktionen der Douyin User Profile API

  • Zwei unterstützte KennungenLösen Sie ein öffentliches Profil entweder über eine unterstützte Douyin-Benutzer-URL oder über eine user_id auf, die der Kennungsregel der Laufzeit entspricht.
  • Profilidentität und DarstellungLiefert die verfügbare Profil-ID, öffentliche URL, Benutzernamen, Anzeigenamen, Biografie, Avatar, Titelbild und zugehörige Website in einem Kontodatensatz.
  • Ausdrückliche Felder zum KontostatusBehält die verfügbaren Merkmale zu Verifizierung und Datenschutz als nullable Werte bei, statt einen Status abzuleiten, wenn die öffentliche Quelle ihn weglässt.
  • Sichtbare ProfilkennzahlenNormalisiert die verfügbaren Zahlen zu Followern, Gefolgten und Beiträgen zusammen mit collected_at für eine zeitbezogene Ansicht des öffentlichen Profils.

Parameter der Douyin User Profile API

ParameterErforderlichBeschreibung
urlErforderlich (mindestens eines)Geben Sie url oder user_id an. Eine nicht leere URL muss douyin.com, iesdouyin.com oder eine Subdomain verwenden und einen Pfad /user/<identifier> enthalten.
user_idErforderlich (mindestens eines)Geben Sie user_id oder url an. user_id akzeptiert 1 bis 256 ASCII-Buchstaben, Ziffern, Doppelpunkte, Unterstriche oder Bindestriche und hat Vorrang, wenn beide Felder übermittelt werden.

So verwenden Sie die Douyin User Profile API

Senden Sie eine unterstützte Profilkennung, verfolgen Sie die asynchrone Aufgabe und lesen Sie das normalisierte Konto aus der Hülle der gespeicherten Ergebnisse.

  1. Bereiten Sie entweder eine vollständige Douyin-Profil-URL mit einem Pfad /user/<identifier> oder eine unterstützte öffentliche user_id vor.
  2. Senden Sie eine Kennung per POST an /v1/douyin/user-profile und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis status den Wert succeeded oder failed hat.
  4. Lesen Sie nach einem Erfolg data.results.items; die Abfrage bei der Quelle liefert höchstens ein Profil, während die Hülle der gespeicherten Ergebnisse dennoch has_more und next_cursor meldet.
curl -X POST "https://api.socq.ai/v1/douyin/user-profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"user_id\":\"${DOUYIN_USER_ID}\"}"

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

Anwendungsfälle der Douyin User Profile API

  • Anreicherung von Creator-Datensätzen: Ergänzen Sie einen bestehenden Creator-Datensatz um die verfügbare Douyin-Identität, Biografie, Bilder, Website, Kontomerkmale und öffentlichen Zahlen.
  • Prüfung von Profilidentitäten: Lösen Sie eine bekannte Profil-URL oder Benutzerkennung in ein einheitliches Kontoobjekt auf, bevor Sie es mit einer internen Entität verknüpfen.
  • Vergleich öffentlicher Konten: Vergleichen Sie die Zahlen zu Followern, Gefolgten und Beiträgen über getrennt erfasste Profile hinweg anhand derselben normalisierten Kennzahlenschlüssel.
  • Beobachtung von Profil-Momentaufnahmen: Speichern Sie Identitätsfelder und öffentliche Kennzahlen mit collected_at, damit spätere Aufgaben als Beobachtungen zu verschiedenen Zeitpunkten unterscheidbar bleiben.

Profi-Tipps zur Douyin User Profile API

  • Ist bereits eine kanonische Benutzerkennung vorhanden, senden Sie user_id allein; stimmen url und user_id nicht überein, verwendet die Anfrage an den Anbieter user_id.
  • Prüfen Sie vor dem Senden einer URL ihren Hostnamen und verlangen Sie einen Pfad /user/<identifier>, damit Links auf Videos oder andere Douyin-Ressourcen lokal abgelehnt werden.
  • Rechnen Sie mit null oder einem Quellprofil; der Cursor des Aufgabenlesers paginiert gespeicherte SocQ-Einträge und kann für diese Abfrage keine weitere Seite beim Anbieter anfordern.
  • Behandeln Sie Identität, Bilder, Website, Kontomerkmale, Standort und jede Kennzahl als nullable und bewahren Sie collected_at auf, wenn Sie wiederholte Momentaufnahmen vergleichen.

Ergänzend zur Douyin User Profile API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Douyin-Daten benötigen.

Weitere Plattformen entdecken

Kombinieren Sie Douyin-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Douyin User Profile API — FAQ

Douyin User Profile API ruft ein öffentliches Douyin-Konto anhand einer unterstützten Profil-URL oder Benutzerkennung ab und liefert normalisierte Identität, Biografie, Bilder, Kontomerkmale, sichtbare Zahlen und die Erfassungszeit.

Jedes der beiden Felder erfüllt die Anforderung der Anfrage. Senden Sie nur die Kennung, die Sie auflösen möchten, denn user_id hat Vorrang, wenn beide Werte vorhanden sind.

Der geparste Hostname muss douyin.com, iesdouyin.com oder eine Subdomain sein, und der Pfad muss /user/ gefolgt von einer Kennung aus Buchstaben, Ziffern, Unterstrichen oder Bindestrichen enthalten. Video-Links und fremde Hosts werden abgelehnt.

Das Kontoschema kann Profil-ID und URL, Benutzernamen, Anzeigenamen, Biografie, Avatar, Titelbild, Website, Merkmale zu Verifizierung und Datenschutz, Standort, Follower-Zahl, Zahl der Gefolgten, Beitragszahl und collected_at enthalten. Optionale öffentliche Felder bleiben null, wenn kein Wert verfügbar ist.

Nein. Die Abfrage beim Anbieter ist eine einzelne Detailanfrage, die höchstens ein Quellprofil liefert; next_cursor und has_more beschreiben nur die Paginierung über bereits in SocQ gespeicherte Ergebnisse.

Jede erfolgreiche Aufgabe kostet pauschal 0,10 SocQ-Credits. Die Gebühr hängt nicht davon ab, wie viele optionale Profilfelder befüllt sind.