Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Demografia de audiência TikTok através da API

A API for Business do TikTok devolve a demografia de seguidores de uma conta a partir de GET /business/get/: audience_ages, audience_genders, audience_countries e audience_cities, cada uma uma lista de quotas de seguidores, para contas com pelo menos 100 seguidores. A atividade horária de seguidores chega como audience_activity nas métricas de cada dia, para contas com Advanced Access ou Contas Empresariais Verificadas e os mesmos 100 seguidores. Todas exigem o âmbito user.insights.

O easyCoexistence lê as demografias de seguidores de uma conta TikTok com get_social_insights, a pedido do Claude, do ChatGPT ou do seu próprio código: peça audience_ages, audience_genders, audience_countries, audience_cities ou audience_activity e devolve as listas do TikTok tal como estão.

100

Seguidores necessários para que o TikTok devolva as desagregações por idade, género, país e cidade.

5 groups

Grupos etários em audience_ages: 18-24, 25-34, 35-44, 45-54 e 55+.

UTC+0

Fuso horário de audience_activity, a contagem horária de seguidores ativos no TikTok.

24 to 48 h

Atraso habitual de audience_countries, audience_genders e audience_activity, que o TikTok calcula offline.

Que dados demográficos devolve o endpoint da conta?

GET /business/get/ devolve-os quando são indicados em fields. As quatro desagregações ficam no topo de data, uma lista por dimensão, e a atividade horária fica em metrics, um conjunto por dia:

  • audience_ages: a quota de seguidores em cada grupo etário, 18-24, 25-34, 35-44, 45-54 e 55+.
  • audience_genders: a quota de seguidores por género: Female, Male ou Other.
  • audience_countries: a quota de seguidores por país ou região, como código ISO 3166-1 alpha-2.
  • audience_cities: a quota de seguidores por cidade, através de city_name.
  • audience_activity: para cada dia, os seguidores ativos no TikTok em cada hora, como hour e count.

Como os pedem?

Com os nomes dos campos em fields, num array JSON, e um intervalo de datas em UTC para as métricas diárias que incluem audience_activity. start_date e end_date recuam até 60 dias; sem eles, o TikTok devolve os 7 dias que terminam na véspera do pedido:

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'

Como é a resposta?

Cada desagregação é uma lista de objetos que associa um grupo à sua percentagem, e cada dia em metrics traz a data e uma lista audience_activity com as horas. Os valores abaixo são exemplos do próprio TikTok, reduzidos à lista de género e a algumas horas:

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

Que contas recebem que desagregações?

As quotas por idade, género, país e cidade surgem quando a conta tem pelo menos 100 seguidores; o exemplo do próprio TikTok para uma conta com 13 seguidores devolve essas listas vazias. audience_activity também exige 100 seguidores e, além disso, uma conta com Advanced Access, que se obtém ao ligá-la a uma conta TikTok for Business ou a um Centro de Negócios não verificado, ou uma Conta Empresarial Verificada. Todos estes campos exigem o âmbito user.insights no token.

Quão atuais são as demografias?

Com um ou dois dias de atraso. O TikTok indica audience_countries, audience_genders e audience_activity entre os campos que costumam atrasar 24 a 48 horas, em UTC, e dá a mesma hora de atualização para idades e cidades. Os números vêm do TikTok Analytics, que o proprietário ativa na aplicação depois de publicar um primeiro vídeo, e os dados anteriores a isso não estão disponíveis. O TikTok baseia as demografias em vários fatores, incluindo o que os utilizadores põem nos perfis.

Em que se diferenciam as demografias dos seguidores e as dos espectadores de um vídeo?

Descrevem pessoas diferentes. As listas da conta cobrem os seguidores. /business/video/list/ devolve desagregações das pessoas que viram uma publicação: audience_genders, audience_countries e audience_cities, até 10 entradas cada, e audience_types, que separa os espectadores em novos e recorrentes, seguidores e não seguidores. Estes exigem o âmbito video.insights em vez de user.insights.

Como é que o easyCoexistence as lê?

Com get_social_insights sobre a conta: omita object_id, indique os nomes dos campos como metrics e passe start_date e end_date em params quando quiser audience_activity de dias específicos. Devolve as listas do TikTok tal como estão, pelo que as quotas e as horas se leem exatamente como acima.

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

Erros comuns

  • Esperar desagregações numa conta pequena. O TikTok devolve as quotas por idade, género, país e cidade a partir de 100 seguidores, e o exemplo para uma conta com 13 seguidores mostra as listas vazias.
  • Ler as horas de audience_activity como hora local. O TikTok as indica em UTC+0, por isso converta-as para o fuso horário do público antes de planear publicações.
  • Tratar as demografias de seguidores como demografias de espectadores. As listas da conta descrevem os seguidores; o audience_countries de um vídeo descreve as pessoas que o viram.
  • Esperar audience_activity numa conta pessoal. O TikTok devolve-o para contas com Advanced Access ou Contas Empresariais Verificadas com pelo menos 100 seguidores.
Fazer isto com a EasyCoexistence

De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias grátis.

Perguntas frequentes

A API do TikTok pode mostrar a idade e o género dos meus seguidores?

Sim. GET /business/get/ devolve audience_ages e audience_genders, quotas de seguidores por grupo, quando a conta tem pelo menos 100 seguidores e o token tem user.insights.

Que grupos etários usa a API do TikTok?

18-24, 25-34, 35-44, 45-54 e 55+, cada um com a quota de seguidores que contém.

A API do TikTok indica quando os meus seguidores estão online?

audience_activity indica os seguidores ativos no TikTok por hora, em UTC+0, dentro das métricas de cada dia, para contas com Advanced Access ou Contas Empresariais Verificadas com 100 seguidores ou mais.

Como é que a API do TikTok indica os países dos seguidores?

Como códigos de país ou região ISO 3166-1 alpha-2 em audience_countries, cada um com a quota de seguidores desse local.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em