Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Demografía de la audiencia de TikTok mediante la API

La API for Business de TikTok devuelve la demografía de seguidores de una cuenta desde GET /business/get/: audience_ages, audience_genders, audience_countries y audience_cities, cada una como una lista de proporciones de seguidores, para cuentas con al menos 100 seguidores. La actividad horaria de seguidores llega como audience_activity dentro de las métricas de cada día, para cuentas con Advanced Access o Verified Business Accounts y los mismos 100 seguidores. Todas necesitan el scope user.insights.

easyCoexistence lee la demografía de seguidores de una cuenta de TikTok con get_social_insights desde Claude, ChatGPT o tu propio código: pide audience_ages, audience_genders, audience_countries, audience_cities o audience_activity y devuelve las listas de TikTok tal como son.

100

Seguidores que una cuenta necesita para que TikTok devuelva sus desgloses de edad, género, país y ciudad.

5 groups

Grupos de edad en audience_ages: 18-24, 25-34, 35-44, 45-54 y 55+.

UTC+0

Zona horaria de audience_activity, el recuento por hora de seguidores activos en TikTok.

24 to 48 h

Retraso habitual de audience_countries, audience_genders y audience_activity, que TikTok calcula sin conexión.

¿Qué demografías devuelve el endpoint de la cuenta?

GET /business/get/ las devuelve cuando se nombran en fields. Los cuatro desgloses aparecen en la parte superior de data, una lista por dimensión, y la actividad horaria aparece en metrics, con un conjunto por día:

  • audience_ages: la proporción de seguidores en cada grupo de edad, 18-24, 25-34, 35-44, 45-54 y 55+.
  • audience_genders: la proporción de seguidores por género: Female, Male o Other.
  • audience_countries: la proporción de seguidores por país o región, como código ISO 3166-1 alpha-2.
  • audience_cities: la proporción de seguidores por ciudad, según city_name.
  • audience_activity: para cada día, los seguidores activos en TikTok en cada hora, como hour y count.

¿Cómo se solicitan?

Con los nombres de campo en fields, en un array JSON, y un rango de fechas en UTC para las métricas diarias que incluyen audience_activity. start_date y end_date llegan hasta 60 días atrás; si no se envían, TikTok devuelve los 7 días hasta el día anterior a la petición:

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'

¿Cómo es la respuesta?

Cada desglose es una lista de objetos que asocia un grupo con su porcentaje, y cada día en metrics incluye su fecha y una lista audience_activity de horas. Los valores siguientes son los ejemplos propios de TikTok, reducidos a la lista de género y a algunas 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 }
        ]
      }
    ]
  }
}

¿Qué cuentas reciben qué desgloses?

Las proporciones de edad, género, país y ciudad aparecen cuando la cuenta tiene al menos 100 seguidores; el ejemplo de TikTok para una cuenta de 13 seguidores devuelve esas listas vacías. audience_activity también requiere 100 seguidores y, además, una cuenta con Advanced Access, que se obtiene al vincularla a una cuenta de TikTok for Business o a un Business Center no verificado, o una Verified Business Account. Todos estos campos necesitan el scope user.insights en el token.

¿Qué tan actuales son las demografías?

Van uno o dos días por detrás. TikTok incluye audience_countries, audience_genders y audience_activity entre los campos que suelen retrasarse de 24 a 48 horas, en UTC, y da el mismo plazo de actualización para edades y ciudades. Las cifras provienen de TikTok Analytics, que el propietario activa en la app tras publicar un primer video; los datos anteriores a ese momento no están disponibles. TikTok basa las demografías en varios factores, incluida la información que los usuarios colocan en sus perfiles.

¿En qué se diferencian las demografías de seguidores de los espectadores de un video?

Describen personas distintas. Las listas de la cuenta cubren a los seguidores. /business/video/list/ devuelve desgloses de quienes vieron una publicación: audience_genders, audience_countries y audience_cities, de hasta 10 entradas cada uno, y audience_types, que divide a los espectadores en nuevos y recurrentes, seguidores y no seguidores. Estos requieren el scope video.insights en lugar de user.insights.

¿Cómo lee easyCoexistence estos datos?

Con get_social_insights sobre la cuenta: se omite object_id, se enumeran los nombres de campo en metrics y se pasan start_date y end_date en params cuando se quiere audience_activity de días concretos. Devuelve las listas de TikTok tal como son, así que las proporciones y las horas se leen exactamente como se indicó arriba.

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

Errores comunes

  • Esperar desgloses en una cuenta pequeña. TikTok devuelve las proporciones de edad, género, país y ciudad desde 100 seguidores; su ejemplo para una cuenta de 13 seguidores muestra las listas vacías.
  • Leer las horas de audience_activity como hora local. TikTok las informa en UTC+0, así que conviene desplazarlas a la zona horaria de la audiencia antes de planificar publicaciones.
  • Tomar las demografías de seguidores por demografías de espectadores. Las listas de la cuenta describen a los seguidores; el audience_countries de un video describe a quienes lo vieron.
  • Esperar audience_activity en una cuenta personal. TikTok lo devuelve para cuentas con Advanced Access o Verified Business Accounts que tengan al menos 100 seguidores.
Hacerlo con EasyCoexistence

De US$ 9 a US$ 0.75 por conexión al mes, bajando al sumar conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿La API de TikTok puede mostrar la edad y el género de mis seguidores?

Sí. /business/get/ devuelve audience_ages y audience_genders, proporciones de seguidores por grupo, cuando la cuenta tiene al menos 100 seguidores y el token tiene user.insights.

¿Qué grupos de edad usa la API de TikTok?

18-24, 25-34, 35-44, 45-54 y 55+, cada uno con la proporción de seguidores que contiene.

¿La API de TikTok indica cuándo están activos mis seguidores?

audience_activity da los seguidores activos en TikTok por hora, en UTC+0, dentro de las métricas de cada día, para Advanced Access o Verified Business Accounts con 100 seguidores o más.

¿Cómo da la API de TikTok los países de los seguidores?

Como códigos ISO 3166-1 alpha-2 de país o región en audience_countries, cada uno con la proporción de seguidores de ese lugar.

Sigue leyendo

Conecta tu primer canal en dos minutos.

Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.

  • 3 días gratis
  • Cancela cuando quieras
  • Solo APIs oficiales
  • Monitorizado 24/7

Verificado el