tiktok/
profiles

Öffentliche TikTok-Profile zu einem oder mehreren Benutzernamen abrufen – mit normalisierten Angaben zu Identität, Biografie, Avataren, Kontomerkmalen und den sichtbaren Reichweitenzahlen.

TikTok Profiles API

Creator-Datensätze
Identitätsauflösung
Profil-Momentaufnahmen
0,6 Credits pro Ergebnis
Bereit
Bereit

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

README

Von SocQ · Aktualisiert am

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

ParameterErforderlichBeschreibung
usernamesErforderlichErforderliche 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.

  1. Normalisieren Sie Einträge Ihrer Creator-Liste wie nasa und @nasa und entfernen Sie anschließend Duplikate.
  2. Senden Sie das Array usernames per POST an /v1/tiktok/profiles und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab. queued und running sind normale Zwischenzustände.
  4. 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 true

Anwendungsfä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.

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.

Weitere Plattformen entdecken

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

TikTok Profiles API — FAQ

TikTok Profiles API ruft öffentlich sichtbare Profildatensätze zu einem oder mehreren TikTok-Benutzernamen ab. Sie liefert normalisierte Angaben zu Identität, Biografie, Avataren, Verifizierungs- und Datenschutzmerkmalen sowie die Zahlen zu Followern, Gefolgten, Videos und Likes.

Tragen Sie öffentliche Benutzernamen in das Array usernames ein. Beide Schreibweisen, exampleuser und @exampleuser, werden akzeptiert.

Ja. usernames akzeptiert mehrere Werte, die in derselben asynchronen Aufgabe verarbeitet und als normalisierte Profildatensätze zurückgegeben werden.

Die Ergebnisse enthalten Konto-ID, Benutzername, Anzeigename, Profil-URL, öffentliche Biografie und Avatar sowie, soweit vorhanden, Kontostatus, Erstellungszeitpunkt und Regionsangaben.

Die Ergebnisse enthalten die öffentlich sichtbaren Zahlen zu Followern, Gefolgten, Videos und Gesamt-Likes, wie sie bei der Erfassung beobachtet wurden.

Die Kennzahlen entsprechen dem Zeitstempel collected_at. Wenn Sie wiederkehrende Ergebnisse für dieselben Konten speichern, entsteht eine Folge öffentlicher Profil-Momentaufnahmen.

Verwenden Sie die Konto-ID und den normalisierten Benutzernamen, um Creator-Felder aus Videos, Search und Hashtags mit Autorenfeldern aus Comments zu verknüpfen.

Jedes zurückgegebene normalisierte Profilergebnis kostet 0,6 Credits.