tiktok/
followers-list

Obtenga perfiles normalizados de las listas de seguidores de TikTok visibles públicamente para uno o más nombres de usuario, con contexto de origen, enlaces de perfil y las métricas públicas disponibles.

TikTok Followers List API

Perfiles de seguidores
Muestreo de audiencia
Investigación de listas públicas
0.5 créditos por resultado
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 Followers List

Las listas de seguidores de TikTok visibles públicamente revelan la identidad de las cuentas, sus biografías, los enlaces de perfil y los conteos disponibles de audiencia o actividad. Estos registros sirven para el muestreo de audiencias, el descubrimiento de creadores de contenido, las colas de enriquecimiento y la investigación recurrente de listas públicas.

Funcionalidades de la TikTok Followers List API

  • Recopilación de varias cuentasObtenga los seguidores de uno o más nombres de usuario públicos, con results_limit aplicado de forma independiente a cada cuenta enviada.
  • Recorrido acotado del feedRecorre internamente las páginas de seguidores admitidas hasta alcanzar el límite por cuenta, una página siguiente no disponible o el máximo de recopilación.
  • Registros de perfil normalizadosDevuelve el ID del seguidor, el nombre de usuario, el nombre visible, la biografía, la referencia del avatar, la URL del perfil y las métricas públicas admitidas, con una estructura de perfil uniforme.
  • Contexto de origen conservadoMantiene en extra.input_username el nombre de usuario enviado, ya normalizado, para el registro de seguidor conservado.
  • Control de duplicados a nivel de tareaSuprime las identidades de seguidores repetidas en toda la tarea según el ID normalizado o la URL del perfil, antes de guardar y paginar los resultados.

Parámetros de la TikTok Followers List API

ParámetrosObligatorioDescripción
usernamesObligatorioLista obligatoria y no vacía de nombres de usuario públicos de TikTok. Los valores pueden incluir u omitir una @ inicial; no se aceptan ID numéricos de cuenta, URL de perfil ni valores de cursor.
results_limitOpcionalEntero opcional de 20 a 2,000, con 100 como valor predeterminado. El límite se aplica por separado a cada nombre de usuario enviado y es un tope, no una garantía de que la lista esté completa.

Cómo usar la TikTok Followers List API

Envíe nombres de usuario públicos conocidos, espere a la tarea asíncrona y recorra por páginas los registros de perfil guardados.

  1. Elimine los espacios en blanco, quite las @ iniciales opcionales para su propia deduplicación y elija nombres de usuario públicos de TikTok.
  2. Envíe por POST usernames y un results_limit por nombre de usuario de 20 a 2,000 a /v1/tiktok/followers-list.
  3. Guarde task_id y consulte /v1/tasks/{task_id}; queued, running y retrying son estados intermedios normales.
  4. Tras el éxito, lea data.results.items y pase next_cursor al mismo endpoint de la tarea mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/tiktok/followers-list" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["@loganpaul"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso de la TikTok Followers List API

  • Muestreo de audiencia pública: Arme una muestra acotada de perfiles de seguidores visibles públicamente para una revisión cualitativa de la audiencia.
  • Colas de descubrimiento de creadores de contenido: Reúna nombres de usuario y enlaces de perfil de seguidores que sirvan de base para una revisión manual o para una tarea posterior de enriquecimiento con TikTok Profiles.
  • Investigación recurrente de listas: Guarde muestras con marca de tiempo de las mismas cuentas públicas para observar los cambios en las identidades disponibles en cada recopilación.
  • Entradas para directorios de perfiles: Transforme las entradas de las listas públicas de seguidores en campos uniformes de identidad, biografía, avatar y métricas para directorios internos.

Consejos de expertos para la TikTok Followers List API

  • Normalice las mayúsculas y minúsculas y quite la @ inicial antes de deduplicar en el cliente; de lo contrario, @name y name pueden generar consultas equivalentes al origen.
  • Trate results_limit como un tope por nombre de usuario: dos nombres con el valor predeterminado de 100 producen una estimación de 200 resultados, no de 100.
  • Conserve extra.input_username, pero no use este endpoint para un análisis exacto de seguidores en común, porque la deduplicación a nivel de tarea conserva un único contexto de origen por identidad de seguidor.
  • Use el nombre de usuario del seguidor, no el id numérico, al pasar una cuenta devuelta a un endpoint que acepte nombres de usuario de TikTok.
  • No envíe next_cursor en una nueva solicitud de recopilación; solo sirve para paginar los resultados ya guardados de la misma tarea exitosa.
  • Maneje metrics como valores que pueden ser nulos y created_at como null, porque las filas de seguidores del origen no siempre exponen esos campos.
  • Espere menos registros en cuentas privadas, restringidas, no disponibles o muy grandes, y trate las referencias de avatar como URL de origen que pueden vencer.

Además de la TikTok Followers List 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 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 Audience Demographics API — Muestra por nombre de usuario de qué países provienen los seguidores de un creador, con el porcentaje de la audiencia de cada país.
  • 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 Followers List API — FAQ

TikTok Followers List API es una interfaz que recopila perfiles de seguidores visibles públicamente de uno o más nombres de usuario de TikTok, con identidad, biografía, enlace de perfil y métricas públicas disponibles, todo normalizado.

Envíe una lista usernames no vacía con nombres de usuario públicos, con @ opcional al inicio, y un results_limit opcional. No se aceptan ID numéricos de destino, URL de perfil ni cursores de recopilación.

Es un entero de 20 a 2,000, con 100 como valor predeterminado, y se aplica de forma independiente a cada nombre de usuario. Limita la recopilación solicitada, pero no garantiza que existan tantos registros públicos.

Un registro normalizado contiene ID, nombre de usuario, nombre visible, texto de la biografía, referencia del avatar, URL del perfil, métricas públicas que pueden ser nulas, collected_at y extra.input_username. Por ahora created_at es null.

La paginación del feed de TikTok se maneja internamente y no es un parámetro de envío. El next_cursor devuelto tras el éxito solo carga otra página de resultados guardados desde /v1/tasks/{task_id}.

No de forma fiable. Los resultados guardados se deduplican dentro de la tarea por ID de seguidor o URL de perfil, por lo que un seguidor repetido se conserva una sola vez con un único input_username, y no como un conjunto completo de relaciones de origen.

Cada resultado normalizado guardado cuesta 0.5 créditos, sin cargo base. La estimación inicial multiplica results_limit por el número de nombres de usuario enviados, y los créditos precargados que no se usen se reembolsan al terminar la tarea.