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ámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio (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_id | Obligatorio (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_limit | Opcional | La 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.
- Prepare una URL de perfil de Douyin en douyin.com o iesdouyin.com con una ruta /user/{identifier}, o bien un user_id conocido.
- 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.
- Consulte /v1/tasks/{task_id} hasta que la tarea se complete con éxito o falle.
- 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 resultsCasos 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.
APIs relacionadas
Además de la Douyin User Videos API, use estas APIs cuando necesite otro tipo de datos públicos de Douyin.
- Douyin Live Room Detail API — Obtiene una transmisión en vivo conocida de Douyin por ID numérico de sala, con contexto normalizado de la sala, identidad del anfitrión, contenido multimedia y conteos visibles de audiencia.
- Douyin User Profile API
- Douyin Video Comments API
- Douyin Video Detail API
- Douyin Video Search API