Demografia da audiência do TikTok pela API
A API for Business do TikTok retorna a demografia dos seguidores de uma conta a partir de GET /business/get/: audience_ages, audience_genders, audience_countries e audience_cities, cada uma uma lista de participações dos seguidores, para contas com pelo menos 100 seguidores. A atividade dos seguidores por hora vem como audience_activity nas métricas de cada dia, para contas com Advanced Access ou Verified Business Accounts e os mesmos 100 seguidores. Todas exigem o escopo user.insights.
O easyCoexistence lê a demografia dos seguidores de uma conta do TikTok com get_social_insights, pelo Claude, pelo ChatGPT ou pelo seu próprio código: peça audience_ages, audience_genders, audience_countries, audience_cities ou audience_activity e ele retorna as listas do TikTok como estão.
Seguidores que a conta precisa ter antes de o TikTok retornar os cortes de idade, gênero, país e cidade.
Faixas etárias em audience_ages: 18-24, 25-34, 35-44, 45-54 e 55+.
Fuso horário de audience_activity, a contagem por hora de seguidores ativos no TikTok.
Atraso habitual de audience_countries, audience_genders e audience_activity, que o TikTok calcula em processamento em lote.
Quais demografias o endpoint da conta retorna?
GET /business/get/ retorna esses dados quando eles são indicados em fields. Os quatro cortes ficam no topo de data, uma lista por dimensão, e a atividade por hora fica em metrics, um conjunto por dia:
audience_ages: a participação dos seguidores em cada faixa etária, 18-24, 25-34, 35-44, 45-54 e 55+.audience_genders: a participação dos seguidores por gênero: Female, Male ou Other.audience_countries: a participação dos seguidores por país ou região, como código ISO 3166-1 alpha-2.audience_cities: a participação dos seguidores por cidade, identificada porcity_name.audience_activity: para cada dia, os seguidores ativos no TikTok em cada hora, como hour e count.
Como solicitá-los?
Com os nomes dos campos em fields, em um array JSON, e um intervalo de datas em UTC para as métricas diárias que trazem audience_activity. start_date e end_date alcançam até 60 dias para trás, e sem eles o TikTok retorna os 7 dias até o dia anterior à requisição:
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 corte é uma lista de objetos que associa um grupo ao seu percentual, e cada dia em metrics traz sua 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 }
]
}
]
}
}Quais contas recebem quais cortes?
As participações por idade, gênero, país e cidade chegam quando a conta tem pelo menos 100 seguidores; o exemplo do próprio TikTok para uma conta com 13 seguidores retorna essas listas vazias. audience_activity também exige 100 seguidores e, além disso, uma conta com Advanced Access, que vem de vinculá-la a uma conta TikTok for Business ou a um Business Center não verificado, ou uma Verified Business Account. Todos esses campos exigem o escopo user.insights no token.
Quão atualizada é a demografia?
Com um ou dois dias de atraso. O TikTok lista audience_countries, audience_genders e audience_activity entre os campos que costumam atrasar de 24 a 48 horas, em UTC, e dá o mesmo prazo de atualização para idades e cidades. Os números vêm do TikTok Analytics, que o titular da conta ativa no app depois de publicar o primeiro vídeo, e dados anteriores a isso não estão disponíveis. O TikTok baseia a demografia em vários fatores, incluindo o que os usuários informam em seus perfis.
Em que a demografia dos seguidores difere dos espectadores de um vídeo?
Elas descrevem pessoas diferentes. As listas da conta cobrem os seguidores. /business/video/list/ retorna cortes das pessoas que assistiram a uma publicação: audience_genders, audience_countries e audience_cities, de até 10 entradas cada, e audience_types, que separa os espectadores em novos e recorrentes, seguidores e não seguidores. Esses campos exigem o escopo video.insights em vez de user.insights.
Como o easyCoexistence lê esses dados?
Com get_social_insights sobre a conta: deixe de fora object_id, liste os nomes dos campos em metrics e passe start_date e end_date em params quando quiser audience_activity de dias específicos. Ele devolve as listas do TikTok como estão, então as participações e as horas são lidas 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 cortes para uma conta pequena. O TikTok retorna participações de idade, gênero, país e cidade a partir de 100 seguidores, e o exemplo dele para uma conta com 13 seguidores mostra as listas vazias.
- Ler as horas de audience_activity como horário local. O TikTok as informa em UTC+0, então converta-as para o fuso da audiência antes de planejar publicações.
- Tratar a demografia dos seguidores como a dos espectadores. As listas da conta descrevem os seguidores; o audience_countries de um vídeo descreve quem o assistiu.
- Esperar audience_activity em uma conta pessoal. O TikTok o retorna para contas com Advanced Access ou Verified Business Accounts que tenham pelo menos 100 seguidores.
De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os 3 primeiros dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
A API do TikTok pode mostrar a idade e o gênero dos meus seguidores?
Sim. /business/get/ retorna audience_ages e audience_genders, participações de seguidores por grupo, quando a conta tem pelo menos 100 seguidores e o token tem user.insights.
Quais faixas etárias a API do TikTok usa?
18-24, 25-34, 35-44, 45-54 e 55+, cada uma com a participação dos seguidores nela.
A API do TikTok informa quando meus seguidores estão online?
audience_activity informa os seguidores ativos no TikTok por hora, em UTC+0, dentro das métricas de cada dia, para contas com Advanced Access ou Verified Business Accounts com 100 seguidores ou mais.
Como a API do TikTok informa 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 participação dos seguidores de lá.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em