tiktok/
user-videos

Obtenga videos públicos de TikTok de uno o más nombres de usuario, con descripciones, creadores de contenido, medios, marcas de tiempo e interacción visible, como registros normalizados vinculados a la cuenta.

TikTok User Videos API

Feeds de cuentas conocidas
Nombres de usuario por lotes
Contexto de la cuenta de origen
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 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ámetrosObligatorioDescripción
usernamesObligatorioLista obligatoria de uno o más nombres de usuario públicos de TikTok; cada valor puede incluir u omitir una @ inicial.
results_limitOpcionalMáximo de videos solicitados por cada nombre de usuario; el valor predeterminado es 100 y acepta enteros de 20 a 2,000.
sort_byOpcionalOrden opcional del feed del perfil: latest de forma predeterminada, o popular para resultados clasificados por el origen.
regionOpcionalCó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.

  1. 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.
  2. Envíe usernames y los controles opcionales por POST a /v1/tiktok/user-videos y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
  4. 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.

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.

Explorar otras plataformas

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

TikTok User Videos API — FAQ

TikTok User Videos API es una interfaz que recopila videos del feed público de perfil de uno o más nombres de usuario de TikTok. Devuelve identidad normalizada del video, descripciones, contexto del creador de contenido y de los medios, marcas de tiempo, interacción visible y el nombre de usuario de origen.

Envíe usernames como una lista no vacía. Se acepta una @ inicial, pero normalizar y deduplicar los nombres de usuario antes del envío evita procesar la misma cuenta más de una vez.

results_limit es un máximo por nombre de usuario de 20 a 2,000, con 100 como valor predeterminado. Cada feed de perfil se recorre de forma independiente y puede terminar antes de alcanzar ese máximo.

latest es el orden predeterminado del feed del perfil, mientras que popular solicita resultados clasificados por el origen. popular no es una puntuación calculada por SocQ, así que conserve el orden elegido al comparar los resultados de las tareas.

region acepta un código opcional de dos letras y puede influir en qué videos pone a disposición el origen. No establece dónde se creó un video ni dónde se encuentra su audiencia.

Un registro puede contener la identidad y la URL del video, la descripción y el idioma, los datos del creador de contenido, la interacción visible, los medios y la duración, los hashtags, las menciones, la música, las marcas de tiempo, los indicadores públicos de contenido y extra.input_username.

Solo se pueden devolver los videos expuestos en el feed público del perfil. Los videos privados, restringidos, eliminados u ocultos pueden faltar, y la recopilación también se detiene cuando el feed termina, su cursor deja de avanzar o se alcanza el máximo de 100 páginas.

Cada video normalizado guardado cuesta 0.5 créditos, sin cargo base por tarea. La estimación inicial multiplica results_limit o su valor predeterminado por el número de nombres de usuario, mientras que el uso final depende de los registros realmente guardados; si no se guarda ningún video, no hay cargo por resultados.