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.
Seguidores necessários para que o TikTok devolva as desagregações por idade, género, país e cidade.
Grupos etários em audience_ages: 18-24, 25-34, 35-44, 45-54 e 55+.
Fuso horário de audience_activity, a contagem horária de seguidores ativos no TikTok.
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 decity_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:
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:
{
"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.
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.
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