TikTok User Videos
Los videos de usuario de TikTok son publicaciones públicas del feed de un perfil, con descripciones, identidad del creador de contenido, contexto de medios y sonido, datos de publicación e interacción visible. Estos registros de contenido vinculados a la cuenta sirven para inventariar creadores de contenido, comparar publicaciones, investigar creatividades y tomar instantáneas de rendimiento.
Funcionalidades de la TikTok User Videos API
- Feeds de perfil de cuentas conocidasAcepta uno o más nombres de usuario de TikTok y recorre cada feed público de videos de forma independiente, de modo que los resultados se limitan a las cuentas seleccionadas y no a un descubrimiento por palabra clave o hashtag.
- Detalle del video y del creador de contenidoDevuelve los ID y las URL de los videos, las descripciones, el idioma, la identidad del creador de contenido, las referencias de medios, la duración, los hashtags, las menciones, la música y los indicadores públicos de contenido.
- Señales de interacción con marca de tiempoEmpareja los conteos visibles de reproducciones, Me gusta, comentarios, veces compartido, guardados y reposts con las horas de publicación y de recopilación, para obtener registros de videos de la cuenta en un momento dado.
- Recorrido controlado por cuentaAplica el orden por más recientes o por popularidad y una región opcional a cada nombre de usuario, a la vez que deduplica los ID de videos y respeta el límite solicitado por cuenta.
Parámetros de la TikTok User Videos API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
usernames | Obligatorio | Lista obligatoria de uno o más nombres de usuario públicos de TikTok; cada valor puede incluir u omitir una @ inicial. |
results_limit | Opcional | Máximo de videos solicitados por cada nombre de usuario; el valor predeterminado es 100 y acepta enteros de 20 a 2,000. |
sort_by | Opcional | Orden opcional del feed del perfil: latest de forma predeterminada, o popular para resultados clasificados por el origen. |
region | Opcional | Código de región opcional de dos letras, enviado en mayúsculas, para influir en la disponibilidad en el origen. |
Cómo usar la TikTok User Videos API
Envíe nombres de usuario públicos conocidos como tarea asíncrona y luego lea los videos normalizados vinculados a la cuenta con paginación por cursor de resultados.
- Prepare uno o más nombres de usuario públicos de TikTok y elija el orden latest o popular, una región opcional de dos letras y un results_limit por nombre de usuario.
- Envíe usernames y los controles opcionales por POST a /v1/tiktok/user-videos y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
- Lea data.results.items desde /v1/tasks/{task_id}?limit=50 y continúe con results.next_cursor mientras results.has_more sea true.
curl -X POST "https://api.socq.ai/v1/tiktok/user-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["@loganpaul"],"results_limit":20,"sort_by":"latest"}'
# Poll GET /v1/tasks/{task_id}, then read data.results.items and follow results.next_cursor.Casos de uso de la TikTok User Videos API
- Inventarios de videos de creadores de contenido: Indexe las cuentas seleccionadas por ID de video, URL canónica, descripción, medios, hora de publicación y extra.input_username para mantener un catálogo público de contenido con trazabilidad.
- Comparación de publicaciones e interacción: Compare created_at con las reproducciones, Me gusta, comentarios, veces compartido, guardados y reposts visibles entre cuentas conocidas, y conserve collected_at como hora de la instantánea.
- Investigación de formatos creativos: Use las descripciones, el idioma, la duración, los hashtags, las menciones, la música, el tipo de medio y los indicadores públicos de contenido para comparar los patrones creativos recurrentes en los feeds de perfiles seleccionados.
Consejos de expertos para la TikTok User Videos API
- Normalice cada nombre de usuario a una sola forma y deduplique antes del envío, porque creator y @creator apuntan a la misma cuenta, pero de lo contrario podrían procesarse por separado.
- Elija results_limit teniendo en cuenta el número de nombres de usuario, porque el límite y la estimación inicial de créditos se aplican de forma independiente a cada cuenta enviada.
- Use latest para una recopilación orientada a lo reciente y trate popular como un orden del origen y no como una puntuación calculada por SocQ.
- Use region solo como control de disponibilidad; no la interprete como prueba de que un video devuelto se produjo en esa zona geográfica.
- Al combinar tareas repetidas, deduplique por el id del video y conserve extra.input_username y collected_at para la atribución a la cuenta y el momento de la instantánea.
- Trate los campos opcionales de creador de contenido, interacción, medios, música e indicadores de contenido como datos que pueden ser nulos, escape las descripciones públicas antes de mostrarlas y no dé por hecho que las URL de medios del origen son permanentes.
APIs relacionadas
Además de la TikTok User Videos 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 Comments API — Recolecta comentarios públicos de primer nivel, autores, interacción, menciones e indicadores de interacción del creador.
- TikTok Videos API — Obtiene el creador, la descripción, el contenido multimedia, la música, las etiquetas, las menciones y la interacción desde URLs de videos.
- TikTok Trending Feed API — Recolecta el feed actual de videos públicos de una región, con campos de creador, descripción, portada, marca de tiempo e interacción visible.
- TikTok Video Transcript API — Extrae el texto de transcripción disponible, el idioma, el formato y el contexto de origen desde URLs de videos públicos.
- TikTok Song API — Obtiene los metadatos de un sonido público por ID de clip o URL de música.
- TikTok Hashtags API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Search Users API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts 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 Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API