EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

100

Seguidores que a conta precisa ter antes de o TikTok retornar os cortes de idade, gênero, país e cidade.

5 groups

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

UTC+0

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

24 to 48 h

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 por city_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:

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 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:

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

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.

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 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.
Fazendo isso com o EasyCoexistence

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