TikTok Followers List
Öffentlich sichtbare TikTok-Follower-Listen zeigen Kontoidentitäten, Biografien, Profillinks und verfügbare Zahlen zu Zielgruppe oder Aktivität. Diese Datensätze eignen sich für Stichproben der Zielgruppe, die Suche nach neuen Creators, Warteschlangen für die Anreicherung und die wiederkehrende Recherche in öffentlichen Listen.
Funktionen der TikTok Followers List API
- Erfassung über mehrere KontenErfassen Sie Follower zu einem oder mehreren öffentlichen Benutzernamen, wobei results_limit unabhängig auf jedes übergebene Konto angewendet wird.
- Begrenzter Durchlauf des FeedsDurchläuft unterstützte Follower-Seiten intern, bis das Limit pro Konto, eine nicht verfügbare nächste Seite oder die Obergrenze der Erfassung erreicht ist.
- Normalisierte ProfildatensätzeLiefert Follower-ID, Benutzernamen, Anzeigenamen, Biografie, Avatar-Verweis, Profil-URL und unterstützte öffentliche Kennzahlen in einer einheitlichen Profilstruktur.
- Erhaltener QuellkontextBehält den normalisierten übergebenen Handle in extra.input_username für den beibehaltenen Follower-Datensatz bei.
- Duplikatkontrolle auf AufgabenebeneUnterdrückt wiederholte Follower-Identitäten innerhalb der Aufgabe anhand der normalisierten ID oder Profil-URL, bevor die Ergebnisse gespeichert und paginiert werden.
Parameter der TikTok Followers List API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
usernames | Erforderlich | Erforderliche, nicht leere Liste öffentlicher TikTok-Benutzernamen. Die Werte dürfen ein führendes @ enthalten oder weglassen; numerische Konto-IDs, Profil-URLs und Cursor-Werte werden nicht akzeptiert. |
results_limit | Optional | Optionale ganze Zahl von 20 bis 2.000, Standardwert 100. Das Limit gilt separat für jeden übergebenen Benutzernamen und ist eine Obergrenze, keine Garantie für Vollständigkeit. |
So verwenden Sie die TikTok Followers List API
Senden Sie bekannte öffentliche Handles, warten Sie auf die asynchrone Aufgabe und blättern Sie durch die gespeicherten Profildatensätze.
- Entfernen Sie überflüssige Leerzeichen und ein optionales führendes @ für Ihre eigene Deduplizierung und wählen Sie öffentliche TikTok-Benutzernamen.
- Senden Sie usernames und ein results_limit pro Benutzername von 20 bis 2.000 per POST an /v1/tiktok/followers-list.
- Speichern Sie task_id und fragen Sie /v1/tasks/{task_id} ab; queued, running und retrying sind normale Zwischenzustände.
- Lesen Sie nach einem Erfolg data.results.items und übergeben Sie next_cursor an denselben Aufgaben-Endpunkt, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/tiktok/followers-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 follow next_cursor while has_more is trueAnwendungsfälle der TikTok Followers List API
- Öffentliche Zielgruppen-Stichproben: Erstellen Sie eine begrenzte Stichprobe öffentlich sichtbarer Follower-Profile für eine qualitative Prüfung der Zielgruppe.
- Warteschlangen zur Entdeckung von Creators: Erfassen Sie Follower-Benutzernamen und Profillinks, die eine manuelle Prüfung oder eine spätere Anreicherungsaufgabe mit TikTok Profiles speisen können.
- Wiederkehrende Listenrecherche: Speichern Sie Stichproben mit Zeitstempel aus denselben öffentlichen Konten, um Veränderungen bei den jeweils verfügbaren Identitäten zu beobachten.
- Eingaben für Profilverzeichnisse: Wandeln Sie Einträge öffentlicher Follower-Listen in einheitliche Felder zu Identität, Biografie, Avatar und Kennzahlen für interne Verzeichnisse um.
Profi-Tipps zur TikTok Followers List API
- Normalisieren Sie die Groß- und Kleinschreibung und entfernen Sie ein führendes @, bevor Sie clientseitig deduplizieren; @name und name können sonst gleichwertige Abfragen bei der Quelle auslösen.
- Behandeln Sie results_limit als Obergrenze pro Benutzername: Zwei Benutzernamen mit dem Standardwert 100 ergeben eine Schätzung von 200 Ergebnissen, nicht von 100.
- Behalten Sie extra.input_username bei, nutzen Sie diesen Endpunkt aber nicht für eine exakte Analyse gemeinsamer Follower, weil die Deduplizierung auf Aufgabenebene pro Follower-Identität nur einen Quellkontext behält.
- Verwenden Sie den Follower-Benutzernamen und nicht die numerische id, wenn Sie ein zurückgegebenes Konto an einen Endpunkt übergeben, der TikTok-Benutzernamen akzeptiert.
- Senden Sie next_cursor nicht in einer neuen Erfassungsanfrage; er blättert nur durch Ergebnisse, die für dieselbe erfolgreiche Aufgabe bereits gespeichert sind.
- Behandeln Sie metrics als nullbar und created_at als null, weil Follower-Zeilen der Quelle diese Felder nicht immer bereitstellen.
- Rechnen Sie bei privaten, eingeschränkten, nicht verfügbaren oder sehr großen Konten mit weniger Datensätzen und behandeln Sie Avatar-Verweise als Quell-URLs, die ablaufen können.
Verwandte APIs
Ergänzend zur TikTok Followers 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 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