InloggenGratis proefperiode starten
easyCoexistence Officiële API's

TikTok-doelgroepdemografie via de API

De API for Business van TikTok geeft de volgersdemografie van een TikTok-account terug via GET /business/get/: audience_ages, audience_genders, audience_countries en audience_cities, elk een lijst met aandelen van de volgers, voor accounts met minstens 100 volgers. De uurlijkse volgersactiviteit komt als audience_activity in de metrics van elke dag, voor accounts met Advanced Access of Verified Business Accounts en dezelfde 100 volgers. Alles vereist de scope user.insights.

easyCoexistence leest de volgersdemografie van een TikTok-account uit met get_social_insights vanuit Claude, ChatGPT of je eigen code: vraag om audience_ages, audience_genders, audience_countries, audience_cities of audience_activity en het geeft de lijsten van TikTok zoals ze zijn terug.

100

Volgers die een account nodig heeft voordat TikTok de verdelingen naar leeftijd, geslacht, land en stad teruggeeft.

5 groups

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

UTC+0

Tijdzone van audience_activity, het uurlijkse aantal volgers dat actief is op TikTok.

24 to 48 h

Gebruikelijke vertraging voor audience_countries, audience_genders en audience_activity, die TikTok offline berekent.

Welke demografie geeft het account-endpoint terug?

GET /business/get/ geeft ze terug wanneer ze in fields staan genoemd. De vier verdelingen staan bovenaan data, één lijst per dimensie, en de uurlijkse activiteit staat in metrics, één set per dag:

  • audience_ages: het aandeel volgers per leeftijdsgroep: 18-24, 25-34, 35-44, 45-54 en 55+.
  • audience_genders: het aandeel volgers per geslacht: Female, Male of Other.
  • audience_countries: het aandeel volgers per land of regio, als ISO 3166-1 alpha-2-code.
  • audience_cities: het aandeel volgers per stad, op basis van city_name.
  • audience_activity: voor elke dag de volgers die per uur actief zijn op TikTok, als hour en count.

Hoe vraag je ze op?

Met de veldnamen in fields, een JSON-array, en een datumbereik in UTC voor de dagelijkse metrics die audience_activity bevatten. start_date en end_date reiken tot 60 dagen terug, en zonder die velden geeft TikTok de 7 dagen tot en met de dag voor het verzoek terug:

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'

Hoe ziet het antwoord eruit?

Elke verdeling is een lijst met objecten die een groep koppelt aan het percentage, en elke dag in metrics bevat de datum en een audience_activity-lijst met uren. De onderstaande waarden zijn de eigen voorbeelden van TikTok, ingekort tot de geslachtslijst en een paar uren:

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 }
        ]
      }
    ]
  }
}

Welke accounts krijgen welke verdelingen?

Aandelen naar leeftijd, geslacht, land en stad verschijnen zodra het account minstens 100 volgers heeft; het eigen voorbeeld van TikTok voor een account met 13 volgers geeft die lijsten leeg terug. audience_activity vereist ook 100 volgers, en daarbovenop een account met Advanced Access, dat je krijgt door het te koppelen aan een TikTok for Business-account of een niet-geverifieerd Business Center, of een Verified Business Account. Al deze velden vereisen de scope user.insights op het token.

Hoe actueel zijn de demografische gegevens?

Een dag of twee achter. TikTok noemt audience_countries, audience_genders en audience_activity onder de velden die gewoonlijk 24 tot 48 uur achterlopen, in UTC, en geeft dezelfde updatetijd voor leeftijden en steden. De cijfers komen uit TikTok Analytics, dat de eigenaar in de app aanzet na het plaatsen van een eerste video; gegevens van daarvoor zijn niet beschikbaar. TikTok baseert de demografie op meerdere factoren, waaronder wat gebruikers in hun profielen invullen.

Hoe verschilt de volgersdemografie van de kijkers van een video?

Ze beschrijven verschillende mensen. De accountlijsten gaan over de volgers. /business/video/list/ geeft verdelingen terug van de mensen die één bericht hebben bekeken: audience_genders, audience_countries en audience_cities met elk maximaal 10 items, en audience_types, dat kijkers splitst in nieuw en terugkerend, volgers en niet-volgers. Die vereisen de scope video.insights in plaats van user.insights.

Hoe leest easyCoexistence ze uit?

Met get_social_insights op het account: laat object_id weg, zet de veldnamen als metrics, en geef start_date en end_date mee in params wanneer je audience_activity voor bepaalde dagen wilt. Het geeft de lijsten van TikTok zoals ze zijn terug, dus de aandelen en uren lezen precies zoals hierboven.

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" }
}

Veelgemaakte fouten

  • Verwachten dat een klein account verdelingen krijgt. TikTok geeft aandelen naar leeftijd, geslacht, land en stad vanaf 100 volgers, en het voorbeeld voor een account met 13 volgers toont de lijsten leeg.
  • audience_activity-uren als lokale tijd lezen. TikTok rapporteert ze in UTC+0, dus verschuif ze naar de tijdzone van het publiek voordat je posts plant.
  • Volgersdemografie behandelen als kijkersdemografie. De accountlijsten beschrijven de volgers; de audience_countries van een video beschrijven de mensen die hem bekeken.
  • Verwachten dat audience_activity op een persoonlijk account verschijnt. TikTok geeft die terug voor accounts met Advanced Access of Verified Business Accounts die minstens 100 volgers hebben.
Dit doen met EasyCoexistence

US$ 9 tot US$ 0.75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met een gratis proefperiode van 3 dagen.

Veelgestelde vragen

Kan de TikTok-API de leeftijd en het geslacht van mijn volgers tonen?

Ja. /business/get/ geeft audience_ages en audience_genders terug, aandelen van volgers per groep, zodra het account minstens 100 volgers heeft en het token user.insights heeft.

Welke leeftijdsgroepen gebruikt de TikTok-API?

18-24, 25-34, 35-44, 45-54 en 55+, elk met het aandeel volgers erin.

Vertelt de TikTok-API wanneer mijn volgers online zijn?

audience_activity geeft de volgers die per uur actief zijn op TikTok, in UTC+0, binnen de metrics van elke dag, voor Advanced Access of Verified Business Accounts met 100 volgers of meer.

Hoe geeft de TikTok-API volgerslanden aan?

Als ISO 3166-1 alpha-2-landen- of regiocodes in audience_countries, elk met het aandeel volgers vandaan.

Lees verder

Koppel je eerste kanaal in twee minuten.

Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.

  • 3 dagen gratis
  • Op elk moment opzegbaar
  • Alleen officiële API's
  • 24/7 bewaakt

Geverifieerd op