tiktok/
user-audience

Consulte en qué países viven los seguidores de una cuenta pública de TikTok con solo el nombre de usuario, con el nombre de cada país, su código ISO, su porcentaje de la audiencia y los seguidores de la muestra.

TikTok Audience Demographics API

Nombre de usuario
Países de los seguidores
Porcentaje por país
20 créditos por solicitud
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

TikTok Audience Demographics

Los países de la audiencia de una cuenta de TikTok indican dónde viven sus seguidores, como el porcentaje que representa cada país dentro de una muestra de seguidores, junto con el número de seguidores muestreados que respalda ese porcentaje. El análisis nativo de TikTok reserva esta vista para el dueño de la cuenta, así que consultar por nombre de usuario es la forma en que marcas, agencias y analistas revisan a un creador de contenido que no administran.

Funcionalidades de la TikTok Audience Demographics API

  • Cualquier nombre de usuario público, sin iniciar sesiónEnvíe un nombre de usuario público, con o sin @, y obtenga la geografía de sus seguidores sin acceso a la cuenta ni una sesión de TikTok.
  • Nombre, código ISO, porcentaje y conteoCada entrada de audience_countries incluye el nombre del país, un country_code de dos letras, un share de 0 a 1 y el número de seguidores muestreados que lo respaldan.
  • Primero el mercado más grandeLos países llegan ordenados por share, de modo que las primeras filas indican dónde está la mayor parte de la audiencia y el final de la lista muestra los mercados menores.

Parámetros de la TikTok Audience Demographics API

ParámetrosObligatorioDescripción
usernameObligatorioNombre de usuario de TikTok que se va a analizar, con o sin la @ inicial.

Cómo usar la TikTok Audience Demographics API

Envíe un nombre de usuario, consulte la tarea y lea un registro de audiencia.

  1. Envíe {"username": "khaby.lame"} por POST a /v1/tiktok/user-audience.
  2. Consulte GET /v1/tasks/{task_id} cada pocos segundos hasta que status sea succeeded.
  3. Lea el único registro de results.items y recorra audience_countries.
curl -X POST "https://api.socq.ai/v1/tiktok/user-audience" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"khaby.lame"}'

# The result has one record; audience_countries[].share is a fraction from 0 to 1.

Casos de uso de la TikTok Audience Demographics API

  • Contratar a un creador para un solo mercado: Antes de pagar una campaña dirigida a un país, revise el porcentaje que ese país tiene entre los seguidores del creador: una audiencia grande que vive en otro lugar no llegará a sus compradores.
  • Comprobar si una estrategia por país funciona: Si busca crecer en un país nuevo, consulte el mismo nombre de usuario de forma periódica y compare el porcentaje de ese país entre una marca de tiempo collected_at y otra.
  • Descartar mercados que no puede atender: Las tiendas y apps que venden en una lista fija de países pueden sumar el share de esos valores de country_code y descartar a los creadores cuyos seguidores viven en su mayoría fuera de ella.

Consejos de expertos para la TikTok Audience Demographics API

  • Divida count entre share para estimar el tamaño de la muestra de seguidores; si es pequeña, trate los países con porcentajes cercanos como un empate y no como un orden.
  • Agrupe los valores de country_code en sus propias regiones, como la UE o LATAM, antes de comparar creadores, porque las campañas suelen apuntar a una región y no a un solo país.

Además de la TikTok Audience Demographics API, use estas APIs cuando necesite otro tipo de datos públicos de TikTok.

  • TikTok Profiles API — Obtiene por nombre de usuario la identidad del perfil público, biografías, indicadores de cuenta y conteos de audiencia.
  • TikTok Followers List API — Recolecta perfiles normalizados visibles en listas públicas de seguidores, conservando el contexto de origen y las métricas compatibles.
  • TikTok Following List API — Recolecta los perfiles públicos seguidos por cuentas de TikTok, con identidad normalizada, biografías, métricas visibles y contexto de la cuenta de origen.
  • TikTok User Videos API — Recolecta videos públicos del feed de un perfil por nombre de usuario, con descripciones, creadores, contenido multimedia, marcas de tiempo, interacción y contexto de la cuenta de origen.
  • TikTok Similar Accounts API — Encuentra las cuentas que TikTok recomienda como similares a un nombre de usuario, con número de seguidores y biografías.
  • TikTok Live Ranking API — Obtiene la clasificación diaria de creadores en vivo con posiciones, puntuaciones basadas en regalos y número de seguidores.

Explorar otras plataformas

Combine los datos de TikTok con datos públicos de otras plataformas sociales compatibles.

TikTok Audience Demographics API — FAQ

TikTok Audience Demographics API es una interfaz programática para obtener, a partir del nombre de usuario, los países donde viven los seguidores de una cuenta pública de TikTok. Devuelve un registro con el nombre de cada país, su código ISO, su porcentaje de la audiencia y el número de seguidores muestreados.

Sí, de cualquier cuenta pública. TikTok muestra la ubicación de los seguidores solo al dueño de la cuenta, mientras que esta consulta necesita únicamente el nombre de usuario.

No. El registro cubre solo el país de los seguidores, sin desglose por edad, género ni ciudad.

Sí. Envíe su propio nombre de usuario y lea los países como datos en lugar de abrir TikTok Analytics, algo práctico para informes de varias cuentas que usted administra.

Cada share sale de una muestra de seguidores de la cuenta, y count indica cuántos seguidores muestreados lo respaldan. Un país con un count bajo es una señal aproximada, no una cifra exacta.

Por solicitud. Un nombre de usuario cuesta 20 créditos fijos, sin importar cuántos países se devuelvan; si el nombre de usuario no existe, la tarea falla y los créditos se devuelven.