tiktok/
following-list

Öffentliche TikTok-Profile erfassen, denen ein oder mehrere Benutzernamen folgen – mit Identität, Bios, Avataren, sichtbaren Kennzahlen und Kontext des Quellkontos als normalisierte Datensätze.

TikTok Following List API

Folgebeziehungen
Profildatensätze
Limits pro Benutzer
0,5 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 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

ParameterErforderlichBeschreibung
usernamesErforderlichErforderliche Liste nicht leerer öffentlicher TikTok-Benutzernamen. Ein führendes @ wird akzeptiert und vor der Erfassung entfernt.
results_limitOptionalMaximale 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.

  1. 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.
  2. Senden Sie usernames und results_limit per POST an /v1/tiktok/following-list und speichern Sie dann die zurückgegebene task_id.
  3. 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.
  4. 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 true

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

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.

Weitere Plattformen entdecken

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

TikTok Following List API — FAQ

TikTok Following List API ist eine Schnittstelle, die öffentliche Profile erfasst, denen ein oder mehrere TikTok-Benutzernamen folgen. Zurückgegeben werden normalisierte Profilidentität, Biografie, Avatar, sichtbare Kennzahlen, kanonische URL und Kontext des Quellkontos.

Senden Sie einen oder mehrere nicht leere Handles im Array usernames. Die Werte dürfen ein führendes @ enthalten oder weglassen; es wird vor der Erfassung entfernt.

Ein normalisierter Datensatz kann die ID des gefolgten Benutzers, Benutzernamen, Anzeigenamen, kanonische Profil-URL, öffentliche Biografie, Avatar, sichtbare Profilkennzahlen, Erfassungszeitpunkt und extra.input_username enthalten.

results_limit hat den Standardwert 100, akzeptiert ganze Zahlen von 20 bis 2.000 und gilt separat für jeden Benutzernamen. Die gespeicherte Gesamtzahl kann niedriger sein, wenn eine sichtbare Liste endet oder doppelte Profilidentitäten entfernt werden.

Datenschutzeinstellungen des Kontos, Einschränkungen der Plattform, nicht verfügbare Listenseiten oder das Ende der öffentlich sichtbaren Beziehungsliste können die zurückgegebenen Datensätze verringern. Prüfen Sie die öffentliche Sichtbarkeit des Quellkontos, bevor Sie es erneut versuchen.

Nein. Betrachten Sie die zurückgegebene Reihenfolge nur als Reihenfolge der Erfassung, sofern keine separate Quelle ausdrücklich Nähe oder Aktualität ausweist.

Jeder gespeicherte normalisierte Profildatensatz kostet 0,5 Credits. Die Abrechnung richtet sich nach der tatsächlichen Zahl gespeicherter Datensätze, daher fällt für eine leere Aufgabe keine Ergebnisgebühr an.