API de plataforma de EveryData
API de Douyin
Busca videos y cuentas de Douyin, consulta publicaciones, comentarios, tendencias y texto extraído mediante acciones separadas. `user_id` identifica a la cuenta y la URL a un video concreto.
`hot_value`, posición de tablero y contadores de una pieza son señales distintas y puntuales. La transcripción no se supone cuando falta texto, y los comentarios no garantizan todo el árbol.
- Endpoint
- POST /api/v1/social
- Funciones
- 7
- Por 1.000
- 0,556 US$
Funciones disponibles
Compara las acciones de Douyin por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar videos en Douyin Busca videos de Douyin mediante | keyword | publish_time, sort | Entrega síncrona | El catálogo declara `defaultLimit = 10` y `maxLimit = 50` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | id · url · text · media_type · like_count · comment_count · share_count · collect_count · view_count · author_name · author_id · author_douyin_id · author_follower_count · region · posted_at · platform |
profileConsultar un perfil de Douyin Consulta una cuenta por | user_id | since | Entrega síncrona | — | $0.56 por 1.000 solicitudes | user_id · douyin_id · nickname · bio · url · follower_count · following_count · like_count · video_count · gender · ip_location · is_verified · avatar_url · platform |
user_postsListar publicaciones de una cuenta Obtiene publicaciones del | user_id | since | Entrega síncrona | El catálogo declara `defaultLimit = 20` y `maxLimit = 100` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | id · url · text · media_type · like_count · comment_count · share_count · collect_count · view_count · author_name · author_id · author_douyin_id · author_follower_count · region · posted_at · platform |
videoConsultar un video de Douyin Abre la | url | — | Entrega síncrona | — | $0.56 por 1.000 solicitudes | id · url · text · media_type · like_count · comment_count · share_count · collect_count · view_count · author_name · author_id · author_douyin_id · author_follower_count · region · posted_at · platform |
commentsLeer comentarios y respuestas Lee comentarios de la | url | — | Entrega síncrona | El catálogo declara `defaultLimit = 20` y `maxLimit = 100` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | id · text · like_count · reply_count · author_name · author_id · ip_location · liked_by_author · is_reply · reply_to_id · posted_at · platform |
trendingConsultar los tableros de tendencias Consulta el tablero de tendencias sin entrada obligatoria y permite seleccionar | boards | Entrega síncrona | El catálogo declara `defaultLimit = 20` y `maxLimit = 60` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | rank · keyword · hot_value · video_count · board · image_url · event_time · platform | |
transcriptExtraer el texto de un video Extrae texto disponible del video indicado por | url | — | Entrega síncrona | — | $0.56 por 1.000 solicitudes | id · url · title · text · posted_at · play_count · like_count · comment_count · share_count · collect_count · author_name · author_avatar · author_follower_count · platform |
¿Qué acepta cada acción de Douyin?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
¿Qué significan los parámetros de Douyin search?
Busca videos de Douyin mediante keyword y permite escoger ventana de publicación u orden. Devuelve autor, texto y contadores de interacción; el resultado no constituye una tendencia histórica ni una muestra exhaustiva.
keywordObligatorio- Palabra clave para buscar vídeos. Envía una cadena de texto, como
latte art. Se usa para buscar vídeos, no es un alias de cuenta ni un ID de vídeo. publish_timeOpcional- Periodo de publicación para la búsqueda de vídeos:
unlimited(sin límite, por defecto),one_day(últimas 24 horas),one_week(últimos 7 días) ohalf_year(últimos 6 meses). sortOpcional- Orden de los resultados de búsqueda de vídeos:
relevancepor relevancia (por defecto),newestpor los más recientes omost_likedpor mayor número de «me gusta». Es compatible con los valores antiguosgeneral(igual querelevance) ylatest(igual quenewest).
¿Qué significan los parámetros de Douyin profile?
Consulta una cuenta por user_id y recoge Douyin ID, apodo, biografía y contadores públicos. since no convierte el perfil en una serie temporal ni revela la lista de seguidores.
user_idObligatoriosecUiddel usuario de Douyin (normalmente empieza porMS4w), no el alias ni el ID numérico corto. Se usa para localizar la cuenta en las accionesprofileyuser_posts. Se puede obtener delauthor_iden los resultados de búsqueda o del enlace al perfil del usuario.Douyin: Open ID, Union ID y secUidLa plataforma abierta de Douyin diferencia Open ID y Union ID por su ámbito de aplicación. En EveryInfra, `user_id` sigue el formato `secUid` descrito en el contrato; no debe sustituirse por identificadores de la API oficial.ConsultadasinceOpcional- Fecha de publicación mínima para los vídeos de
profileouser_posts, en formato YYYY-MM-DD. Filtra los vídeos que se obtienen, no es la fecha de creación de la cuenta. Si se omite, no se aplica este filtro de fecha.
¿Qué significan los parámetros de Douyin user_posts?
Obtiene publicaciones del user_id desde la fecha compatible, conservando URL, texto, tipo de medio y métricas. No garantiza todas las piezas antiguas ni datos de audiencia privada.
user_idObligatoriosecUiddel usuario de Douyin (normalmente empieza porMS4w), no el alias ni el ID numérico corto. Se usa para localizar la cuenta en las accionesprofileyuser_posts. Se puede obtener delauthor_iden los resultados de búsqueda o del enlace al perfil del usuario.Douyin: Open ID, Union ID y secUidLa plataforma abierta de Douyin diferencia Open ID y Union ID por su ámbito de aplicación. En EveryInfra, `user_id` sigue el formato `secUid` descrito en el contrato; no debe sustituirse por identificadores de la API oficial.ConsultadasinceOpcional- Fecha de publicación mínima para los vídeos de
profileouser_posts, en formato YYYY-MM-DD. Filtra los vídeos que se obtienen, no es la fecha de creación de la cuenta. Si se omite, no se aplica este filtro de fecha.
¿Qué significan los parámetros de Douyin video?
Abre la url de un video de Douyin y devuelve contenido, autor, fecha y métricas visibles. No añade comentarios, transcripción o historial de cambios que pertenecen a acciones distintas.
urlObligatorio- Enlace completo al vídeo de Douyin, con el formato
https://www.douyin.com/video/<ID_de_vídeo>. La acciónvideoobtiene los detalles del vídeo,commentsobtiene sus comentarios ytranscriptextrae la transcripción del audio. No envíes la URL de un perfil de usuario o de una página de búsqueda.
¿Qué significan los parámetros de Douyin comments?
Lee comentarios de la url del video y distingue respuesta, autor, ubicación IP mostrada y reacción del creador cuando existen. No promete el árbol completo ni identifica personas reales.
urlObligatorio- Enlace completo al vídeo de Douyin, con el formato
https://www.douyin.com/video/<ID_de_vídeo>. La acciónvideoobtiene los detalles del vídeo,commentsobtiene sus comentarios ytranscriptextrae la transcripción del audio. No envíes la URL de un perfil de usuario o de una página de búsqueda.
¿Qué significan los parámetros de Douyin trending?
Consulta el tablero de tendencias sin entrada obligatoria y permite seleccionar boards. rank y hot_value son señales del tablero observado, no búsquedas por palabra ni una explicación del algoritmo.
boardsOpcional- Tipo de lista de tendencias. Puedes enviar una sola cadena o un array de cadenas para consultar varias listas a la vez:
hotspot(tendencias),seeding(promocionados),entertainment(entretenimiento),social(social) ychallenge(desafíos). Si se omite o se envía un array vacío, se usahotspotpor defecto.
¿Qué significan los parámetros de Douyin transcript?
Extrae texto disponible del video indicado por url, junto con metadatos y métricas de la pieza. No garantiza que todo audio tenga habla reconocible ni traduce el resultado automáticamente.
urlObligatorio- Enlace completo al vídeo de Douyin, con el formato
https://www.douyin.com/video/<ID_de_vídeo>. La acciónvideoobtiene los detalles del vídeo,commentsobtiene sus comentarios ytranscriptextrae la transcripción del audio. No envíes la URL de un perfil de usuario o de una página de búsqueda.
Cómo usar la API de Douyin
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo devuelto si la acción es asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"douyin","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de Douyin
¿Cómo llamo a la API de Douyin?
Envía POST /api/v1/social con platform igual a douyin, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Douyin?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye text, media_type, like_count y comment_count. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros de origen contengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Douyin?
La plataforma abierta de Douyin diferencia Open ID y Union ID por su ámbito de aplicación. En EveryInfra, user_id sigue el formato secUid descrito en el contrato; no debe sustituirse por identificadores de la API oficial.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; profile requiere user_id; user_posts requiere user_id; consulta las demás acciones en la lista de funciones.