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ámetros | Obligatorio | Descripción |
|---|---|---|
usernames | Obligatorio | Lista 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_limit | Opcional | Entero 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.
- Elimine los espacios en blanco, quite las @ iniciales opcionales para su propia deduplicación y elija nombres de usuario públicos de TikTok.
- Envíe por POST usernames y un results_limit por nombre de usuario de 20 a 2,000 a /v1/tiktok/followers-list.
- Guarde task_id y consulte /v1/tasks/{task_id}; queued, running y retrying son estados intermedios normales.
- 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 trueCasos 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.
APIs relacionadas
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.
- TikTok Hashtags API
- TikTok Comments API
- TikTok Videos API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Live Room Info API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API