TikTok Following List
Die Listen gefolgter Profile auf TikTok enthalten die öffentlichen Profile, denen ein Konto sichtbar folgt – mit Benutzer-IDs, Benutzernamen, Anzeigenamen, Biografien, Avataren, Profillinks und sichtbaren Kontokennzahlen. Diese Beziehungs- und Profildatensätze eignen sich für die Recherche zu Interessennetzwerken, die Entdeckung von Creators, die Abbildung öffentlicher Beziehungen und die Anreicherung von Profildatensätzen.
Funktionen der TikTok Following List API
- Beziehungen vom Quellkonto zu ProfilenErfasst gefolgte Profildatensätze für jeden übergebenen öffentlichen Benutzernamen und behält den Quell-Handle in extra.input_username bei.
- Normalisierte Identität gefolgter ProfileLiefert für jedes gespeicherte Mitglied der Beziehung eine stabile Benutzer-ID, den Benutzernamen, den Anzeigenamen und die kanonische TikTok-Profil-URL.
- Öffentlicher ProfilkontextEnthält Biografietext, einen Avatar-Verweis und die sichtbaren Kontokennzahlen, die mit dem gefolgten Profil bereitgestellt werden.
- Begrenzte Erfassung pro BenutzerWendet results_limit separat auf jeden Benutzernamen an, während die verfügbaren Listendaten durchgeblättert und gespeicherte Profile anhand stabiler Identität dedupliziert werden.
Parameter der TikTok Following List API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
usernames | Erforderlich | Erforderliche Liste nicht leerer öffentlicher TikTok-Benutzernamen. Ein führendes @ wird akzeptiert und vor der Erfassung entfernt. |
results_limit | Optional | Maximale Anzahl angeforderter Datensätze gefolgter Profile pro Benutzername. Standardwert ist 100, zulässig sind ganze Zahlen von 20 bis 2.000. |
So verwenden Sie die TikTok Following List API
Senden Sie öffentliche Quell-Handles und lesen Sie dann die normalisierten Datensätze gefolgter Profile aus der abgeschlossenen asynchronen Aufgabe.
- Bereiten Sie einen oder mehrere öffentliche TikTok-Benutzernamen vor, mit oder ohne führendes @, und wählen Sie für jeden Benutzernamen ein results_limit von 20 bis 2.000.
- Senden Sie usernames und results_limit per POST an /v1/tiktok/following-list und speichern Sie dann die zurückgegebene task_id.
- Fragen Sie GET /v1/tasks/{task_id} ab, solange die Aufgabe queued, running oder retrying ist, und hören Sie auf, wenn sie erfolgreich ist oder fehlschlägt.
- Lesen Sie nach einem Erfolg data.results.items; ist has_more gleich true, fordern Sie dieselbe Aufgabe mit next_cursor an, um die nächste Seite der gespeicherten Ergebnisse zu laden.
curl -X POST "https://api.socq.ai/v1/tiktok/following-list" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["@loganpaul"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and pass next_cursor while data.results.has_more is trueAnwendungsfälle der TikTok Following List API
- Recherche zu Interessennetzwerken: Nutzen Sie den Kontext des Quellkontos mit den IDs, Benutzernamen und Biografien der gefolgten Profile, um die öffentlichen Interessen rund um ein bekanntes Konto zu untersuchen.
- Entdeckung von Creators ausgehend von Ausgangskonten: Prüfen Sie Anzeigenamen, Biografien, Avatare, Profillinks und sichtbare Kennzahlen, um aus den öffentlichen Folgebeziehungen eines Kontos eine Kandidatenliste von Profilen zusammenzustellen.
- Anreicherung von Profildatensätzen: Ergänzen Sie benutzernamenbasierte Profildatensätze um stabile IDs, kanonische URLs, öffentliche Biografien, Avatare und sichtbare Kontokennzahlen.
Profi-Tipps zur TikTok Following List API
- Entfernen Sie ein führendes @ und deduplizieren Sie die Benutzernamen vor dem Senden, damit gleichwertige Handles keine doppelte Arbeit für dasselbe Quellkonto auslösen.
- Legen Sie results_limit für jeden Benutzernamen nach der benötigten Tiefe fest; bei größeren Eingabelisten können bis zu usernames × results_limit Datensätze entstehen, bevor Listenenden und Deduplizierung greifen.
- Verwenden Sie id als primären Profilschlüssel, weichen Sie bei fehlender id auf url aus und behalten Sie extra.input_username für die Nachvollziehbarkeit der Quelle bei.
- Behandeln Sie leere oder kurze Ergebnisse als Folge der öffentlichen Sichtbarkeit und prüfen Sie die Datenschutzeinstellungen des Kontos und die Verfügbarkeit der Liste, bevor Sie es erneut versuchen.
- Deuten Sie die zurückgegebene Reihenfolge nicht als Aktualität oder Stärke der Beziehung, es sei denn, Ihre nachgelagerten Daten liefern dieses Signal ausdrücklich.
Verwandte APIs
Ergänzend zur TikTok Following List API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher TikTok-Daten benötigen.
- TikTok Profiles API — Öffentliche Profilidentität, Bios, Kontomerkmale und Zahlen zur Zielgruppe per Benutzername abrufen.
- TikTok Followers List API — Normalisierte Profile aus öffentlichen Follower-Listen erfassen – mit erhaltenem Quellkontext und unterstützten Kennzahlen.
- 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