TikTok Profiles
TikTok-Profile sind öffentliche Creator- oder Kontoseiten mit Identität, Biografie, Avataren, Verifizierungs- und Datenschutzstatus sowie den sichtbaren Gesamtzahlen zu Followern, Gefolgten, Videos und Likes. Diese Profilsignale eignen sich für die Creator-Suche, den Vergleich von Zielgruppen, die Recherche für Kooperationen und die Anreicherung von Verzeichnissen.
Funktionen der TikTok Profiles API
- Stapelabfrage von BenutzernamenLöst einen oder mehrere öffentliche Creator-Benutzernamen in einer einzigen Anfrage auf.
- Normalisierte Benutzernamen-EingabenNormalisiert Eingaben wie nasa und @nasa, bevor die Profildaten erfasst werden.
- Stabile ProfilidentitätBauen Sie einen Identitätsindex aus Konto-ID, Benutzername, Anzeigename und Profil-URL auf.
- Profil- und ReichweitenfelderLiefert Biografie, Avatar, Verifizierungs- und Datenschutzstatus sowie die Zahlen zu Followern, Gefolgten, Videos und Gesamt-Likes in einem Datensatz.
- Nachvollziehbare Profil-MomentaufnahmenVerfolgen Sie jede Anreicherung und jede wiederkehrende Momentaufnahme über die übermittelte Eingabe (input) und collected_at zurück.
Parameter der TikTok Profiles API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
usernames | Erforderlich | Erforderliche Liste öffentlicher TikTok-Benutzernamen. Jeder Wert darf ein führendes @ enthalten oder weglassen. |
So verwenden Sie die TikTok Profiles API
Beginnen Sie mit einer Liste von Creator-Benutzernamen und erzeugen Sie Datensätze, die bereit für ein Verzeichnis oder ein CRM sind.
- Normalisieren Sie Einträge Ihrer Creator-Liste wie nasa und @nasa und entfernen Sie anschließend Duplikate.
- Senden Sie das Array usernames per POST an /v1/tiktok/profiles und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab. queued und running sind normale Zwischenzustände.
- Lesen Sie nach einem Erfolg data.results.items. Wenn has_more den Wert true hat, fahren Sie mit next_cursor fort.
curl -X POST "https://api.socq.ai/v1/tiktok/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["nasa","@tiktok"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der TikTok Profiles API
- Anreicherung von Talent-Verzeichnissen: Machen Sie aus Listen von Benutzernamen Creator-Karten mit Konto-IDs, Avataren, Biografien, Status und Reichweitenkennzahlen.
- Vorbereitung von Kooperationen: Prüfen Sie vor der Kontaktaufnahme Identität, Veröffentlichungsumfang und Reichweite eines Creators.
- Wachstumsbeobachtung von Creators: Speichern Sie wiederkehrende Momentaufnahmen zu Followern, Videos und Gesamt-Likes für eine gleichbleibende Gruppe von Creators.
- Identitätsabgleich über Datensätze hinweg: Verknüpfen Sie mit Konto-IDs Creator-Datensätze mit zugehörigen Videos und Kommentaren.
Profi-Tipps zur TikTok Profiles API
- Verwenden Sie id als Creator-Schlüssel und behalten Sie username für Suche und Anzeige.
- Bewahren Sie die übermittelte Eingabe auf, damit jeder Datensatz sauber auf Ihre ursprüngliche Talent-Liste zurückführbar bleibt.
- Erfassen Sie in festem Rhythmus und ordnen Sie jeder Momentaufnahme der Kennzahlen das zugehörige collected_at zu.
- Entfernen Sie Duplikate anhand des Benutzernamens, nachdem Sie das führende @ abgeschnitten haben.
- Kombinieren Sie avatar, display_name, biography und profile_url zu aussagekräftigen Creator-Karten.
- Verknüpfen Sie zugehörige Profil-, Video- und Kommentardatensätze über die Konto-ID, um ein umfassenderes Bild eines Creators zu erhalten.
Verwandte APIs
Ergänzend zur TikTok Profiles API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher TikTok-Daten benötigen.
- TikTok Followers List API — Normalisierte Profile aus öffentlichen Follower-Listen erfassen – mit erhaltenem Quellkontext und unterstützten Kennzahlen.
- TikTok Following List API — Öffentliche Profile erfassen, denen TikTok-Konten folgen – mit normalisierter Identität, Bios, sichtbaren Kennzahlen und Kontext des Quellkontos.
- TikTok User Videos API — Öffentliche Videos aus dem Profil-Feed per Benutzername erfassen – mit Bildunterschriften, Creators, Medien, Zeitstempeln, Interaktionen und Kontext des Quellkontos.
- TikTok Audience Demographics API — Per Benutzername sehen, aus welchen Ländern die Follower eines Creators stammen – mit dem Anteil jedes Landes an der Zielgruppe.
- TikTok Similar Accounts API — Die Konten finden, die TikTok als ähnlich zu einem Benutzernamen empfiehlt – mit Follower-Zahlen und Bios.
- TikTok Live Ranking API — Die tägliche LIVE-Creator-Rangliste mit Rängen, geschenkbasierten Punktwerten und Follower-Zahlen abrufen.
- TikTok Hashtags API
- TikTok Comments API
- TikTok Videos API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Live Room Info API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API