douyin/
video-search

Busque una primera página fija de videos públicos de Douyin mediante una consulta de texto, con descripciones, contexto del autor, contenido multimedia, duración, marcas de tiempo e interacción visible normalizados cuando están disponibles.

Douyin Video Search API

Consulta de texto
Primera página fija
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 Video Search

Douyin Video Search convierte una consulta de texto no vacía en un conjunto acotado de videos públicos. Cada tarea hace una solicitud fija al proveedor para la página 1 con desplazamiento 0 y luego almacena los registros devueltos en el formato reel-video de SocQ, para una lectura posterior consistente.

Funcionalidades de la Douyin Video Search API

  • Contrato de búsqueda de un solo campoEnvíe únicamente query. El endpoint rechaza entradas no declaradas como results_limit y no requiere un token del proveedor ni un identificador interno.
  • Solicitud acotada a la fuenteCada tarea pide al proveedor la página 1 con desplazamiento 0, sin exponer a quien llama los controles de paginación del proveedor.
  • Registros reel-video normalizadosLea el texto, el autor, el contenido multimedia, la duración, las marcas de tiempo y las cantidades visibles de reproducciones, Me gusta, comentarios y veces compartido disponibles mediante un esquema de resultados consistente.
  • Lecturas asíncronas de resultados almacenadosEnvíe una vez, consulte la tarea y use el cursor de resultados de SocQ solo cuando la tarea completada haya almacenado más registros de los que devuelve una página de respuesta.

Parámetros de la Douyin Video Search API

ParámetrosObligatorioDescripción
queryObligatorioUna consulta de texto obligatoria y no vacía. Se asigna al campo de palabra clave del proveedor, mientras que la página y el desplazamiento los fija el backend.

Cómo usar la Douyin Video Search API

Indique una consulta no vacía, espere a que termine la tarea asíncrona y lea los registros normalizados almacenados para esa tarea.

  1. Elija una consulta de texto específica que describa los videos públicos que desea descubrir.
  2. Envíe query por POST a /v1/douyin/video-search y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea se complete con éxito o informe un error.
  4. Lea data.results.items. Si has_more es true, pase next_cursor a la solicitud de resultados de la tarea para continuar con los registros almacenados de SocQ.
curl -X POST "https://api.socq.ai/v1/douyin/video-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"street food"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; next_cursor pages stored SocQ results only

Casos de uso de la Douyin Video Search API

  • Descubrimiento de videos por tema: Cree una instantánea acotada de los videos públicos devueltos para un producto, tema, evento o frase de investigación.
  • Revisión del contexto del creador de contenido: Conecte las descripciones y el contenido multimedia devueltos con los campos públicos disponibles del autor, para investigación cualitativa y enriquecimiento de conjuntos de datos.
  • Análisis de formato y contenido multimedia: Revise el contenido multimedia de video disponible, las miniaturas, las dimensiones y la duración junto con el registro de origen y el contexto de la consulta.
  • Instantáneas de interacción visible: Compare las cantidades disponibles de reproducciones, Me gusta, comentarios y veces compartido, conservando collected_at como momento de la observación.

Consejos de expertos para la Douyin Video Search API

  • Exija en su propia interfaz un texto de query con contenido real, sin solo espacios en blanco, antes de enviar la tarea.
  • No envíe results_limit, page, offset, search_id ni un cursor del proveedor; no forman parte del esquema de solicitud público de SocQ.
  • Trate el conjunto devuelto como una única respuesta del proveedor, no como un índice de búsqueda exhaustivo ni como una ventana de clasificación controlada por quien llama.
  • Use el cursor y limit de GET /v1/tasks/{task_id} solo para leer resultados almacenados; limit tiene un valor predeterminado de 50 y acepta de 1 a 500.
  • Conserve collected_at y maneje los campos opcionales de autor, contenido multimedia, publicación, duración y métricas individuales sin sustituir por cero los valores ausentes.

Además de la Douyin Video Search 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 Video Search API — FAQ

Douyin Video Search API busca en la primera página fija de videos públicos de Douyin con una consulta de texto y devuelve registros reel-video normalizados.

Solo se acepta query y debe ser una cadena no vacía. El endpoint no acepta results_limit, page, offset ni un cursor del proveedor proporcionado por quien llama.

No. El backend siempre envía la página 1 con desplazamiento 0 en una sola solicitud al proveedor, y no expone controles de paginación de la fuente.

Un next_cursor devuelto por GET /v1/tasks/{task_id} avanza por los registros que SocQ ya almacenó para la tarea completada. No obtiene otra página de la fuente de Douyin.

Los resultados usan el esquema reel-video y pueden incluir ID, URL, texto, contexto público del autor, contenido multimedia, duración, momentos de publicación y de recopilación, hashtags, menciones, audio y las cantidades visibles de reproducciones, Me gusta, comentarios y veces compartido. Los campos opcionales pueden ser null o estar vacíos.

Cada tarea exitosa cuesta un valor fijo de 0.10 créditos de SocQ, independientemente de la cantidad de registros devueltos por la única solicitud al proveedor.