AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

TikTok-Zielgruppendemografie über die API

Die API for Business von TikTok liefert die Follower-Demografie eines TikTok-Kontos über GET /business/get/: audience_ages, audience_genders, audience_countries und audience_cities, jeweils als Liste von Anteilen der Follower, für Konten mit mindestens 100 Followern. Die stündliche Follower-Aktivität steht als audience_activity in den Kennzahlen jedes Tages, für Konten mit Advanced Access oder Verified Business Accounts und ebenfalls 100 Followern. Alle Felder benötigen den Scope user.insights.

easyCoexistence liest die Follower-Demografie eines TikTok-Kontos mit get_social_insights aus Claude, ChatGPT oder Ihrem eigenen Code: Fragen Sie audience_ages, audience_genders, audience_countries, audience_cities oder audience_activity ab, und Sie erhalten die Listen von TikTok unverändert.

100

Anzahl der Follower, die ein Konto braucht, bevor TikTok die Aufschlüsselungen nach Alter, Geschlecht, Land und Stadt zurückgibt.

5 groups

Altersgruppen in audience_ages: 18-24, 25-34, 35-44, 45-54 und 55+.

UTC+0

Zeitzone von audience_activity, der stündlichen Zahl der Follower, die auf TikTok aktiv sind.

24 to 48 h

Übliche Verzögerung bei audience_countries, audience_genders und audience_activity, die TikTok offline berechnet.

Welche Demografiedaten liefert der Konto-Endpoint?

GET /business/get/ liefert sie, wenn sie in fields genannt werden. Die vier Aufschlüsselungen stehen oben in data, je eine Liste pro Dimension, und die stündliche Aktivität steht in metrics, je Tag ein Satz:

  • audience_ages: der Anteil der Follower in jeder Altersgruppe, 18-24, 25-34, 35-44, 45-54 und 55+.
  • audience_genders: der Anteil der Follower nach Geschlecht: Female, Male oder Other.
  • audience_countries: der Anteil der Follower je Land oder Region, als ISO 3166-1 alpha-2-Code.
  • audience_cities: der Anteil der Follower je Stadt, nach city_name.
  • audience_activity: für jeden Tag die Follower, die in jeder Stunde auf TikTok aktiv sind, als hour und count.

Wie fordert man sie an?

Mit den Feldnamen in fields, einem JSON-Array, und einem Datumsbereich in UTC für die täglichen Kennzahlen, die audience_activity enthalten. start_date und end_date reichen bis zu 60 Tage zurück. Ohne sie gibt TikTok die 7 Tage bis zum Vortag der Anfrage zurück:

Follower demographics for a TikTok account
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/get/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'fields=["audience_ages","audience_genders","audience_countries","audience_cities","audience_activity"]' \
  --data-urlencode 'start_date=2026-10-24' \
  --data-urlencode 'end_date=2026-10-30'

Wie sieht die Antwort aus?

Jede Aufschlüsselung ist eine Liste von Objekten, die eine Gruppe mit ihrem Prozentwert verbinden. Jeder Tag in metrics enthält sein Datum und eine Liste audience_activity mit Stunden. Die Werte unten sind die Beispiele von TikTok selbst, auf die Geschlechterliste und einige Stunden gekürzt:

Demographics in the /business/get/ response
{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "audience_genders": [
      { "gender": "Female", "percentage": 0.7554470336505679 },
      { "gender": "Male", "percentage": 0.24455296634943213 }
    ],
    "metrics": [
      {
        "date": "<DATE>",
        "audience_activity": [
          { "hour": "20", "count": 1 },
          { "hour": "23", "count": 4 },
          { "hour": "7", "count": 4 }
        ]
      }
    ]
  }
}

Welche Konten erhalten welche Aufschlüsselungen?

Anteile nach Alter, Geschlecht, Land und Stadt gibt es, sobald das Konto mindestens 100 Follower hat. Das Beispiel von TikTok für ein Konto mit 13 Followern liefert diese Listen leer zurück. audience_activity braucht ebenfalls 100 Follower und zusätzlich Advanced Access. Dieser Zugang entsteht durch die Verknüpfung mit einem TikTok-for-Business-Konto oder einem nicht verifizierten Business Center, oder mit einem Verified Business Account. Alle diese Felder benötigen den Scope user.insights am Token.

Wie aktuell sind die Demografiedaten?

Ein bis zwei Tage hinterher. TikTok führt audience_countries, audience_genders und audience_activity unter den Feldern, die üblicherweise 24 bis 48 Stunden verzögert sind, in UTC, und nennt für Alter und Städte dieselbe Aktualisierungszeit. Die Zahlen stammen aus TikTok Analytics, das der Kontoinhaber nach dem Veröffentlichen eines ersten Videos in der App aktiviert. Daten von davor sind nicht verfügbar. TikTok stützt die Demografie auf mehrere Faktoren, unter anderem auf das, was Nutzer in ihren Profilen angeben.

Worin unterscheiden sich Follower-Demografie und Zuschauer eines Videos?

Sie beschreiben unterschiedliche Personen. Die Kontolisten erfassen die Follower. /business/video/list/ liefert Aufschlüsselungen der Personen, die einen Beitrag gesehen haben: audience_genders, audience_countries und audience_cities mit jeweils bis zu 10 Einträgen, sowie audience_types, das Zuschauer in neu und wiederkehrend sowie Follower und Nicht-Follower aufteilt. Dafür braucht man den Scope video.insights statt user.insights.

Wie liest easyCoexistence sie aus?

Mit get_social_insights für das Konto: object_id weglassen, die Feldnamen als metrics auflisten und start_date sowie end_date in params übergeben, wenn audience_activity für bestimmte Tage gewünscht ist. Die Listen von TikTok werden unverändert zurückgegeben, sodass Anteile und Stunden genau so zu lesen sind, wie oben beschrieben.

Follower demographics through MCP
get_social_insights {
  "account_id": "<ACCOUNT_ID>",
  "metrics": ["audience_ages", "audience_genders", "audience_countries", "audience_cities", "audience_activity"],
  "params": { "start_date": "2026-10-24", "end_date": "2026-10-30" }
}

Häufige Fehler

  • Erwartung von Aufschlüsselungen bei einem kleinen Konto. TikTok liefert Anteile nach Alter, Geschlecht, Land und Stadt erst ab 100 Followern, und das Beispiel für ein Konto mit 13 Followern zeigt die Listen leer.
  • Stündliche Werte von audience_activity als Ortszeit lesen. TikTok meldet sie in UTC+0, also vor der Planung von Beiträgen in die Zeitzone des Publikums umrechnen.
  • Follower-Demografie mit Zuschauer-Demografie verwechseln. Die Kontolisten beschreiben die Follower; audience_countries eines Videos beschreibt die Personen, die es gesehen haben.
  • audience_activity bei einem persönlichen Konto erwarten. TikTok liefert es nur für Konten mit Advanced Access oder Verified Business Accounts, die mindestens 100 Follower haben.
Mit EasyCoexistence

Ab US$ 9 pro Verbindung und Monat, sinkend bis auf US$ 0.75, je mehr Verbindungen Sie hinzufügen, mit einer kostenlosen Testphase von 3 Tagen.

Häufig gestellte Fragen

Kann die TikTok API das Alter und Geschlecht meiner Follower anzeigen?

Ja. /business/get/ liefert audience_ages und audience_genders, Anteile der Follower je Gruppe, sobald das Konto mindestens 100 Follower hat und der Token den Scope user.insights besitzt.

Welche Altersgruppen verwendet die TikTok API?

18-24, 25-34, 35-44, 45-54 und 55+, jeweils mit dem Anteil der Follower in dieser Gruppe.

Sagt die TikTok API, wann meine Follower online sind?

audience_activity liefert die Follower, die pro Stunde auf TikTok aktiv sind, in UTC+0, innerhalb der Kennzahlen jedes Tages, für Konten mit Advanced Access oder Verified Business Accounts und mindestens 100 Followern.

Wie gibt die TikTok API die Länder der Follower an?

Als ISO 3166-1 alpha-2-Codes für Länder oder Regionen in audience_countries, jeweils mit dem Anteil der Follower von dort.

Weiterlesen

Verbinden Sie Ihren ersten Kanal in zwei Minuten.

Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.

  • 3 Tage kostenlos
  • Jederzeit kündbar
  • Nur offizielle APIs
  • Überwacht rund um die Uhr (24/7)

Verifiziert am