API de redes sociales
Douyin API
Lee videos, perfiles, comentarios, búsquedas, rankings de contenido popular, el mercado de creadores Xingtu y datos de comercio electrónico de 抖音 — la cobertura de Douyin más profunda disponible fuera de China.
- Seis series de API, incluidos los rankings exclusivos de Douyin y el mercado de creadores Xingtu
- Detecta las tendencias de consumo chinas semanas antes de que afloren en las plataformas occidentales
- Una clave, JSON estructurado — sin registro de desarrollador chino ni aprobación de la plataforma abierta de 抖音
$0.05 de crédito gratis al registrarte · sin tarjeta · desde $0.001/petición
Una petición, JSON estructurado
1curl -X GET "https://api.tikhub.io/api/v1/douyin/app/v3/fetch_one_video?aweme_id=7350810998023949599" \2 -H "Authorization: Bearer YOUR_API_KEY"1{2 "code": 200,3 "data": {4 "aweme_id": "7350810998023949599",5 "desc": "示例视频文案 #热门",6 "create_time": 1711305600,7 "statistics": {8 "play_count": 3120000,9 "digg_count": 214000,10 "comment_count": 5230,11 "share_count": 1840,12 "collect_count": 2210013 },14 "author": {15 "uid": "98765432101234",16 "nickname": "用户昵称",17 "follower_count": 880000,18 "unique_id": "douyin_id"19 },20 "video": { "duration": 21000, "play_addr": { "url_list": ["https://..."] } }21 }22}Consigue tu clave API en user.tikhub.io/dashboard/api — o sigue la guía de primeros pasos.
Qué incluye la API de Douyin
La Douyin API de TikHub cubre la mayor plataforma de video corto de China a través de varias series: los endpoints recomendados de App V3, una serie de búsqueda dedicada, los endpoints web, la plataforma de marketing de creadores Xingtu (星图), los rankings de contenido popular (榜单), el Centro de Servicios al Creador público y el índice de analítica de tendencias 抖音指数. Si tu investigación, tu operativa de trading o tu inteligencia de marketing tocan la internet china, esta es la capa de datos.
Douyin App V3 API (recomendada)
Douyin Search API ($0.01)
Douyin Web API
Douyin Xingtu (星图) API
Douyin Billboard (榜单) API
Creator & Index (指数) API
Rankings y Xingtu — las superficies exclusivas de China
Douyin (抖音) es la app china independiente de ByteDance, y la mayoría de los proveedores o no la cubren o se quedan en los datos básicos de video. TikHub ofrece superficies exclusivas de Douyin que ninguna API de TikTok tiene: los rankings de contenido popular y las tablas por categoría, los datos del mercado de creadores Xingtu que las marcas usan para evaluar KOLs, y los listados completos de comercio electrónico. Es la diferencia entre observar China y leerla de verdad.
Endpoints de la API de Douyin
Una referencia de los endpoints de Douyin más usados. Explora el conjunto completo en la referencia de la API o la documentación.
Douyin App V3 API (recomendada)
La serie más estable — priorízala y recurre a la Web solo cuando App V3 dé errores. El número de reproducciones no está en los endpoints estándar de video; usa fetch_video_statistics.
Douyin Search API (dedicada — $0.01/solicitud)
La búsqueda de Douyin tiene su propia serie — NO uses la búsqueda de las series Web o App V3, no son funcionales. Se factura a $0.01/solicitud (sin descuento por volumen), está paginada y devuelve en torno a 6–10 resultados por llamada, con una cantidad que varía cada vez.
Douyin Web API
Alternativa a App V3, más los resolutores de URL → ID (sec_user_id / aweme_id) y los datos de salas de directo.
Douyin Xingtu (星图) API
La plataforma oficial de marketing con KOLs de Douyin. Resuelve primero el kolid de Xingtu de un creador (por uid / sec_user_id / unique_id) y después extrae sus analíticas de KOL. Una serie Xingtu V2 más reciente (/api/v1/douyin/xingtu_v2/…, unos 20 endpoints) añade rankings y el mercado de creadores.
Douyin Billboard (榜单) API
Clasificaciones de contenido popular sin equivalente en TikTok — listas de videos populares y en alza, de temas, de búsquedas y de cuentas, más perfiles de audiencia y tendencias de datos de fans.
Douyin Creator & Index (抖音指数) API
Otras dos familias exclusivas de Douyin. Creator V1 (/api/v1/douyin/creator/…) son datos públicos del Centro de Servicios al Creador — sin inicio de sesión. Creator V2 (/api/v1/douyin/creator_v2/…) son analíticas de cuenta para tu propia cuenta y requieren tu cookie de la plataforma de creadores de Douyin. La serie 抖音指数 (/api/v1/douyin/index/…, unos 44 endpoints) cubre analíticas de tendencias de palabras clave, creadores, videos y marcas. Consulta la lista completa en la interfaz Swagger.
Consejos y resolución de problemas
Notas operativas ganadas a pulso para trabajar con datos de Douyin en producción.
Versión de la API recomendada
Prioriza los endpoints de Douyin App V3 por su estabilidad y usa los endpoints web de Douyin solo como alternativa cuando App V3 devuelva errores.
La búsqueda es una serie dedicada — y cuesta más
No llames a la búsqueda desde las series Web o App V3; esos endpoints de búsqueda no son funcionales. Usa en su lugar la serie dedicada /api/v1/douyin/search/*. Su precio es de $0.01 por solicitud sin descuento por volumen (alto costo de mantenimiento), está paginada y devuelve en torno a 6–10 resultados por llamada — la cifra exacta varía cada vez, así que recibir menos de lo esperado es normal.
Las reproducciones requieren su propio endpoint
El número de reproducciones de un video de Douyin NO viene incluido en los endpoints estándar de obtención de video. Usa el endpoint dedicado fetch_video_statistics (/api/v1/douyin/app/v3/fetch_video_statistics) para obtenerlo. Ten en cuenta que el recuento de visualizaciones devuelto excluye el tráfico de promoción de pago de Dou+.
Resultados vacíos con estado 200 — consulta el código de motivo
Si la obtención de video de App V3 devuelve resultados vacíos pero con estado 200, el video está filtrado, no ausente — reintenta con la versión Web y revisa $.data.filter_list[0].reason para saber por qué. Para cualquier otro código, contacta con el soporte.
| filter_list[0].reason | Significado |
|---|---|
| 8 | No disponible por restricción de derechos de autor en el extranjero (microseries, fragmentos de películas), o eliminado |
| 5 | Cuenta privada / video privado |
| 10 | Visible parcialmente — el autor lo restringió a espectadores seleccionados |
Resuelve sec_user_id y aweme_id desde las URLs
La mayoría de los endpoints se indexan por sec_user_id (usuario) o aweme_id (video). Extráelos de cualquier URL de Douyin con los resolutores web dedicados antes de llamar a los endpoints de analítica o de video.
1GET /api/v1/douyin/web/get_sec_user_id?url=<douyin_user_url> // docs: 186826167e02GET /api/v1/douyin/web/get_aweme_id?url=<douyin_video_url> // docs: 186826169e0Creator V2 necesita la cookie de tu propia cuenta
Cualquier endpoint bajo /api/v1/douyin/creator_v2/* devuelve analíticas a nivel de cuenta para la PROPIA cuenta de un creador y requiere una cookie válida de la plataforma de creadores de Douyin de ese usuario (enviada en el cuerpo del POST). Sin acceso a la cuenta, estos datos no se pueden obtener. La serie pública Creator V1 (/api/v1/douyin/creator/*) no requiere inicio de sesión.
Douyin no tiene API de Shop — usa TikTok Shop
Douyin no ofrece endpoints de tienda ni de productos. Si necesitas datos de comercio electrónico o de productos, usa en su lugar la TikTok Shop API (solo TikTok).
Descargas y errores 400
Para las descargas, prefiere la serie App V3; los enlaces de descarga tienen tiempo limitado, así que vuelve a obtenerlos cuando uno expire. Un 400 suele significar que el objetivo ya no existe — verifica que el video o el usuario de Douyin siga disponible y sea público en la app antes de tratarlo como un fallo de la API.
Transmisiones en directo
Para cualquier consulta sobre directos de Douyin, usa la Live Room API. Ten en cuenta que los espectadores anónimos, y los usuarios con el modo invisible activado en las salas de directo, no se pueden obtener a través de la API.
Comentarios y paginación
En los endpoints de comentarios, mantén el count solicitado en 30 o menos — un count mayor puede provocar errores o elementos faltantes. Los endpoints paginados (comentarios, búsqueda, etc.) devuelven a menudo menos elementos de los solicitados; es paginación normal, no un error — sigue paginando con el cursor devuelto para obtener más resultados.
¿Cuál es la diferencia entre la Douyin API y la TikTok API?
Douyin (抖音) es la app china independiente de ByteDance, con su propio contenido, sus propias cuentas y su propia infraestructura. TikHub ofrece series de API dedicadas para cada una — incluidas superficies exclusivas de Douyin, como los rankings y el mercado de creadores Xingtu, que no tienen equivalente en TikTok.
¿Necesito una cuenta de desarrollador china o la aprobación de la plataforma abierta de 抖音?
No. Crea una cuenta de TikHub, genera una clave de API y llama a los endpoints REST. No hay registro de desarrollador chino, ni solicitud a la plataforma abierta, ni OAuth.
¿Es legal usar una API de Douyin como esta?
TikHub solo devuelve datos de Douyin disponibles públicamente — contenido que cualquier visitante puede ver sin cuenta. No elude la autenticación ni accede a información privada. Douyin es una plataforma china, por lo que las restricciones relevantes son sus propias condiciones de servicio y la normativa china de datos y de transferencias transfronterizas, más que la jurisprudencia estadounidense; el acceso automatizado puede derivar en bloqueos de cuenta o de IP, que la infraestructura de TikHub absorbe por ti. Tú sigues siendo responsable de cómo almacenes, trates y uses los datos — en especial cualquier dato personal y cualquier transferencia posterior a través de fronteras.
¿Cuál es el límite de velocidad?
El límite de velocidad por defecto es de 10 solicitudes por segundo. Los planes de RPS lo escalan hacia arriba — de 20 RPS por $5/mes a 100 RPS por $55/mes — y las cuentas enterprise obtienen límites personalizados por encima de 100 RPS.
¿Cuánto cuesta la Douyin API?
La mayoría de los endpoints de Douyin son de pago por uso desde $0.001 por solicitud, con descuentos automáticos por volumen diario hasta $0.0005 a partir de 30,000 solicitudes/día. La única excepción es la serie dedicada de búsqueda de Douyin, facturada aparte a $0.01 por solicitud y sin descuento por volumen, lo que refleja su mayor costo de mantenimiento. Las cuentas nuevas reciben $0.05 de crédito gratis — sin tarjeta de crédito.
Douyin API: el acceso a datos de 抖音 más profundo disponible fuera de China en 2026
La Douyin API de TikHub lee datos públicos de 抖音 — videos, perfiles, comentarios, búsqueda, rankings de contenido popular, el mercado de creadores Xingtu y comercio electrónico — mediante simples llamadas REST, sin registro de desarrollador chino. Aquí tienes cómo funciona, qué la hace más profunda que una extracción genérica, dónde están sus límites y qué opción encaja con cada trabajo.
¿Cómo funciona la Douyin API?
¿Qué es la Douyin API?
La Douyin API de TikHub es una interfaz RESTful que devuelve JSON estructurado para contenido público de 抖音 — la app china de video corto de ByteDance, una plataforma distinta de TikTok, con su propio contenido, sus propias cuentas y su propia infraestructura. Solicitas un video, un perfil, un hilo de comentarios, una búsqueda, un ranking o un registro de Xingtu y recibes datos limpios y tipados.
Abarca seis series, incluidas superficies exclusivas de Douyin — los rankings de contenido popular y el mercado de creadores Xingtu — que no tienen equivalente en TikTok. Para cualquiera cuya investigación, operativa de trading o inteligencia de marketing toque la internet china, es la capa de datos de la mayor plataforma de ese mercado.
¿Cómo se accede y se usa?
Crea una cuenta de TikHub, genera una clave de API y haz una solicitud HTTP GET con la clave en la cabecera Authorization. Identifica el contenido por aweme_id (el ID de video de Douyin), el sec_uid de un usuario, una URL para compartir o un término de búsqueda, y recibes JSON. No hay registro de desarrollador chino, ni solicitud a la plataforma abierta de 抖音, ni OAuth.
¿Qué lenguajes de programación son compatibles?
Cualquier lenguaje capaz de hablar HTTP — Python, JavaScript/TypeScript, Go, Java, PHP y más — además de herramientas no-code. Python es habitual en pipelines de datos del mercado chino, y hay un SDK oficial disponible, pero la API es independiente del lenguaje; la forma de la solicitud es idéntica en todos los stacks.
¿Qué ventajas tiene usar la Douyin API?
¿Por qué es más profunda que una recolección genérica de video corto?
La mayoría de los proveedores o no cubren Douyin o se quedan en los datos básicos de video y perfil. TikHub añade las superficies que de verdad importan para la inteligencia sobre China: la serie Billboard con rankings de contenido popular y por categoría, la serie Xingtu con datos oficiales del mercado de creadores para evaluar KOLs, listados completos de comercio electrónico, comentarios danmaku y búsqueda dedicada sobre videos, usuarios, música y directos.
Esa amplitud es la diferencia entre observar Douyin y leerla — entre saber que un video se hizo viral y entender a qué ranking subió, qué nivel de creador lo produjo y cómo reaccionó la audiencia momento a momento.
¿Cuánto tiempo ahorra?
Douyin es más difícil de acceder que la mayoría de las plataformas occidentales — respuestas en chino, medidas anti-bot agresivas y esquemas de firma que cambian. Construir y mantener todo eso por tu cuenta es un esfuerzo considerable y continuo. TikHub lo absorbe y expone un contrato estable, de modo que un equipo puede leer datos sociales chinos en una tarde en lugar de en un trimestre, y seguir leyéndolos sin una carga de mantenimiento dedicada.
¿Quién se beneficia: analistas, marcas o equipos de IA?
Los analistas del mercado chino detectan tendencias de consumo semanas antes de que afloren en occidente. Las marcas evalúan y contratan creadores con los datos de Xingtu y vigilan a sus competidores en el comercio electrónico de Douyin. Los equipos de IA construyen corpus en chino y modelos de predicción de tendencias a partir de una fuente estructurada. Para los tres, los rankings exclusivos de Douyin y los datos del mercado de creadores son señales que una extracción genérica no puede ofrecer.
¿Qué limitaciones tiene la Douyin API?
¿Qué datos están disponibles y cuáles no?
La API devuelve datos públicos de 抖音 — videos, perfiles, comentarios, búsqueda, rankings, registros del mercado Xingtu, salas de directo y listados de comercio electrónico. Las cuentas privadas, los mensajes directos y las analíticas no públicas no son accesibles, y la API es de solo lectura: no publica, no comenta y no sigue. Los endpoints de sala de directo devuelven datos únicamente mientras la sala está emitiendo.
¿Hay consideraciones de derechos de autor o de descarga?
Algunas URLs de reproducción de Douyin llevan restricciones de derechos de autor. Usa el endpoint de video individual de App V3, que devuelve contenido sin esas restricciones, y los endpoints dedicados de URL de reproducción de máxima calidad para obtener el mejor stream. Los enlaces de descarga tienen tiempo limitado — vuelve a obtenerlos si alguno deja de funcionar — y las restricciones regionales pueden requerir un proxy, igual que en TikTok.
¿Hay límites de velocidad?
El valor por defecto es de 10 solicitudes por segundo, ampliable con los planes de RPS. Los endpoints de comentarios, búsqueda y listas se paginan con cursor y devuelven páginas acotadas; sigue el cursor para obtener más. Prefiere los endpoints de App V3 por estabilidad y recurre a la serie Web solo cuando haga falta.
¿Cuáles son los casos de uso habituales de la Douyin API?
¿Cómo se usa para investigación del mercado chino?
Los analistas usan la búsqueda, los rankings y los datos de tendencias para leer el comportamiento del consumidor chino en su origen — qué está subiendo, qué creadores lo impulsan y cómo varía por categoría. Como las tendencias de Douyin suelen preceder a las occidentales, esto funciona como un sistema de alerta temprana para marcas e inversores que vigilan el mercado doméstico de ByteDance.
¿Cómo se usa para inteligencia de influencers y de comercio electrónico?
Los datos del mercado Xingtu permiten a las marcas evaluar creadores con señales reales de rendimiento y de precio antes de contratar campañas, mientras que los listados de comercio electrónico y de tipo Shop apoyan el monitoreo competitivo de productos y vendedores. Juntos convierten a Douyin en una fuente de inteligencia de embudo completo, del descubrimiento de creadores al seguimiento del comercio.
¿Cómo impulsa la IA y los modelos de tendencias?
Los datos estructurados en chino de videos, descripciones, comentarios y danmaku alimentan corpus de entrenamiento, pipelines de sentimiento y modelos de predicción de tendencias. Los rankings y la búsqueda en tiempo real dan a los agentes una lectura en vivo de la internet china. El flujo de danmaku, en particular, permite modelar la interacción momento a momento, algo que las métricas agregadas no capturan.
¿Existen alternativas a la Douyin API?
¿Qué otras herramientas de datos de Douyin existen?
La plataforma abierta oficial de Douyin existe, pero exige registro mercantil chino y aprobación, y expone una porción estrecha y sancionada. Hay un puñado de herramientas de código abierto para Douyin (a menudo proyectos en chino), pero cargan con la habitual carga de fiabilidad y mantenimiento frente a una plataforma difícil de recolectar. Muy pocos proveedores de datos occidentales cubren Douyin con profundidad.
¿Qué opción es la mejor según la necesidad?
Si tienes una entidad mercantil china y solo necesitas la porción sancionada de la plataforma abierta, esa vía existe. Para todos los demás — en especial equipos no chinos que necesitan profundidad real, incluidos los rankings y Xingtu —, una API gestionada como TikHub es la opción práctica: la cobertura de Douyin más profunda accesible en occidente, una sola clave, sin registro chino, y esa misma clave funciona en TikTok y en otras 14 plataformas.
Una clave, todas las plataformas
La API de Douyin comparte su clave y su formato JSON con otras 15 plataformas — añadir Instagram o Douyin es un cambio de una línea.