tiktok/
user-audience

Per Benutzername abrufen, in welchen Ländern die Follower eines öffentlichen TikTok-Kontos leben – mit Ländername, ISO-Code, Anteil an der Zielgruppe und Zahl der Follower in der Stichprobe.

TikTok Audience Demographics API

Benutzername als Eingabe
Länder der Follower
Anteil pro Land
20 Credits pro Anfrage
Bereit
Bereit

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

README

Von SocQ · Aktualisiert am

TikTok Audience Demographics

Die Länder der Zielgruppe eines TikTok-Kontos zeigen, wo seine Follower leben – angegeben als Anteil jedes Landes an einer Follower-Stichprobe, zusammen mit der Zahl der Follower, auf denen dieser Anteil beruht. TikTok Analytics zeigt diese Ansicht nur dem Kontoinhaber, deshalb rufen Marken, Agenturen und Analysten sie per Benutzername ab, wenn sie einen Creator prüfen, den sie nicht selbst betreuen.

Funktionen der TikTok Audience Demographics API

  • Jeder öffentliche Benutzername, kein LoginSenden Sie einen öffentlichen Benutzernamen mit oder ohne @ und erhalten Sie die Länderverteilung der Follower, ohne Zugriff auf das Konto oder eine TikTok-Sitzung.
  • Name, ISO-Code, Anteil und AnzahlJeder Eintrag in audience_countries enthält den Ländernamen, einen zweistelligen country_code, einen Anteil von 0 bis 1 und die Zahl der Follower aus der Stichprobe, auf der er beruht.
  • Größter Markt zuerstDie Länder kommen nach Anteil sortiert an, sodass die ersten Zeilen zeigen, wo die meisten Follower sitzen, und der Rest die kleineren Märkte abbildet.

Parameter der TikTok Audience Demographics API

ParameterErforderlichBeschreibung
usernameErforderlichDer zu analysierende TikTok-Benutzername, mit oder ohne führendes @.

So verwenden Sie die TikTok Audience Demographics API

Senden Sie einen Benutzernamen, fragen Sie die Aufgabe ab und lesen Sie einen Zielgruppen-Datensatz aus.

  1. Senden Sie {"username": "khaby.lame"} per POST an /v1/tiktok/user-audience.
  2. Fragen Sie GET /v1/tasks/{task_id} alle paar Sekunden ab, bis status den Wert succeeded hat.
  3. Lesen Sie den einzelnen Datensatz in results.items und gehen Sie die Einträge von audience_countries durch.
curl -X POST "https://api.socq.ai/v1/tiktok/user-audience" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"khaby.lame"}'

# The result has one record; audience_countries[].share is a fraction from 0 to 1.

Anwendungsfälle der TikTok Audience Demographics API

  • Creator für einen einzelnen Markt buchen: Bevor Sie eine Kampagne für ein einziges Land bezahlen, lesen Sie ab, welchen Anteil dieses Land an den Followern des Creators hat – eine große Reichweite, die woanders lebt, erreicht Ihre Käufer nicht.
  • Prüfen, ob eine Geo-Targeting-Aktion wirkt: Wenn Sie in einem neuen Land Reichweite aufbauen, fragen Sie denselben Benutzernamen regelmäßig ab und vergleichen den Anteil dieses Landes zwischen den Zeitstempeln von collected_at.
  • Märkte ausschließen, die Sie nicht beliefern: Shops und Apps mit fester Länderliste addieren die Anteile ihrer country_code-Werte und sortieren Creator aus, deren Follower überwiegend außerhalb dieser Länder leben.

Profi-Tipps zur TikTok Audience Demographics API

  • Teilen Sie count durch share, um die Größe der Follower-Stichprobe zu sehen; ist sie klein, behandeln Sie Länder mit ähnlichen Anteilen als gleichauf statt als Rangfolge.
  • Fassen Sie country_code-Werte vor dem Vergleich zu eigenen Regionen wie EU oder LATAM zusammen, denn Kampagnen zielen meist auf eine Region und nicht auf ein einzelnes Land.

Ergänzend zur TikTok Audience Demographics 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 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 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 Audience Demographics API — FAQ

TikTok Audience Demographics API ist eine Schnittstelle zum Abrufen der Länder, in denen die Follower eines öffentlichen TikTok-Kontos leben, anhand des Benutzernamens. Sie liefert einen Datensatz mit Name, ISO-Code, Anteil an der Zielgruppe und Zahl der Follower aus der Stichprobe für jedes Land.

Ja, bei jedem öffentlichen Konto. TikTok zeigt die Standorte der Follower nur dem Kontoinhaber, für diese Abfrage genügt dagegen der Benutzername.

Nein. Der Datensatz enthält nur das Land der Follower, ohne Aufschlüsselung nach Alter, Geschlecht oder Stadt.

Ja, senden Sie Ihren eigenen Benutzernamen und lesen Sie die Länder als Daten aus, statt TikTok Analytics zu öffnen. Das lohnt sich vor allem für Berichte über mehrere Konten, die Sie betreuen.

Jeder Anteil stammt aus einer Stichprobe der Follower, und count nennt, wie viele Follower aus der Stichprobe dahinterstehen. Ein Land mit kleinem count ist ein grobes Signal und keine exakte Zahl.

Pro Anfrage. Ein Benutzername kostet pauschal 20 Credits, egal wie viele Länder zurückkommen; existiert der Benutzername nicht, schlägt die Aufgabe fehl und die Credits werden erstattet.