douyin/
user-videos

Recopile hasta 20 videos públicos de una URL de perfil de Douyin o de un ID de usuario conocido, con contenido, autor, contenido multimedia, duración, marcas de tiempo y campos visibles de interacción normalizados.

Douyin User Videos API

URL de perfil o ID de usuario
Hasta 20 videos
Registros de videos normalizados
0.1 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

Douyin User Videos

Este endpoint convierte la identidad de un creador de contenido de Douyin en un conjunto de registros de videos públicos de una sola página. Cada registro puede incluir su descripción, el contexto del autor, la URL de origen, los momentos de publicación y de recopilación, el contenido multimedia, la duración y las cantidades visibles de reproducciones, Me gusta, comentarios, veces compartido o vistas cuando la fuente las ofrece.

Funcionalidades de la Douyin User Videos API

  • Dos formas de identificar a un creador de contenidoEnvíe una URL de perfil de Douyin compatible o un user_id conocido. Si ambos campos están presentes, se usa el user_id directo.
  • Alcance explícito de una sola páginaElija de 1 a 20 resultados solicitados, con 20 como valor predeterminado y máximo; la solicitud al proveedor siempre parte de su primera página.
  • Contexto del video y del creador de contenido en conjuntoConserve en cada registro de video las descripciones normalizadas, los campos públicos del autor, las URL de origen, las marcas de tiempo, las referencias multimedia y la duración.
  • Campos de interacción listos para la observaciónConserve las reproducciones, los Me gusta, los comentarios, las veces compartido y las vistas disponibles con collected_at, para que cada conteo visible quede asociado a su momento de recopilación.

Parámetros de la Douyin User Videos API

ParámetrosObligatorioDescripción
urlObligatorio (al menos uno)Una referencia a un perfil de Douyin cuyo nombre de host sea douyin.com, iesdouyin.com o un subdominio y cuya ruta contenga /user/{identifier}. Indique url o user_id; user_id tiene prioridad cuando ambos están presentes.
user_idObligatorio (al menos uno)Un identificador de usuario conocido de 1 a 256 letras ASCII, números, dos puntos, guiones bajos o guiones. Indique user_id o url.
results_limitOpcionalLa cantidad de registros solicitada de la única página del proveedor. Acepta enteros de 1 a 20 y su valor predeterminado es 20.

Cómo usar la Douyin User Videos API

Envíe la identidad de un creador de contenido público, siga la tarea asíncrona y lea después los registros de videos normalizados almacenados.

  1. Prepare una URL de perfil de Douyin en douyin.com o iesdouyin.com con una ruta /user/{identifier}, o bien un user_id conocido.
  2. Envíe por POST la identidad y un results_limit opcional de 1 a 20 a /v1/douyin/user-videos y guarde el task_id.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea se complete con éxito o falle.
  4. Lea data.results.items; siga next_cursor solo para obtener registros adicionales que SocQ ya almacenó, no otra página del proveedor.
curl -X POST "https://api.socq.ai/v1/douyin/user-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"'"$DOUYIN_PROFILE_URL"'","results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and use next_cursor only for stored results

Casos de uso de la Douyin User Videos API

  • Instantáneas del feed de un creador de contenido: Guarde un conjunto acotado de videos públicos y marcas de tiempo de recopilación de un creador de contenido en un punto de observación elegido.
  • Enriquecimiento del catálogo de videos: Agregue descripciones normalizadas, identidad del autor, URL de origen, momento de publicación, duración y contenido multimedia disponible a un registro de creador de contenido existente.
  • Revisión de creatividades y formatos: Examine las descripciones, la duración y los campos multimedia devueltos para organizar los videos disponibles según su tratamiento de contenido o formato.
  • Comparación de interacción dentro de una instantánea: Compare las reproducciones, los Me gusta, los comentarios, las veces compartido y las vistas disponibles entre los videos devueltos, conservando collected_at.

Consejos de expertos para la Douyin User Videos API

  • Prefiera un solo campo de identidad por solicitud. Si se incluyen url y user_id, el backend selecciona user_id.
  • Valide el host de la URL y la ruta /user/{identifier} antes del envío; una URL genérica de video de Douyin no cumple los requisitos de este endpoint.
  • Defina results_limit solo cuando le resulten útiles menos de los 20 registros predeterminados; debe ser un entero de 1 a 20.
  • No trate el cursor del resultado de la tarea como un cursor de origen de Douyin. La solicitud a la fuente es de una sola página, con su cursor del proveedor fijo en la primera página.
  • Permita que el autor, el contenido multimedia, la duración, el momento de publicación y las métricas individuales opcionales queden en null o vacíos, y use id junto con collected_at al almacenar observaciones.

Además de la Douyin User Videos API, use estas APIs cuando necesite otro tipo de datos públicos de Douyin.

Explorar otras plataformas

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

Douyin User Videos API — FAQ

Douyin User Videos API devuelve registros normalizados de videos públicos de un creador de contenido, con identidad, descripción, contexto del autor, URL de origen, marcas de tiempo, contenido multimedia, duración y campos visibles de interacción cuando están disponibles.

Cualquiera de los dos campos cumple el requisito de entrada. Una URL debe usar un host de Douyin compatible y contener /user/{identifier}; un user_id conocido se puede enviar directamente y prevalece si ambos campos están presentes.

Controla la cantidad de registros solicitada para la única página del proveedor. El valor debe ser un entero de 1 a 20 y su valor predeterminado es 20.

Un resultado puede incluir reproducciones, Me gusta, comentarios, veces compartido y vistas. Cada campo es opcional, por lo que los valores de la fuente que no están disponibles quedan en null en lugar de inferirse.

No. La solicitud al proveedor usa solo su primera página. El next_cursor del lector de resultados de tareas de SocQ pagina los registros ya almacenados para esa tarea.

Cada tarea exitosa de Douyin User Videos cuesta un valor fijo de 0.10 créditos de SocQ, independientemente de la cantidad de registros devueltos dentro del límite de 20 registros.