Volver a las API
Datos públicos de Douyin

Douyin Public Data APIs

Obtenga perfiles y videos públicos, busque videos, recopile una página de comentarios o de videos de un creador de contenido y consulte una transmisión en vivo conocida.

API de Douyin disponibles

Elija entre seis API para flujos de perfiles, videos, comentarios, búsqueda y transmisiones en vivo.

¿Qué datos de Douyin se pueden obtener?

El catálogo de Douyin devuelve registros normalizados de cuentas, videos, comentarios y transmisiones en vivo a partir de datos públicos de la fuente.

Perfiles y videos de creadores de contenido

Resuelva un perfil público o recopile una página de videos de la fuente a partir de una URL de perfil compatible o de un user_id.

Detalles de videos, búsqueda y comentarios

Consulte la referencia de un video compatible, busque por consulta en la primera página fija de la fuente o recopile una página de comentarios.

Detalles de transmisiones en vivo

Obtenga una transmisión en vivo conocida mediante un room_id compuesto solo por dígitos, con los datos disponibles del anfitrión, el estado, el contenido multimedia y la audiencia visible.

Especificaciones de las API de Douyin de un vistazo

Cada endpoint tiene una solicitud acotada a la fuente y rechaza los parámetros no declarados.

Grupo de APIEntrada inicialLímite de la fuente
Perfil y videos del creador de contenidourl o user_idUn perfil o una página de la fuente; los videos del creador admiten results_limit de 1–20
Detalle de video y comentariosURL compatibleUn registro de detalle o una página de comentarios; los comentarios admiten results_limit de 1–20
Búsqueda de videosquery no vacíaPrimera página fija de la fuente, sin results_limit
Transmisión en vivoroom_id compuesto solo por dígitosComo máximo un registro de transmisión en vivo

Cómo funcionan las API de Douyin

Los seis endpoints usan el mismo flujo asíncrono de envío, consulta y resultados almacenados.

  1. 1. Elegir el endpoint

    Seleccione el endpoint de perfil, video, comentarios, búsqueda o transmisión en vivo que corresponda a la referencia pública que ya tiene.

  2. 2. Enviar una entrada válida

    Envíe por POST solo los campos declarados y guarde el task_id devuelto.

  3. 3. Leer los resultados normalizados

    Consulte la tarea hasta que llegue a un estado final y luego lea data.results.items; use next_cursor solo para paginar resultados almacenados.

Buscar videos públicos de Douyin

Autentíquese con una clave de API de SocQ y envíe una query no vacía. Cada tarea correcta de Douyin cuesta una tarifa fija de 0.10 créditos.

curl -X POST "https://api.socq.ai/v1/douyin/video-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"artificial intelligence"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after success

Casos de uso frecuentes de la API de Douyin

Investigación de creadores de contenido

Combine la identidad pública del perfil con una página acotada de videos del creador y su interacción visible.

Revisión de contenido y conversación

Enriquezca videos conocidos, busque una instantánea de un tema y consulte una página de comentarios públicos.

Monitoreo de transmisiones en vivo

Registre una instantánea de una transmisión en vivo pública conocida mediante un identificador numérico de sala explícito.

Límites y política de datos públicos

Estos endpoints leen datos públicos mediante solicitudes acotadas a la fuente y no ofrecen acciones sobre cuentas ni monitoreo continuo.

  • user_id acepta de 1 a 256 letras ASCII, números, dos puntos, guiones bajos o guiones; las URL de perfil deben contener /user/{identifier} en un host de Douyin compatible.
  • room_id es una cadena que contiene solo dígitos; evite almacenar identificadores largos como números de JavaScript.
  • results_limit está disponible solo para User Videos y Video Comments, con un rango de 1–20 y un valor predeterminado de 20.
  • Video Search está fijado a la primera página de la fuente; los cursores de resultados de tareas solo paginan los registros ya almacenados para esa tarea.
  • Cada tarea correcta de Douyin cuesta una tarifa fija de 0.10 créditos.

Preguntas frecuentes sobre la API de Douyin

¿Qué son las API de Douyin?

Las API de Douyin obtienen perfiles, videos, comentarios, resultados de búsqueda de videos y detalles de transmisiones en vivo públicos como registros normalizados.

¿Qué endpoints aceptan results_limit?

User Videos y Video Comments aceptan un entero de 1 a 20. Los demás endpoints de Douyin rechazan results_limit.

¿Se puede paginar la fuente?

No hay un cursor de la fuente que pueda controlar quien realiza la solicitud. Un next_cursor devuelto solo pagina los resultados ya almacenados de la tarea completada.

¿Cuánto cuestan las solicitudes de Douyin?

Cada tarea correcta cuesta una tarifa fija de 0.10 créditos de SocQ.

Reúna en un mismo flujo de trabajo perfiles públicos, contenido y datos de interacción de distintas plataformas para dar seguimiento a marcas, creadores y temas, y para realizar monitoreo y análisis entre plataformas con más eficiencia.