API de Douyin
Douyin ofrece 18 acciones para videos, creadores, audiencia, Xingtu, productos, comentarios, tendencias y transcripciones. Cada acción indica sus entradas y campos.
Usa creator_search para encontrar cuentas, user_id para audiencia y tendencias y douyin_id para consultas detalladas de Xingtu. La búsqueda, el detalle y el descubrimiento de productos en directo son independientes del historial de ventas del creador.
Disponibilidad de la plataforma
- Salud 24 h
- 96 %
Últimos 30 días
Funciones disponibles
Cada acción de Douyin, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar videos en Douyinsearch | Busca videos de Douyin mediante keyword y permite escoger ventana de publicación u orden. | $0.56 por 1.000 solicitudes | Saludable · salud 98 % |
Consultar un perfil de Douyinprofile | Consulta una cuenta por user_id y recoge Douyin ID, apodo, biografía y contadores públicos. | $0.56 por 1.000 solicitudes | Normal |
Listar publicaciones de una cuentauser_posts | Lista los videos de una cuenta a partir de su user_id (el secUid), con texto, tipo de medio, duración y métricas. | $0.56 por 1.000 solicitudes | Normal |
Consultar un video de Douyinvideo | Abre la url de un video de Douyin y devuelve contenido, autor, fecha y métricas visibles. | $0.56 por 1.000 solicitudes | Saludable · salud 98 % |
Leer comentarios y respuestascomments | Lee comentarios de la url del video y distingue respuesta, autor, ubicación IP mostrada y reacción del creador cuando existen. | $0.56 por 1.000 solicitudesCada 20 filas cuentan como una llamada | Normal |
Consultar los tableros de tendenciastrending | Consulta el tablero de tendencias sin entrada obligatoria y permite seleccionar boards. | $0.56 por 1.000 solicitudes | Saludable · salud 100 % |
Extraer el texto de un videotranscript | Extrae texto disponible del video indicado por url, junto con metadatos y métricas de la pieza. | $0.56 por 1.000 solicitudes | Normal |
Buscar cuentas de creadorescreator_search | Busca cuentas candidatas mediante keyword y permite acotar por los valores declarados de follower_range y user_type. | $0.56 por 1.000 solicitudes | Normal |
Analizar la audiencia de un creadorcreator_audience | Para un user_id, consulta la distribución, el TGI y el código de la dimension elegida; si se omite, usa el rango de precio del dispositivo. | $0.56 por 1.000 solicitudes | Normal |
Consultar la evolución de seguidorescreator_trend | Consulta para un user_id la serie follower_trend y el promedio de seguidores disponibles. | $0.56 por 1.000 solicitudes | Normal |
Comparar indicadores de una cuentacreator_benchmark | Compara promedios y percentiles de publicaciones, comentarios, compartidos, crecimiento y me gusta para un user_id. | $0.56 por 1.000 solicitudes | Normal |
Buscar creadores en Xingtuxingtu_creator_search | Busca registros de creadores de Xingtu mediante keyword. | $0.56 por 1.000 solicitudes | Normal |
Consultar la analítica de un creador en Xingtuxingtu_creator_analytics | Usa el douyin_id visible devuelto por la acción ordinaria creator_search para consultar una ficha analítica de Xingtu; xingtu_creator_search no proporciona este dato. | $0.56 por 1.000 solicitudes | Normal |
Consultar las tarifas de un creador en Xingtuxingtu_rate_card | Usa el douyin_id devuelto por creator_search, no la salida de xingtu_creator_search, para consultar los rate_tiers disponibles de un creador en Xingtu. | $0.56 por 1.000 solicitudes | Normal |
Consultar rankings de creadores en Xingtuxingtu_creator_rankings | Selecciona industry, ranking_type y time_window para consultar una instantánea acotada de un ranking de Xingtu. | $0.56 por 1.000 solicitudes | Normal |
Buscar productos de Douyinproduct_search | Busca productos mediante keyword y devuelve precio, ventas, tienda, comisión y creadores colaboradores. | $0.56 por 1.000 solicitudes | Normal |
Consultar el detalle de un producto de Douyinproduct_detail | Consulta un producto mediante un product_id numérico, con galería, variantes, tienda y cifra pública de unidades vendidas. | $0.56 por 1.000 solicitudes | Saludable · salud 91 % |
Buscar productos de Douyin actualmente en directolive_product_search | Busca productos actualmente en directo mediante keyword y devuelve su live_room_id hasta el límite indicado. | $0.56 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿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.
| 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 · video_url · like_count · comment_count · share_count · collect_count · author_name · author_id · author_douyin_id · author_avatar_url · cover_image_url · author_follower_count · posted_at · platform · duration_sec · duration_seconds · hashtags · view_count · region · author_uid · author_is_verified · author_bio · author_following_count · author_like_count · author_video_count · author_ip_location · title · music · download_count · forward_count · is_pinned · is_ad · video_tags · video_width · video_height · video_resolution · animated_cover_url · image_urls |
profileConsultar un perfil de Douyin Consulta una cuenta por | user_id | — | 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 · uid · background_image_url · country · language · is_live · likes_given_count · has_shop · platform · verify_reason |
user_postsListar publicaciones de una cuenta Lista los videos de una cuenta a partir de su | user_id | page_token, 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. Para la siguiente página, devuelve next_page_token como page_token sin cambiar los demás parámetros; cada página es una llamada. | $0.56 por 1.000 solicitudes | next_page_token · id · url · text · media_type · video_url · like_count · comment_count · share_count · collect_count · author_name · author_id · author_douyin_id · author_avatar_url · cover_image_url · author_follower_count · posted_at · platform · duration_sec · duration_seconds · hashtags · view_count · region · author_uid · author_is_verified · author_bio · author_following_count · author_like_count · author_video_count · author_ip_location · title · music · download_count · forward_count · is_pinned · is_ad · video_tags · video_width · video_height · video_resolution · animated_cover_url · image_urls |
videoConsultar un video de Douyin Abre la | url | — | Entrega síncrona | — | $0.56 por 1.000 solicitudes | id · url · text · media_type · video_url · like_count · comment_count · share_count · collect_count · author_name · author_id · author_douyin_id · author_avatar_url · cover_image_url · author_follower_count · posted_at · platform · duration_sec · duration_seconds · hashtags · view_count · region · author_uid · author_is_verified · author_bio · author_following_count · author_like_count · author_video_count · author_ip_location · title · music · download_count · forward_count · is_pinned · is_ad · video_tags · video_width · video_height · video_resolution · animated_cover_url · image_urls |
commentsLeer comentarios y respuestas Lee comentarios de la | url | page_token | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 150 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. Para la siguiente página, devuelve next_page_token como page_token sin cambiar los demás parámetros; cada página es una llamada. | $0.56 por 1.000 solicitudesCada 20 filas cuentan como una llamada | next_page_token · id · text · like_count · reply_count · author_name · author_id · ip_location · is_hot · is_reply · reply_to_id · posted_at · video_id · platform · liked_by_author · author_avatar_url · author_uid · images · mentioned_users |
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 · sentence_id · group_id · label · word_type · article_count · is_pinned · max_rank · live_room_count · 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 · segments · video_url · audio_url · duration_sec · duration_seconds · recommend_count · author_like_count · platform |
creator_searchBuscar cuentas de creadores Busca cuentas candidatas mediante | keyword | follower_range, user_type | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 20 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 | user_id · douyin_id · nickname · url · avatar_url · follower_count · gender · is_verified · verify_reason · is_live · uid · source_keyword · platform |
creator_audienceAnalizar la audiencia de un creador Para un | user_id | dimension | Entrega síncrona | — | $0.56 por 1.000 solicitudes | user_id · audience_distribution · audience_tgi · dimension_code · platform |
creator_trendConsultar la evolución de seguidores Consulta para un | user_id | — | Entrega síncrona | — | $0.56 por 1.000 solicitudes | user_id · follower_trend · average_follower_count · dimension_code · platform |
creator_benchmarkComparar indicadores de una cuenta Compara promedios y percentiles de publicaciones, comentarios, compartidos, crecimiento y me gusta para un | user_id | — | Entrega síncrona | — | $0.56 por 1.000 solicitudes | user_id · average_post_count · average_comment_count · average_share_count · average_follower_growth · average_like_count · post_count_percentile · comment_count_percentile · share_count_percentile · follower_growth_percentile · like_count_percentile · platform |
xingtu_creator_searchBuscar creadores en Xingtu Busca registros de creadores de Xingtu mediante | keyword | — | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 20 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 | creator_id · user_id · nickname · follower_count · gender · city · province · creator_score · engagement_rate_30d · expected_play_count · expected_natural_play_count · interaction_median_30d · play_over_rate_30d · follower_growth_30d · follower_growth_rate_15d · content_themes · ecommerce_level · ecommerce_score · gmv_30d_range · gpm_30d_range · average_order_value_30d_range · commercial_index · conversion_index · spread_index · shopping_index · quote_1_20s_cny · quote_20_60s_cny · quote_60s_plus_cny · platform |
xingtu_creator_analyticsConsultar la analítica de un creador en Xingtu Usa el | douyin_id | — | Entrega síncrona | — | $0.56 por 1.000 solicitudes | creator_id · creator_type · follower_count · average_play_count · city · province · gender · category_id · content_themes · tags · creator_grade · is_xingtu_creator · ecommerce_enabled · lowest_quote_cny · platform |
xingtu_rate_cardConsultar las tarifas de un creador en Xingtu Usa el | douyin_id | — | Entrega síncrona | — | $0.56 por 1.000 solicitudes | creator_id · rate_tiers · platform |
xingtu_creator_rankingsConsultar rankings de creadores en Xingtu Selecciona | industry, ranking_type, time_window | — | Entrega síncrona | El catálogo declara defaultLimit = 5 y maxLimit = 5 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 | creator_id · user_id · url · nickname · avatar_url · gender · city · province · follower_count · cpm_cny · completed_order_range · repurchase_rate_range · item_order_rate · average_view_count · industry · rank · previous_rank · ranking_score · is_new · ranking_board · period_days · snapshot_date · source_kind · platform |
product_searchBuscar productos de Douyin Busca productos mediante | keyword | — | Entrega síncrona | El catálogo declara defaultLimit = 5 y maxLimit = 5 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 | product_id · promotion_id · title · url · image_url · white_image_url · price_cny · price_cny_minor · price_label · monthly_sales · good_review_ratio · sales_trend · category_path · category_ids · category_depth · shop_id · shop_name · shop_logo_url · shop_score · commission_rate_percent · commission_cny · cooperating_creator_count · tags · source_keyword · search_rank · recommend_reason · platform |
product_detailConsultar el detalle de un producto de Douyin Consulta un producto mediante un | product_id | — | Entrega síncrona | — | $0.56 por 1.000 solicitudes | product_id · title · price_cny · discount_price_cny · sales_text · sold_count · shop_id · shop_name · shop_avatar_url · image_url · main_image_urls · detail_image_urls · assurances · shipping_fee_text · shipping_estimate_text · variant_groups · on_sale · platform |
live_product_searchBuscar productos de Douyin actualmente en directo Busca productos actualmente en directo mediante | keyword | — | Entrega síncrona | El catálogo declara defaultLimit = 3 y maxLimit = 3 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 | product_id · sku_id · title · image_url · price_cny · shop_id · live_room_id · is_live_product · source_keyword · platform |
¿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).Valores permitidos:half_yearone_dayone_weekunlimited 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).Valores permitidos:most_likednewestrelevance
¿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. Sus publicaciones se consultan con user_posts; el perfil no incluye 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 secUid — 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. · Consultada
¿Qué significan los parámetros de Douyin user_posts?
Lista los videos de una cuenta a partir de su user_id (el secUid), con texto, tipo de medio, duración y métricas. Sin page_token devuelve el lote más reciente y acepta since; con page_token recorre la lista completa página a página.
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 secUid — 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. · Consultadapage_tokenOpcional- Token de paginación para
user_posts: envía una cadena vacíapage_token=""para empezar por la página más reciente y después devuelve tal cual elnext_page_tokende cada respuesta, sin cambiar los demás parámetros. Los tokens duran 24 horas y solo sirven para la misma cuenta y los mismos parámetros; la última página no traenext_page_token. Cada página trae hasta 100 filas, de más recientes a más antiguas, y omite el límite inferiorsince; filtra porposted_aten tu lado si necesitas una ventana de fechas. Cada página es una llamada. sinceOpcional- 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. page_tokenOpcional- Token de paginación para
user_postsycomments. Para empezar a paginar, envía una cadena vacíapage_token=""; después devuelve tal cual elnext_page_tokende la respuesta anterior para obtener la página siguiente, sin cambiar los demás parámetros. Los tokens duran 24 horas y solo sirven para la misma cuenta y los mismos parámetros; si caducó o no coincide, la respuesta es 422 y hay que empezar de nuevo desde la primera página. En la última página la respuesta no traenext_page_token(pagination.has_morees false). Cada página deuser_postses una llamada y trae hasta 100 filas, de más recientes a más antiguas, sin filtrar porsince(filtra porposted_aten tu lado si necesitas una ventana de fechas). Las páginas decommentstraen hasta 50 comentarios de primer nivel y se cobran por bloques de filas: cada 20 filas cuentan como una llamada, así que una página cuenta como 3 llamadas por sus 50 filas (con unlimitmenor cuentan esas filas) y los bloques que vuelven sin filas no se cobran. Sinpage_tokenla llamada es una consulta única:user_postsdevuelve el lote más reciente (se aplicasince) ycommentssolo la cabecera de la lista, con respuestas, también a una llamada por cada 20 filas: 20 filas por defecto y como mucho unas 50-60 aunque subaslimit, normalmente sinnext_page_token.
¿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.Valores permitidos:challengeentertainmenthotspotseedingsocial
¿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.
¿Qué significan los parámetros de Douyin creator_search?
Busca cuentas candidatas mediante keyword y permite acotar por los valores declarados de follower_range y user_type. Son filtros de descubrimiento de cuentas, no resultados de video, compradores ni identidad legal verificada.
keywordObligatorio- Apodo, Douyin ID o término relacionado para descubrir cuentas de creadores. No ejecuta la búsqueda de videos ni garantiza una coincidencia de identidad exacta.
follower_rangeOpcional- Intervalo de seguidores para
creator_search:under_1k,1k_to_10k,10k_to_100k,100k_to_1muover_1m. Omite el parámetro para no limitar el intervalo; no representa compradores ni audiencia de una pieza concreta.Valores permitidos:100k_to_1m10k_to_100k1k_to_10kover_1munder_1k user_typeOpcional- Tipo de cuenta para
creator_search:general,businessoverified_individual. No es una categoría de comprador ni una acreditación independiente de identidad legal.Valores permitidos:businessgeneralverified_individual
¿Qué significan los parámetros de Douyin creator_audience?
Para un user_id, consulta la distribución, el TGI y el código de la dimension elegida; si se omite, usa el rango de precio del dispositivo. Los valores de distribución son proporciones decimales sin convertir, entre 0 y 1, no puntos porcentuales; TGI es un índice independiente. Estas señales no identifican compradores, compras ni personas contactables.
user_idObligatorio- El
secUiddel creador de Douyin, normalmente con prefijoMS4w, para consultar distribuciones y señales TGI disponibles. Usa eluser_iddel descubrimiento de creadores, no un apodo, Douyin ID corto ni identificador de comprador. dimensionOpcional- Vista de segmentos de seguidores para
creator_audience:device_price_band(predeterminada),gender,ageoprovince. Los valores de la distribución son proporciones decimales sin convertir, entre 0 y 1, no porcentajes; TGI sigue siendo un índice separado. No solicita seguidores nominales ni datos de compradores.Valores permitidos:agedevice_price_bandgenderprovince
¿Qué significan los parámetros de Douyin creator_trend?
Consulta para un user_id la serie follower_trend y el promedio de seguidores disponibles. La secuencia es una observación y no prueba que una campaña o un producto causara el crecimiento.
user_idObligatorio- El
secUiddel creador de Douyin, normalmente con prefijoMS4w, para consultar la serie de seguidores disponible. No es un apodo ni el Douyin ID numérico corto.
¿Qué significan los parámetros de Douyin creator_benchmark?
Compara promedios y percentiles de publicaciones, comentarios, compartidos, crecimiento y me gusta para un user_id. Son indicadores relativos de cuenta, no ventas, conversiones ni atribución causal.
user_idObligatorio- El
secUiddel creador de Douyin, normalmente con prefijoMS4w, para consultar promedios y percentiles de la cuenta. No es un apodo ni el Douyin ID numérico corto.
¿Qué significan los parámetros de Douyin xingtu_creator_search?
Busca registros de creadores de Xingtu mediante keyword. Puntuaciones, tasas, reproducciones esperadas, crecimiento, temas, rangos comerciales, índices y cotizaciones por duración describen la instantánea devuelta; no son transacciones, entrega garantizada ni GMV exacto.
keywordObligatorio- Término de búsqueda de creadores para
xingtu_creator_search. Elcreator_iddevuelto identifica y permite comparar registros dentro de este resultado de Xingtu;xingtu_creator_analyticsyxingtu_rate_cardno lo aceptan, pues requieren eldouyin_iddevuelto por la acción ordinariacreator_search. No es una palabra de producto ni una búsqueda de videos.
¿Qué significan los parámetros de Douyin xingtu_creator_analytics?
Usa el douyin_id visible devuelto por la acción ordinaria creator_search para consultar una ficha analítica de Xingtu; xingtu_creator_search no proporciona este dato. No lo confundas con user_id ni creator_id; tipo, grado, métricas, señales comerciales y cotización mínima no acreditan identidad legal ni rendimiento futuro.
douyin_idObligatorio- ID visible de la cuenta de Douyin (
unique_id) devuelto por la acción ordinariacreator_searchy requerido porxingtu_creator_analyticsyxingtu_rate_card;xingtu_creator_searchno lo devuelve. Es distinto de unuser_idsecUid, delcreator_idde Xingtu y del apodo.
¿Qué significan los parámetros de Douyin xingtu_rate_card?
Usa el douyin_id devuelto por creator_search, no la salida de xingtu_creator_search, para consultar los rate_tiers disponibles de un creador en Xingtu. Cada nivel puede incluir formato, precio mostrado, precio de lista, texto de liquidación, tipo de video y estado de apertura; es una tarifa observada, no un contrato aceptado, una liquidación final ni una promesa de entrega.
douyin_idObligatorio- ID visible de la cuenta de Douyin (
unique_id) devuelto por la acción ordinariacreator_searchy requerido porxingtu_creator_analyticsyxingtu_rate_card;xingtu_creator_searchno lo devuelve. Es distinto de unuser_idsecUid, delcreator_idde Xingtu y del apodo.
¿Qué significan los parámetros de Douyin xingtu_creator_rankings?
Selecciona industry, ranking_type y time_window para consultar una instantánea acotada de un ranking de Xingtu. Posición, posición anterior, puntuación, CPM, rangos de pedidos o recompra y periodo solo se comparan dentro del tablero y la ventana devueltos; no son totales exactos ni pronósticos.
industryObligatorio- Industria del ranking de creadores de Xingtu:
apparel_accessories,automotive,beauty,electronics,food_beverage,household_goodsomother_baby_pets. Es un filtro del tablero, no una etiqueta escrita por el creador.Valores permitidos:apparel_accessoriesautomotivebeautyelectronicsfood_beveragehousehold_goodsmother_baby_pets ranking_typeObligatorio- Tablero de Xingtu:
all_top,head_tier,paid_ad_performers,rising_stars,sales_champions,top_creatorsoviral_drivers. El nombre del tablero no convierte la posición en una predicción o garantía.Valores permitidos:all_tophead_tierpaid_ad_performersrising_starssales_championstop_creatorsviral_drivers time_windowObligatorio- Instantánea del ranking de Xingtu:
latest_weekly,latest_monthly,all_history_weeklyoall_history_monthly. Delimita el tablero devuelto y no acepta un intervalo de fechas arbitrario.Valores permitidos:all_history_monthlyall_history_weeklylatest_monthlylatest_weekly
¿Qué significan los parámetros de Douyin product_search?
Busca productos mediante keyword y devuelve precio, ventas, tienda, comisión y creadores colaboradores.
keywordObligatorio- Término de búsqueda de productos de Douyin. El resultado es un conjunto independiente y no prueba que un creador concreto haya promocionado o vendido esos artículos.
¿Qué significan los parámetros de Douyin product_detail?
Consulta un producto mediante un product_id numérico, con galería, variantes, tienda y cifra pública de unidades vendidas.
product_idObligatorio- ID numérico de producto devuelto por
product_searcholive_product_search. No es un ID de SKU, de promoción, un título ni una URL.
¿Qué significan los parámetros de Douyin live_product_search?
Busca productos actualmente en directo mediante keyword y devuelve su live_room_id hasta el límite indicado.
keywordObligatorio- Término de búsqueda de productos de Douyin Mall. Solo devuelve los productos que, en el momento de la consulta, llevan la marca de directo y el ID de la sala; no es el historial de ventas en directo de un creador concreto.
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 cuando la acción se ejecute de forma 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>"}}'
Guías de Douyin
Ejemplos completos y métodos basados en estas acciones. Comprueba primero en esta página las acciones, parámetros y campos actuales; los ejemplos y límites de un artículo no sustituyen al catálogo en vivo.
Cómo obtener datos de comentarios de Douyin: de la URL del vídeo al JSON con relaciones de respuesta conservadas
Comienza con los parámetros en tiempo real de douyin.comments, lee los comentarios con solicitudes mínimas, conserva la fuente del vídeo, el ID del comentario y la relación de respuesta, y gestiona los límites de cantidad, los resultados vacíos, el análisis temporal y las observaciones repetidas.
Leer el artículo →Plan de seguimiento de reputación en múltiples plataformas: registra el alcance de la recolección antes de evaluar cambios negativos.
Diseña un proceso de seguimiento de reputación trazable a partir de listas de objetivos, identidades de comentarios y cursores incrementales; usa muestras locales para demostrar la deduplicación y las brechas de recolección, conserva la revisión manual y evita presentar casos de éxito de clientes.
Leer el artículo →Inicio con la API de datos unificada: del directorio de capacidades al primer resultado disponible
Integra datos multiplataforma usando platform, action y params: comprende el directorio de capacidades, completa una solicitud mínima, gestiona tareas asíncronas, resultados parciales y facturación, y establece registros de datos trazables.
Leer el artículo →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, video_url y like_count. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan 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.
¿Las acciones de Douyin responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.