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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich (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_id | Erforderlich (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.
- Bereiten Sie entweder eine vollständige Douyin-Profil-URL mit einem Pfad /user/<identifier> oder eine unterstützte öffentliche user_id vor.
- Senden Sie eine Kennung per POST an /v1/douyin/user-profile und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis status den Wert succeeded oder failed hat.
- 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.itemsAnwendungsfä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.
Verwandte APIs
Ergänzend zur Douyin User Profile API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Douyin-Daten benötigen.
- Douyin Live Room Detail API — Einen bekannten Douyin-Livestream über die numerische Raum-ID abrufen – mit normalisiertem Raumkontext, Identität des Hosts, Medien und sichtbaren Zuschauerzahlen.
- Douyin User Videos API
- Douyin Video Comments API
- Douyin Video Detail API
- Douyin Video Search API