API Douyin
Ищите видео и профили авторов Douyin или получайте расшифровки, списки трендов, аналитику и карточки товаров.
Для поиска аккаунтов используйте идентификатор автора из записей видео. Поиск товаров, данные о товаре и поиск текущих прямых эфиров работают отдельно от истории продаж автора. Расшифровки, рейтинги и коммерческие сигналы описывают разную информацию.
Доступность платформы
Сейчас не удаётся получить данные о доступности, поэтому недавнее состояние платформы неизвестно. Это не означает, что платформа недоступна.
Доступные возможности
Все действия Douyin: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Находите видео Douyin по поисковому запросу. | $8.33 за 1 000 запросов | — |
Профилиprofile | Найдите аккаунт Douyin по secUid. | $0.56 за 1 000 запросов | — |
Посты пользователяuser_posts | Отслеживайте видео, которые публикует аккаунт Douyin, начиная с новых. | $0.56 за 1 000 запросов | — |
Сведения о видеоvideo | Получите по ссылке на видео Douyin его подпись, хештеги, длительность, счётчики вовлечённости, профиль автора, фоновую музыку и время публикации. | $0.56 за 1 000 запросов | — |
Комментарииcomments | Получите комментарии зрителей к видео на Douyin с лайками, числом ответов, IP-регионом, флагами популярного комментария и лайка от автора, упоминаниями и изображениями, если они есть. | $0.56 за 1 000 запросовКаждые 20 записей считаются одним вызовом API | — |
Ответы на комментарииcomment_replies | Получите ответы на один комментарий верхнего уровня к видео на Douyin, до 100 за вызов, по 20 за раз. | $0.56 за 1 000 запросовКаждые 20 записей считаются одним вызовом API | — |
Трендыtrending | Получайте популярные ключевые слова из списков трендов Douyin. | $0.56 за 1 000 запросов | — |
Расшифровкаtranscript | Преобразуйте речь из видео Douyin в текст с таймкодами на уровне предложений. | $0.56 за 1 000 запросов | — |
Поиск авторовcreator_search | Ищите аккаунты авторов Douyin по никнейму, имени пользователя или фразе. | $0.56 за 1 000 запросов | — |
Аудитория автораcreator_audience | Получите распределение подписчиков автора Douyin по ценовой категории устройства, полу, возрасту или провинции, а также долю каждой группы и её индекс TGI. | $0.56 за 1 000 запросов | — |
Динамика роста автораcreator_trend | Отслеживайте число подписчиков автора Douyin во времени в виде ряда с датами и средним числом подписчиков за период. | $0.56 за 1 000 запросов | — |
Сравнение автора с аналогамиcreator_benchmark | Сравните автора Douyin с похожими аккаунтами по среднему числу постов, лайков, комментариев, репостов и приросту подписчиков, с процентильным рангом для каждого показателя. | $0.56 за 1 000 запросов | — |
Поиск авторов в Xingtuxingtu_creator_search | Ищите записи об авторах Xingtu в Douyin по ключевому слову. | $0.56 за 1 000 запросов | — |
Аналитика автора в Xingtuxingtu_creator_analytics | Получите коммерческий профиль автора Douyin в Xingtu. | $0.56 за 1 000 запросов | — |
Прайс автора в Xingtuxingtu_rate_card | Узнайте тарифные уровни, которые автор Douyin указывает в Xingtu. | $0.56 за 1 000 запросов | — |
Рейтинги авторов в Xingtuxingtu_creator_rankings | Получите до пяти авторов из рейтинга Douyin Xingtu. | $0.56 за 1 000 запросов | — |
Поиск товаровproduct_search | Находите до пяти товаров Douyin Mall по ключевому слову. | $13.33 за 1 000 запросов | — |
Сведения о товареproduct_detail | Получите данные одного товара Douyin Mall по числовому ID: отображаемую цену и цену со скидкой в CNY, показатель продаж, магазин, изображения, гарантии, сведения о доставке, варианты товара и наличие в продаже. | $13.33 за 1 000 запросов | — |
Поиск товаров в эфирахlive_product_search | Находите по ключевому слову до трёх товаров Douyin, которые продаются в прямых эфирах прямо сейчас. | $0.56 за 1 000 запросов | — |
Поиск по хештегамhashtag_search | Находите хештеги Douyin, в названии которых есть keyword, отсортированные по популярности. | $15.56 за 1 000 запросов | — |
Сведения о хештегеhashtag_detail | Получите один хештег Douyin по числовому hashtag_id из hashtag_search: название, общее число просмотров с момента создания, число присоединившихся пользователей, время создания и ссылку «Поделиться». | $15.56 за 1 000 запросов | — |
Рейтинг популярных видеоbillboard_video_hot | Получите данные из рейтингов видео Hot Spot Treasure, собственного инструмента трендов Douyin. | $0.81 за 1 000 запросов | — |
Рейтинг хитов авторов с небольшим числом подписчиковbillboard_low_fan_explosion | Находите ролики небольших аккаунтов Douyin, которые резко набрали популярность, по списку хитов аккаунтов с малым числом подписчиков в Hot Spot Treasure. | $0.81 за 1 000 запросов | — |
Рейтинг видео с высоким процентом досмотровbillboard_high_completion | Узнайте, какие ролики на Douyin зрители досматривают до конца, по списку с высоким процентом досмотров в Hot Spot Treasure. | $0.81 за 1 000 запросов | — |
Рейтинг популярных запросовbillboard_search_hot | Находите растущие поисковые запросы Douyin по поисковому списку в Hot Spot Treasure. | $0.81 за 1 000 запросов | — |
Поиск аккаунтов в Hot Spotbillboard_account_search | Ищите аккаунты Douyin, связанные с keyword, через Hot Spot Treasure, с числом подписчиков, лайков и видео у каждого. | $0.81 за 1 000 запросов | — |
Поиск музыкиmusic_search | Ищите в музыкальной библиотеке Douyin по названию песни, исполнителю или названию звука. | $8 за 1 000 запросов | — |
Поисковые подсказкиsearch_suggest | Получите подсказки автодополнения, которые Douyin показывает в поисковой строке для keyword, в порядке, заданном Douyin. | $8 за 1 000 запросов | — |
Рейтинг по росту популярностиbillboard_rise_list | Находите тренды, которые быстрее всего растут на Douyin, по списку растущих трендов в Hot Spot Treasure. | $0.81 за 1 000 запросов | — |
Рейтинг популярных челленджейbillboard_challenge_hot | Получите список челленджей в Hot Spot Treasure, собственном инструменте трендов Douyin: весь список из 50 трендов за один вызов. | $0.81 за 1 000 запросов | — |
Рейтинг популярных темbillboard_topic_hot | Узнайте, какие хештеги Douyin набирают популярность, по списку хештегов в Hot Spot Treasure за последний час, день, 3 дня или 7 дней. | $0.81 за 1 000 запросов | — |
Сведения о музыкеmusic_detail | Получите данные одного трека Douyin по числовому music_id из music_search или по ссылке douyin.com/music: название, исполнителя, длительность, число работ с этим треком, обложку, ссылку на воспроизведение и ссылку на текст песни, если он есть. | $0.81 за 1 000 запросов | — |
Конверсионный потенциал автора в Xingtuxingtu_conversion_ability | Получите показатели конверсии, которые Xingtu показывает для видео по заказам Xingtu одного автора Douyin за последние 7, 30 или 90 дней: число связанных видео, медиану воспроизведений, клики по компоненту и CTR, CPC, GPM, средние продажи, продвигаемые товары и их категории. | $1.6 за 1 000 запросов | — |
Структура охваченной аудитории в Xingtuxingtu_link_structure | Узнайте, сколько пользователей Xingtu считает связанными с одним автором Douyin, с разбивкой по четырём уровням Xingtu: для каждого указаны число, доля от общего числа и медиана по авторам той же отрасли. | $16 за 1 000 запросов | — |
Рекомендованные видео в Xingtuxingtu_recommended_videos | Получите четыре группы видео со страницы автора Douyin в Xingtu: знаковые видео, последние видео, лучшие видео по заказам Xingtu и лучшие личные видео. | $1.6 за 1 000 запросов | — |
Источники охвата пользователей в Xingtuxingtu_touch_distribution | Узнайте, из каких категорий контента пришли связанные пользователи автора Douyin по данным Xingtu: дерево до трёх уровней, обычно сначала личный контент или контент Xingtu, затем категория и подкатегория, и у каждого узла указано число. | $16 за 1 000 запросов | — |
Эффективность видео в Xingtuxingtu_video_performance | Сравните личные видео автора Douyin и его видео по заказам Xingtu по уровню вовлечённости, медиане воспроизведений и проценту досмотров. | $16 за 1 000 запросов | — |
Данные о состоянии этого API временно недоступны, поэтому неизвестно, как он работал в последнее время. Это не значит, что API не работает.
Какие параметры принимает каждое действие API Douyin?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Находите видео Douyin по поисковому запросу. Получите подпись, хештеги, лайки, комментарии, репосты, сохранения, данные автора и подписанную ссылку на воспроизведение. Douyin не публикует число воспроизведений. Поэтому | keyword | page_token, publish_time, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Чтобы получить следующую страницу, передайте next_page_token как page_token, не меняя остальные параметры; каждая страница — отдельный вызов. | $8.33 за 1 000 запросов | next_page_token · id · url · text · media_type · video_url · like_count · comment_count · share_count · collect_count · view_count · author_name · author_id · author_douyin_id · author_uid · author_bio · author_avatar_url · author_follower_count · cover_image_url · video_width · video_height · duration_seconds · region · hashtags · posted_at · platform · image_urls · duration_sec · hashtag_ids · search_rank · author_is_verified · 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_resolution · animated_cover_url · city · city_code · location · text_language · video_bitrates · download_url · has_watermark · video_url_expires_at · permissions · author_gender · author_age |
profileПрофили Найдите аккаунт Douyin по secUid. Получите никнейм, имя пользователя, описание, число подписчиков, лайков и видео, IP-местоположение, данные о верификации и наличие магазина. Передайте в | user_id | — | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | 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 · age · has_series · platform · verify_reason |
user_postsПосты пользователя Отслеживайте видео, которые публикует аккаунт Douyin, начиная с новых. У каждого видео есть подпись, хештеги, длительность, счётчики вовлечённости и время публикации. Начинайте пагинацию с пустым | user_id | page_token, since | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Чтобы получить следующую страницу, передайте next_page_token как page_token, не меняя остальные параметры; каждая страница — отдельный вызов. | $0.56 за 1 000 запросов | next_page_token · id · url · text · media_type · video_url · like_count · comment_count · share_count · collect_count · view_count · author_name · author_id · author_douyin_id · author_uid · author_bio · author_avatar_url · author_follower_count · cover_image_url · video_width · video_height · duration_seconds · region · hashtags · posted_at · platform · image_urls · duration_sec · hashtag_ids · search_rank · author_is_verified · 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_resolution · animated_cover_url · city · city_code · location · text_language · video_bitrates · download_url · has_watermark · video_url_expires_at · permissions · author_gender · author_age |
videoСведения о видео Получите по ссылке на видео Douyin его подпись, хештеги, длительность, счётчики вовлечённости, профиль автора, фоновую музыку и время публикации. Ссылка на воспроизведение в | url | — | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | id · url · text · media_type · video_url · like_count · comment_count · share_count · collect_count · view_count · author_name · author_id · author_douyin_id · author_uid · author_bio · author_avatar_url · author_follower_count · cover_image_url · video_width · video_height · duration_seconds · region · hashtags · posted_at · platform · image_urls · duration_sec · hashtag_ids · search_rank · author_is_verified · 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_resolution · animated_cover_url · city · city_code · location · text_language · video_bitrates · download_url · has_watermark · video_url_expires_at · permissions · author_gender · author_age |
commentsКомментарии Получите комментарии зрителей к видео на Douyin с лайками, числом ответов, IP-регионом, флагами популярного комментария и лайка от автора, упоминаниями и изображениями, если они есть. Чтобы листать комментарии верхнего уровня, передавайте | url | page_token | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=150. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Чтобы получить следующую страницу, передайте next_page_token как page_token, не меняя остальные параметры; каждая страница — отдельный вызов. | $0.56 за 1 000 запросовКаждые 20 записей считаются одним вызовом API | 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 |
comment_repliesОтветы на комментарии Получите ответы на один комментарий верхнего уровня к видео на Douyin, до 100 за вызов, по 20 за раз. У каждого ответа есть текст, лайки, автор ответа, IP-регион и флаг лайка от автора, а если это ответ на другой ответ, ещё и | url, comment_id | page_token | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Чтобы получить следующую страницу, передайте next_page_token как page_token, не меняя остальные параметры; каждая страница — отдельный вызов. | $0.56 за 1 000 запросовКаждые 20 записей считаются одним вызовом API | next_page_token · id · text · like_count · author_name · author_id · author_uid · author_avatar_url · ip_location · liked_by_author · is_reply · reply_to_id · reply_to_reply_id · reply_to_author_name · posted_at · video_id · images · mentioned_users · platform |
trendingТренды Получайте популярные ключевые слова из списков трендов Douyin. У каждого ключевого слова есть позиция, показатель популярности, число связанных видео, статей и прямых эфиров, метка и лучшая позиция. Выберите списки через | boards | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=60. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | 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 · topic_view_count · sentence_tag · label_icon_url · related_music_id · platform | |
transcriptРасшифровка Преобразуйте речь из видео Douyin в текст с таймкодами на уровне предложений. Также возвращаются название, время публикации, счётчики вовлечённости, автор и ссылка на аудиодорожку. Не в каждом видео есть распознаваемая речь, и текст не переводится. | url | — | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | 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_searchПоиск авторов Ищите аккаунты авторов Douyin по никнейму, имени пользователя или фразе. Получите число подписчиков, пол, данные о верификации и информацию о том, идёт ли у автора прямой эфир, а также secUid для последующих вызовов. Сужайте результаты с помощью | keyword | follower_range, user_type | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=20. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | user_id · douyin_id · nickname · url · avatar_url · follower_count · gender · is_verified · verify_reason · is_live · uid · source_keyword · platform |
creator_audienceАудитория автора Получите распределение подписчиков автора Douyin по ценовой категории устройства, полу, возрасту или провинции, а также долю каждой группы и её индекс TGI. Доли представлены десятичными дробями от 0 до 1, а не процентами. Это агрегированные группы, а не записи о покупателях или отдельных людях. | user_id | dimension | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | user_id · audience_distribution · audience_tgi · dimension_code · platform |
creator_trendДинамика роста автора Отслеживайте число подписчиков автора Douyin во времени в виде ряда с датами и средним числом подписчиков за период. Передайте secUid автора в | user_id | — | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | user_id · follower_trend · average_follower_count · dimension_code · platform |
creator_benchmarkСравнение автора с аналогами Сравните автора Douyin с похожими аккаунтами по среднему числу постов, лайков, комментариев, репостов и приросту подписчиков, с процентильным рангом для каждого показателя. Это относительные показатели аккаунта, а не продажи, конверсии или доказательство причинно-следственной связи. | user_id | — | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | 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_searchПоиск авторов в Xingtu Ищите записи об авторах Xingtu в Douyin по ключевому слову. Получайте коэффициент вовлечённости, ожидаемое число воспроизведений, прирост подписчиков, коммерческий рейтинг, диапазоны GMV (не точный GMV), индексы ценности и расценки в CNY в зависимости от длины видео. | keyword | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=20. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | 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_analyticsАналитика автора в Xingtu Получите коммерческий профиль автора Douyin в Xingtu. Он включает тип и уровень автора, число подписчиков, среднее число воспроизведений, тематики контента, признак коммерческой деятельности и минимальную расценку в CNY. Передайте видимый | douyin_id | — | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | 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_cardПрайс автора в Xingtu Узнайте тарифные уровни, которые автор Douyin указывает в Xingtu. Для каждого уровня есть формат, текущая и исходная цена, примечание о расчётах, тип видео и статус доступности. Используйте | douyin_id | — | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | creator_id · rate_tiers · platform |
xingtu_creator_rankingsРейтинги авторов в Xingtu Получите до пяти авторов из рейтинга Douyin Xingtu. Рейтинг выбирается по отрасли, типу рейтинга и периоду. Получите позицию, предыдущую позицию, балл, CPM и диапазоны заказов. Позиции и баллы сопоставимы только в пределах возвращённого рейтинга и периода. Диапазоны заказов и повторных заказов не являются точными итогами. | industry, ranking_type, time_window | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=5, maxLimit=5. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | 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 · industry_tags · primary_tag · industry_id · top_videos · source_kind · platform |
product_searchПоиск товаров Находите до пяти товаров Douyin Mall по ключевому слову. Получите цену в CNY, продажи за 30 дней, долю положительных отзывов, магазин, ставку партнёрского вознаграждения и число авторов-партнёров. Число авторов-партнёров не означает, что товар продал конкретный автор. Если основной источник недоступен, резервный возвращает только ID товара, название, ссылку, изображение, цену в CNY и ID магазина. Поля с данными о продажах, доле положительных отзывов, названии магазина, категории, партнёрском вознаграждении и авторах в этом случае отсутствуют. Цены «от» в размере 0,1 юаня или меньше не учитываются. | keyword | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=5, maxLimit=5. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $13.33 за 1 000 запросов | 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_detailСведения о товаре Получите данные одного товара Douyin Mall по числовому ID: отображаемую цену и цену со скидкой в CNY, показатель продаж, магазин, изображения, гарантии, сведения о доставке, варианты товара и наличие в продаже. Используйте | product_id | — | Режим выдачи: Sync | — | $13.33 за 1 000 запросов | 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_searchПоиск товаров в эфирах Находите по ключевому слову до трёх товаров Douyin, которые продаются в прямых эфирах прямо сейчас. Получите SKU, название, цену в CNY, магазин и ID комнаты эфира. ID комнаты относится только к этому поиску. Прошлые продажи в эфирах по нему не определить. | keyword | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=3, maxLimit=3. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | product_id · sku_id · title · image_url · price_cny · shop_id · live_room_id · is_live_product · source_keyword · platform |
hashtag_searchПоиск по хештегам Находите хештеги Douyin, в названии которых есть | keyword | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $15.56 за 1 000 запросов | hashtag_id · hashtag_name · search_rank · heat_index · period_video_count · period_like_count · period_view_count · period_start · period_end · platform |
hashtag_detailСведения о хештеге Получите один хештег Douyin по числовому | hashtag_id | — | Режим выдачи: Sync | — | $15.56 за 1 000 запросов | hashtag_id · hashtag_name · total_view_count · participant_count · created_at · url · platform |
billboard_video_hotРейтинг популярных видео Получите данные из рейтингов видео Hot Spot Treasure, собственного инструмента трендов Douyin. Доступны общий рейтинг, рейтинг по приросту подписчиков и рейтинг по доле лайков за последний час, день, 3 дня или 7 дней. Для каждого видео указаны число воспроизведений и лайков, доля лайков, прирост подписчиков, темп прироста подписчиков, показатель популярности и число подписчиков автора. Видео идут по убыванию показателя популярности. На странице может быть до 50 записей. Douyin отфильтровывает часть видео, поэтому страницы часто содержат меньше записей, и неполная страница не означает конец списка. В записях нет позиции в рейтинге. | board, keyword, page_token, time_window | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 50. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет. | $0.81 за 1 000 запросов | id · url · text · media_type · image_count · cover_image_url · video_url · duration_seconds · duration_sec · author_name · author_avatar_url · author_follower_count · play_count · like_count · like_rate · new_follower_count · follower_growth_rate · hot_value · posted_at · next_page_token · platform | |
billboard_low_fan_explosionРейтинг хитов авторов с небольшим числом подписчиков Находите ролики небольших аккаунтов Douyin, которые резко набрали популярность, по списку хитов аккаунтов с малым числом подписчиков в Hot Spot Treasure. В каждой записи число подписчиков автора сопоставляется с числом воспроизведений, лайков и новых подписчиков, привлечённых роликом, а также с долей лайков. Так можно оценить, насколько широко распространился ролик небольшого аккаунта. Сузьте выборку с помощью необязательного | keyword, page_token, time_window | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 50. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет. | $0.81 за 1 000 запросов | id · url · text · media_type · image_count · cover_image_url · video_url · duration_seconds · duration_sec · author_name · author_avatar_url · author_follower_count · play_count · like_count · like_rate · new_follower_count · follower_growth_rate · hot_value · posted_at · next_page_token · platform | |
billboard_high_completionРейтинг видео с высоким процентом досмотров Узнайте, какие ролики на Douyin зрители досматривают до конца, по списку с высоким процентом досмотров в Hot Spot Treasure. Для каждого ролика возвращаются длительность, число воспроизведений и лайков, доля лайков, показатель популярности, обложка и подписанная ссылка для воспроизведения; сам процент досмотров не возвращается. Выберите период от одного часа до семи дней и при необходимости укажите | keyword, page_token, time_window | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 50. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет. | $0.81 за 1 000 запросов | id · url · text · media_type · image_count · cover_image_url · video_url · duration_seconds · duration_sec · author_name · author_avatar_url · author_follower_count · play_count · like_count · like_rate · new_follower_count · follower_growth_rate · hot_value · posted_at · next_page_token · platform | |
billboard_search_hotРейтинг популярных запросов Находите растущие поисковые запросы Douyin по поисковому списку в Hot Spot Treasure. У каждого запроса указаны позиция, поисковая популярность за выбранный период и динамика популярности по дням максимум за 14 дней. При желании оставьте только запросы, содержащие | keyword, page_token, time_window | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 50. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token. Параметр limit принимается, но ни на что не влияет. | $0.81 за 1 000 запросов | rank · keyword · hot_value · search_trend · platform | |
billboard_account_searchПоиск аккаунтов в Hot Spot Ищите аккаунты Douyin, связанные с | keyword | page_token | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 30. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет. | $0.81 за 1 000 запросов | user_id · nickname · url · avatar_url · follower_count · like_count · video_count · next_page_token · platform |
music_searchПоиск музыки Ищите в музыкальной библиотеке Douyin по названию песни, исполнителю или названию звука. У каждого трека есть название, исполнитель, длительность, число работ с ним, обложка, ссылка на воспроизведение, ссылка на текст, если он есть, и теги. 10 треков на странице; следующие страницы получайте через | keyword | page_token | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 10. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token. Параметр limit принимается, но ни на что не влияет. | $8 за 1 000 запросов | id · url · title · author_name · duration_seconds · duration_sec · use_count · cover_image_url · audio_url · lyric_url · tags · next_page_token · platform |
search_suggestПоисковые подсказки Получите подсказки автодополнения, которые Douyin показывает в поисковой строке для | keyword | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=10. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $8 за 1 000 запросов | rank · keyword · platform |
billboard_rise_listРейтинг по росту популярности Находите тренды, которые быстрее всего растут на Douyin, по списку растущих трендов в Hot Spot Treasure. У каждого тренда указаны позиция, число позиций, на которые он поднялся, название, ID, показатель популярности, число связанных видео, категория, время создания и почасовая кривая популярности. При желании оставьте только тренды, названия которых содержат | keyword, page_token | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 50. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token. Параметр limit принимается, но ни на что не влияет. | $0.81 за 1 000 запросов | rank · rank_change · title · topic_id · hot_value · video_count · category · created_at · hot_trend · next_page_token · platform | |
billboard_challenge_hotРейтинг популярных челленджей Получите список челленджей в Hot Spot Treasure, собственном инструменте трендов Douyin: весь список из 50 трендов за один вызов. У каждого тренда есть позиция, название, ID, популярность, число связанных видео, время создания и кривая популярности с шагом около десяти минут. | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=50, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Можно передать большее значение limit, но оно будет ограничено значением 50. | $0.81 за 1 000 запросов | rank · title · topic_id · hot_value · video_count · created_at · hot_trend · platform | |
billboard_topic_hotРейтинг популярных тем Узнайте, какие хештеги Douyin набирают популярность, по списку хештегов в Hot Spot Treasure за последний час, день, 3 дня или 7 дней. У каждого хештега указаны позиция, числовой ID для | keyword, page_token, time_window | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 50. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token. Параметр limit принимается, но ни на что не влияет. | $0.81 за 1 000 запросов | rank · hashtag_id · hashtag_name · hot_value · total_view_count · total_video_count · average_view_count · cover_image_url · created_at · daily_trend · next_page_token · platform | |
music_detailСведения о музыке Получите данные одного трека Douyin по числовому | music_id | — | Режим выдачи: Sync | — | $0.81 за 1 000 запросов | id · url · title · author_name · duration_seconds · duration_sec · use_count · cover_image_url · audio_url · lyric_url · platform |
xingtu_conversion_abilityКонверсионный потенциал автора в Xingtu Получите показатели конверсии, которые Xingtu показывает для видео по заказам Xingtu одного автора Douyin за последние 7, 30 или 90 дней: число связанных видео, медиану воспроизведений, клики по компоненту и CTR, CPC, GPM, средние продажи, продвигаемые товары и их категории. Большинство значений указаны диапазонами в формулировках Xingtu, например | douyin_id | time_window | Режим выдачи: Sync | — | $1.6 за 1 000 запросов | creator_id · time_window · related_video_count · video_play_median · component_click_count_range · component_click_rate_range · cpc_range_cny · gpm_range_cny · average_sales_range_cny · product_count · product_price_range_cny · categories · platform |
xingtu_link_structureСтруктура охваченной аудитории в Xingtu Узнайте, сколько пользователей Xingtu считает связанными с одним автором Douyin, с разбивкой по четырём уровням Xingtu: для каждого указаны число, доля от общего числа и медиана по авторам той же отрасли. Также возвращаются общее число, его место среди авторов Xingtu ( | douyin_id | — | Режим выдачи: Sync | — | $16 за 1 000 запросов | creator_id · link_type · total_user_count · total_rank_top_percent · levels · platform |
xingtu_recommended_videosРекомендованные видео в Xingtu Получите четыре группы видео со страницы автора Douyin в Xingtu: знаковые видео, последние видео, лучшие видео по заказам Xingtu и лучшие личные видео. Для каждого видео указаны только ID, ссылка, число воспроизведений и время публикации. Группы без видео не возвращаются. | douyin_id | — | Режим выдачи: Sync | — | $1.6 за 1 000 запросов | creator_id · signature_videos · latest_videos · top_xingtu_order_videos · top_personal_videos · platform |
xingtu_touch_distributionИсточники охвата пользователей в Xingtu Узнайте, из каких категорий контента пришли связанные пользователи автора Douyin по данным Xingtu: дерево до трёх уровней, обычно сначала личный контент или контент Xingtu, затем категория и подкатегория, и у каждого узла указано число. | douyin_id | — | Режим выдачи: Sync | — | $16 за 1 000 запросов | creator_id · categories · platform |
xingtu_video_performanceЭффективность видео в Xingtu Сравните личные видео автора Douyin и его видео по заказам Xingtu по уровню вовлечённости, медиане воспроизведений и проценту досмотров. Для каждого показателя указаны значение автора, среднее по платформе и процентиль (доля авторов, которых он опережает, от 0 до 1). Также возвращаются последние личные видео и видео по заказам Xingtu, примерно до 15 каждого вида, с названием, воспроизведениями, лайками, комментариями, репостами и длительностью. | douyin_id | — | Режим выдачи: Sync | — | $16 за 1 000 запросов | creator_id · personal_videos · xingtu_videos · latest_videos · latest_xingtu_videos · platform |
Что означают параметры действия search в API Douyin?
Находите видео Douyin по поисковому запросу. Получите подпись, хештеги, лайки, комментарии, репосты, сохранения, данные автора и подписанную ссылку на воспроизведение. Douyin не публикует число воспроизведений. Поэтому view_count обычно отсутствует или равен 0 и никогда не показывает реальные воспроизведения. Охват оценивайте по лайкам, комментариям и репостам.
keywordОбязательный- Поисковый запрос для действия поиска видео, передаётся строкой, например
latte art. Ищет видео; это не никнейм аккаунта и не ID видео. page_tokenНеобязательный- Токен страницы. Чтобы начать пагинацию, отправьте пустую строку
page_token="". Для следующей страницы передавайтеnext_page_tokenиз предыдущего ответа без изменений, не меняяkeyword,sortиpublish_time. Каждая страница соответствует одному вызову и содержит целые страницы выдачи Douyin без обрезки: не меньшеlimitвидео (по умолчанию 10, до 50; на последней странице может быть меньше), часто чуть больше. Видео, которые Douyin повторяет с предыдущей страницы, исключаются. Токены действуют 24 часа и работают только для того же аккаунта и тех же параметров. Просроченный или неподходящий токен возвращает 422; в этом случае начните заново с первой страницы. На последней странице в ответе нетnext_page_token. Безpage_tokenвызов выполняет одну выборку доlimitвидео безnext_page_token. publish_timeНеобязательный- Фильтрует результаты поиска видео по периоду публикации. Допустимые значения:
unlimited(по умолчанию),one_day(последние 24 часа),one_week(последние 7 дней) иhalf_year(последние 6 месяцев).Допустимые значения:half_yearone_dayone_weekunlimited sortНеобязательный- Сортирует результаты поиска видео. Допустимые значения:
relevance(по умолчанию),newest(по дате публикации, сначала новые) иmost_liked(по числу лайков). Для обратной совместимости поддерживаются псевдонимыgeneral(соответствуетrelevance) иlatest(соответствуетnewest).Допустимые значения:most_likednewestrelevance
Что означают параметры действия profile в API Douyin?
Найдите аккаунт Douyin по secUid. Получите никнейм, имя пользователя, описание, число подписчиков, лайков и видео, IP-местоположение, данные о верификации и наличие магазина. Передайте в user_id secUid (часто начинается с MS4w), а не никнейм или короткий ID. Видео этого аккаунта можно получить через user_posts.
user_idОбязательный- Строка
secUidпользователя Douyin (обычно начинается сMS4w), а не никнейм и не короткий числовой Douyin ID. Используется для указания аккаунта в действияхprofileиuser_posts; её можно взять из поляauthor_idв результатах поиска или из URL профиля пользователя.Открытая платформа Douyin: Open ID и Union ID — На открытой платформе Douyin Open ID — это идентификатор пользователя в рамках одного приложения, а Union ID действует в пределах аккаунта разработчика. На этой странице user_id ожидает secUid, как описано выше; не передавайте идентификаторы открытой платформы напрямую как равнозначные входные данные. · Проверено
Что означают параметры действия user_posts в API Douyin?
Отслеживайте видео, которые публикует аккаунт Douyin, начиная с новых. У каждого видео есть подпись, хештеги, длительность, счётчики вовлечённости и время публикации. Начинайте пагинацию с пустым page_token. Передавайте каждый next_page_token обратно в течение 24 часов. since задаёт самую раннюю дату публикации.
user_idОбязательный- Строка
secUidпользователя Douyin (обычно начинается сMS4w), а не никнейм и не короткий числовой Douyin ID. Используется для указания аккаунта в действияхprofileиuser_posts; её можно взять из поляauthor_idв результатах поиска или из URL профиля пользователя.Открытая платформа Douyin: Open ID и Union ID — На открытой платформе Douyin Open ID — это идентификатор пользователя в рамках одного приложения, а Union ID действует в пределах аккаунта разработчика. На этой странице user_id ожидает secUid, как описано выше; не передавайте идентификаторы открытой платформы напрямую как равнозначные входные данные. · Проверено page_tokenНеобязательный- Токен страницы для
user_posts. Чтобы начать с самой новой страницы, отправьте пустую строкуpage_token="", затем передавайтеnext_page_tokenиз каждого ответа без изменений, не меняя остальные параметры. Токены действуют 24 часа и работают только для того же аккаунта и тех же параметров; на последней странице нетnext_page_token. Страницы содержат до 100 записей, сначала новые, и не учитывают нижнюю границуsince. Если нужен диапазон дат, фильтруйте поposted_atна своей стороне. Каждая страница соответствует одному вызову. sinceНеобязательный- Задаёт нижнюю границу диапазона дат публикации видео в действиях
profileиuser_postsв форматеYYYY-MM-DD. Фильтрует видео, полученные по запросу, а не дату создания аккаунта. Если параметр не передан, фильтр по дате не применяется.
Что означают параметры действия video в API Douyin?
Получите по ссылке на видео Douyin его подпись, хештеги, длительность, счётчики вовлечённости, профиль автора, фоновую музыку и время публикации. Ссылка на воспроизведение в video_url подписана и истекает, поэтому, если видео нужно сохранить, скачайте его сразу.
urlОбязательный- Полный URL целевого видео Douyin в формате
https://www.douyin.com/video/<video_id>. Возвращает данные видео вvideo, комментарии вcomments, ответы на один комментарий вcomment_replies(указывается видео, к которому относится комментарий) или расшифровку аудио вtranscript. Не передавайте URL профилей пользователей или страниц поиска.
Что означают параметры действия comments в API Douyin?
Получите комментарии зрителей к видео на Douyin с лайками, числом ответов, IP-регионом, флагами популярного комментария и лайка от автора, упоминаниями и изображениями, если они есть. Чтобы листать комментарии верхнего уровня, передавайте next_page_token обратно как page_token.
urlОбязательный- Полный URL целевого видео Douyin в формате
https://www.douyin.com/video/<video_id>. Возвращает данные видео вvideo, комментарии вcomments, ответы на один комментарий вcomment_replies(указывается видео, к которому относится комментарий) или расшифровку аудио вtranscript. Не передавайте URL профилей пользователей или страниц поиска. page_tokenНеобязательный- Токен страницы для
user_postsиcomments. Чтобы начать пагинацию, передайте пустую строкуpage_token=""; затем для получения следующей страницы передавайтеnext_page_tokenиз предыдущего ответа в точности как получили, не меняя остальные параметры. Токены действуют 24 часа и работают только для того же аккаунта и тех же параметров; истёкший или несовпадающий токен возвращает 422, и тогда нужно начать заново с первой страницы. На последней странице в ответе нетnext_page_token(pagination.has_moreравен false). Каждая страницаuser_postsсчитается одним вызовом и содержит до 100 записей, от новых к старым;sinceк ней не применяется (если нужен диапазон дат, фильтруйте поposted_atна своей стороне). Страницыcommentsсодержат до 50 комментариев верхнего уровня и тарифицируются блоками записей: каждые 20 записей считаются одним вызовом, поэтому страница с 50 записями считается как 3 вызова (при меньшемlimitучитывается соответствующее число записей), а блоки, вернувшиеся без записей, не оплачиваются. Безpage_tokenвыполняется однократный запрос:user_postsвозвращает самую свежую порцию (sinceприменяется), аcommentsвозвращает только начало списка вместе с ответами, также по одному вызову за каждые 20 записей: по умолчанию 20 записей и не более примерно 50–60 при любом значенииlimit, обычно безnext_page_token.
Что означают параметры действия comment_replies в API Douyin?
Получите ответы на один комментарий верхнего уровня к видео на Douyin, до 100 за вызов, по 20 за раз. У каждого ответа есть текст, лайки, автор ответа, IP-регион и флаг лайка от автора, а если это ответ на другой ответ, ещё и reply_to_reply_id и reply_to_author_name. Передайте ссылку на видео и comment_id из comments, а следующие страницы получайте через next_page_token.
urlОбязательный- Полный URL целевого видео Douyin в формате
https://www.douyin.com/video/<video_id>. Возвращает данные видео вvideo, комментарии вcomments, ответы на один комментарий вcomment_replies(указывается видео, к которому относится комментарий) или расшифровку аудио вtranscript. Не передавайте URL профилей пользователей или страниц поиска. comment_idОбязательный- ID комментария верхнего уровня, ответы на который нужно получить: только цифры, из поля
idзаписиcomments; ответы есть только у комментариев сreply_countбольше нуля. Используется вcomment_repliesвместе сurlтого же видео; это не ID видео и не ID ответа. page_tokenНеобязательный- Токен страницы для
comment_replies. Чтобы начать с первого ответа, отправьте пустую строкуpage_token="", затем передавайтеnext_page_tokenиз каждого ответа без изменений, не меняя остальные параметры. Токены действуют 24 часа и работают только для того же аккаунта и тех же параметров; на последней странице в ответе нетnext_page_token. Страницы содержат до 20 ответов, а оплата рассчитывается по блокам записей: каждый непустой блок размером до 20 записей считается одним вызовом; блок без записей не оплачивается.
Что означают параметры действия trending в API Douyin?
Получайте популярные ключевые слова из списков трендов Douyin. У каждого ключевого слова есть позиция, показатель популярности, число связанных видео, статей и прямых эфиров, метка и лучшая позиция. Выберите списки через boards (по умолчанию hotspot). hot_value является собственным показателем Douyin, и сравнивать его можно только в пределах одного списка.
boardsНеобязательный- Типы списков трендов для действия
trending; передаются одной строкой или массивом строк:hotspot,seeding,entertainment,socialиchallenge. Если параметр не передан или передан пустой массив, используетсяhotspot.Допустимые значения:challengeentertainmenthotspotseedingsocial
Что означают параметры действия transcript в API Douyin?
Преобразуйте речь из видео Douyin в текст с таймкодами на уровне предложений. Также возвращаются название, время публикации, счётчики вовлечённости, автор и ссылка на аудиодорожку. Не в каждом видео есть распознаваемая речь, и текст не переводится.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Полный URL целевого видео Douyin в формате
https://www.douyin.com/video/<video_id>. Возвращает данные видео вvideo, комментарии вcomments, ответы на один комментарий вcomment_replies(указывается видео, к которому относится комментарий) или расшифровку аудио вtranscript. Не передавайте URL профилей пользователей или страниц поиска.
Что означают параметры действия creator_search в API Douyin?
Ищите аккаунты авторов Douyin по никнейму, имени пользователя или фразе. Получите число подписчиков, пол, данные о верификации и информацию о том, идёт ли у автора прямой эфир, а также secUid для последующих вызовов. Сужайте результаты с помощью follower_range и user_type. Результаты поиска — возможные совпадения, а не подтверждение личности.
keywordОбязательный- Никнейм автора, Douyin ID или связанная поисковая фраза для поиска аккаунтов. Параметр не запускает действие поиска видео
searchи не гарантирует точного совпадения с нужным аккаунтом. follower_rangeНеобязательный- Фильтрует
creator_searchпо диапазону числа подписчиков аккаунта. Используйтеunder_1k,1k_to_10k,10k_to_100k,100k_to_1mилиover_1m; если параметр не передан, диапазон не ограничивается.Допустимые значения:100k_to_1m10k_to_100k1k_to_10kover_1munder_1k user_typeНеобязательный- Фильтрует
creator_searchпо категории аккаунта:general,businessилиverified_individual. Это не категория покупателя и не подтверждение личности.Допустимые значения:businessgeneralverified_individual
Что означают параметры действия creator_audience в API Douyin?
Получите распределение подписчиков автора Douyin по ценовой категории устройства, полу, возрасту или провинции, а также долю каждой группы и её индекс TGI. Доли представлены десятичными дробями от 0 до 1, а не процентами. Это агрегированные группы, а не записи о покупателях или отдельных людях.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеuser_idОбязательныйsecUidавтора Douyin, обычно начинается сMS4w. По нему читаются доступные данные о распределении аудитории и показатели TGI. Используйтеuser_idиз поиска авторов, а не никнейм, короткий Douyin ID или идентификатор покупателя.dimensionНеобязательный- Выбирает срез подписчиков в
creator_audience:device_price_band(по умолчанию),gender,ageилиprovince. Значения распределения представлены десятичными долями от 0 до 1, а не процентами; TGI остаётся отдельным индексом. Параметр не запрашивает записи об отдельных подписчиках или данные о покупателях.Допустимые значения:agedevice_price_bandgenderprovince
Что означают параметры действия creator_trend в API Douyin?
Отслеживайте число подписчиков автора Douyin во времени в виде ряда с датами и средним числом подписчиков за период. Передайте secUid автора в user_id. Сам по себе ряд не показывает, чем вызван рост.
user_idОбязательныйsecUidавтора Douyin, обычно начинается сMS4w. По нему читается доступный временной ряд динамики подписчиков. Это не никнейм и не короткий числовой Douyin ID.
Что означают параметры действия creator_benchmark в API Douyin?
Сравните автора Douyin с похожими аккаунтами по среднему числу постов, лайков, комментариев, репостов и приросту подписчиков, с процентильным рангом для каждого показателя. Это относительные показатели аккаунта, а не продажи, конверсии или доказательство причинно-следственной связи.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеuser_idОбязательныйsecUidавтора Douyin, обычно начинается сMS4w. По нему читаются доступные средние показатели и перцентили аккаунта. Это не никнейм и не короткий числовой Douyin ID.
Что означают параметры действия xingtu_creator_search в API Douyin?
Ищите записи об авторах Xingtu в Douyin по ключевому слову. Получайте коэффициент вовлечённости, ожидаемое число воспроизведений, прирост подписчиков, коммерческий рейтинг, диапазоны GMV (не точный GMV), индексы ценности и расценки в CNY в зависимости от длины видео. creator_id служит только для сравнения этих записей. Для аналитики и прайс-листов нужен douyin_id из creator_search.
keywordОбязательный- Поисковая фраза для поиска авторов через
xingtu_creator_search. Возвращаемыйcreator_idпозволяет идентифицировать и сравнивать записи внутри этой выдачи Xingtu. Его не принимаютxingtu_creator_analyticsиxingtu_rate_card: им нуженdouyin_idиз обычногоcreator_search. Это не ключевое слово для товаров и не поиск видео.
Что означают параметры действия xingtu_creator_analytics в API Douyin?
Получите коммерческий профиль автора Douyin в Xingtu. Он включает тип и уровень автора, число подписчиков, среднее число воспроизведений, тематики контента, признак коммерческой деятельности и минимальную расценку в CNY. Передайте видимый douyin_id из creator_search, а не secUid или ID Xingtu. Минимальная расценка — это запрашиваемая цена, а не цена заключённой сделки.
douyin_idОбязательный- Видимый ID аккаунта Douyin (
unique_id), который возвращает обычное действиеcreator_searchи который обязателен дляxingtu_creator_analyticsиxingtu_rate_card;xingtu_creator_searchего не возвращает. Отличается отuser_id(secUid),creator_idв Xingtu и никнейма.
Что означают параметры действия xingtu_rate_card в API Douyin?
Узнайте тарифные уровни, которые автор Douyin указывает в Xingtu. Для каждого уровня есть формат, текущая и исходная цена, примечание о расчётах, тип видео и статус доступности. Используйте douyin_id из creator_search. Это опубликованные расценки, а не согласованная сделка или итоговый расчёт.
douyin_idОбязательный- Видимый ID аккаунта Douyin (
unique_id), который возвращает обычное действиеcreator_searchи который обязателен дляxingtu_creator_analyticsиxingtu_rate_card;xingtu_creator_searchего не возвращает. Отличается отuser_id(secUid),creator_idв Xingtu и никнейма.
Что означают параметры действия xingtu_creator_rankings в API Douyin?
Получите до пяти авторов из рейтинга Douyin Xingtu. Рейтинг выбирается по отрасли, типу рейтинга и периоду. Получите позицию, предыдущую позицию, балл, CPM и диапазоны заказов. Позиции и баллы сопоставимы только в пределах возвращённого рейтинга и периода. Диапазоны заказов и повторных заказов не являются точными итогами.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеindustryОбязательный- Выбирает отрасль рейтинга авторов Xingtu:
apparel_accessories,automotive,beauty,electronics,food_beverage,household_goodsилиmother_baby_pets. Это фильтр рейтинга, а не тег, заданный автором.Допустимые значения:apparel_accessoriesautomotivebeautyelectronicsfood_beveragehousehold_goodsmother_baby_pets ranking_typeОбязательный- Выбирает рейтинг Xingtu:
all_top,head_tier,paid_ad_performers,rising_stars,sales_champions,top_creatorsилиviral_drivers. Названия рейтингов не превращают позицию в прогноз или гарантированный результат.Допустимые значения:all_tophead_tierpaid_ad_performersrising_starssales_championstop_creatorsviral_drivers time_windowОбязательный- Выбирает срез рейтинга Xingtu:
latest_weekly,latest_monthly,all_history_weeklyилиall_history_monthly. Определяет, какой рейтинг возвращается, и не принимает произвольный диапазон дат.Допустимые значения:all_history_monthlyall_history_weeklylatest_monthlylatest_weekly
Что означают параметры действия product_search в API Douyin?
Находите до пяти товаров Douyin Mall по ключевому слову. Получите цену в CNY, продажи за 30 дней, долю положительных отзывов, магазин, ставку партнёрского вознаграждения и число авторов-партнёров. Число авторов-партнёров не означает, что товар продал конкретный автор. Если основной источник недоступен, резервный возвращает только ID товара, название, ссылку, изображение, цену в CNY и ID магазина. Поля с данными о продажах, доле положительных отзывов, названии магазина, категории, партнёрском вознаграждении и авторах в этом случае отсутствуют. Цены «от» в размере 0,1 юаня или меньше не учитываются.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеkeywordОбязательный- Поисковая фраза для товаров Douyin. Результаты образуют независимый пул товаров и не подтверждают, что какой-либо указанный автор продвигал или продавал эти товары.
Что означают параметры действия product_detail в API Douyin?
Получите данные одного товара Douyin Mall по числовому ID: отображаемую цену и цену со скидкой в CNY, показатель продаж, магазин, изображения, гарантии, сведения о доставке, варианты товара и наличие в продаже. Используйте product_id из product_search или live_product_search, а не SKU или ID акции.
product_idОбязательный- Числовой ID товара Douyin, который возвращают
product_searchилиlive_product_search. Это не ID SKU, не ID промоакции, не название и не URL.
Что означают параметры действия live_product_search в API Douyin?
Находите по ключевому слову до трёх товаров Douyin, которые продаются в прямых эфирах прямо сейчас. Получите SKU, название, цену в CNY, магазин и ID комнаты эфира. ID комнаты относится только к этому поиску. Прошлые продажи в эфирах по нему не определить.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеkeywordОбязательный- Поисковая фраза для товаров Douyin Mall. Возвращаются только товары, у которых на момент запроса есть метка трансляции и ID комнаты трансляции. Результаты не показывают, что продавал тот или иной автор на трансляциях.
Что означают параметры действия hashtag_search в API Douyin?
Находите хештеги Douyin, в названии которых есть keyword, отсортированные по популярности. У каждого хештега есть числовой ID, индекс популярности и число видео, лайков и просмотров за последние 7 полных дней по китайскому времени, а даты периода указаны в каждой записи. До 200 хештегов за вызов, по умолчанию 20; чтобы получить итоги за всё время, передайте hashtag_id в hashtag_detail.
keywordОбязательный- Слово для поиска в названиях хештегов Douyin, например
food. Запросы на китайском обычно находят больше хештегов. Ищутся хештеги, а не видео.
Что означают параметры действия hashtag_detail в API Douyin?
Получите один хештег Douyin по числовому hashtag_id из hashtag_search: название, общее число просмотров с момента создания, число присоединившихся пользователей, время создания и ссылку «Поделиться». Итоговые значения являются счётчиками платформы за всё время существования хештега, а не за период.
hashtag_idОбязательный- Числовой ID хештега Douyin для
hashtag_detail, например1767586897793101, из поляhashtag_idзаписиhashtag_search. Название хештега или#nameотклоняется до списания средств.
Что означают параметры действия billboard_video_hot в API Douyin?
Получите данные из рейтингов видео Hot Spot Treasure, собственного инструмента трендов Douyin. Доступны общий рейтинг, рейтинг по приросту подписчиков и рейтинг по доле лайков за последний час, день, 3 дня или 7 дней. Для каждого видео указаны число воспроизведений и лайков, доля лайков, прирост подписчиков, темп прироста подписчиков, показатель популярности и число подписчиков автора. Видео идут по убыванию показателя популярности. На странице может быть до 50 записей. Douyin отфильтровывает часть видео, поэтому страницы часто содержат меньше записей, и неполная страница не означает конец списка. В записях нет позиции в рейтинге.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеboardНеобязательный- Рейтинг для
billboard_video_hot:all(по умолчанию) означает общий рейтинг,follower_growth— рейтинг работ с наибольшим отношением прироста подписчиков к числу просмотров, аlike_rate— рейтинг с самой высокой долей лайков.Допустимые значения:allfollower_growthlike_rate keywordНеобязательный- Необязательно: оставить только публикации, связанные с этим словом, например
food. Без него возвращается весь рейтинг. page_tokenНеобязательный- Токен страницы. Для первой страницы не передавайте его, затем передавайте
next_page_tokenиз предыдущего ответа без изменений, не меняя остальные параметры. Каждая страница содержит до 50 публикаций и требует отдельного вызова API. Douyin отфильтровывает часть публикаций, поэтому на странице их часто меньше 50; неполная страница не означает конец списка. Токены действуют 24 часа; на последней странице нетnext_page_token(в одном рейтинге максимум около 1000 публикаций). time_windowНеобязательный- Период:
1h(последний час),1d(последние 24 часа, по умолчанию),3dили7d.Допустимые значения:1d1h3d7d
Что означают параметры действия billboard_low_fan_explosion в API Douyin?
Находите ролики небольших аккаунтов Douyin, которые резко набрали популярность, по списку хитов аккаунтов с малым числом подписчиков в Hot Spot Treasure. В каждой записи число подписчиков автора сопоставляется с числом воспроизведений, лайков и новых подписчиков, привлечённых роликом, а также с долей лайков. Так можно оценить, насколько широко распространился ролик небольшого аккаунта. Сузьте выборку с помощью необязательного keyword и периода от одного часа до семи дней. На странице возвращается до 50 записей, а их фактическое число может различаться, поэтому продолжайте пагинацию, пока next_page_token не исчезнет.
keywordНеобязательный- Необязательно: оставить только публикации, связанные с этим словом, например
food. Без него возвращается весь рейтинг. page_tokenНеобязательный- Токен страницы. Для первой страницы не передавайте его, затем передавайте
next_page_tokenиз предыдущего ответа без изменений, не меняя остальные параметры. Каждая страница содержит до 50 публикаций и требует отдельного вызова API. Douyin отфильтровывает часть публикаций, поэтому на странице их часто меньше 50; неполная страница не означает конец списка. Токены действуют 24 часа; на последней странице нетnext_page_token(в одном рейтинге максимум около 1000 публикаций). time_windowНеобязательный- Период:
1h(последний час),1d(последние 24 часа, по умолчанию),3dили7d.Допустимые значения:1d1h3d7d
Что означают параметры действия billboard_high_completion в API Douyin?
Узнайте, какие ролики на Douyin зрители досматривают до конца, по списку с высоким процентом досмотров в Hot Spot Treasure. Для каждого ролика возвращаются длительность, число воспроизведений и лайков, доля лайков, показатель популярности, обложка и подписанная ссылка для воспроизведения; сам процент досмотров не возвращается. Выберите период от одного часа до семи дней и при необходимости укажите keyword. На странице возвращается до 50 записей, часто меньше; для пагинации используйте next_page_token.
keywordНеобязательный- Необязательно: оставить только публикации, связанные с этим словом, например
food. Без него возвращается весь рейтинг. page_tokenНеобязательный- Токен страницы. Для первой страницы не передавайте его, затем передавайте
next_page_tokenиз предыдущего ответа без изменений, не меняя остальные параметры. Каждая страница содержит до 50 публикаций и требует отдельного вызова API. Douyin отфильтровывает часть публикаций, поэтому на странице их часто меньше 50; неполная страница не означает конец списка. Токены действуют 24 часа; на последней странице нетnext_page_token(в одном рейтинге максимум около 1000 публикаций). time_windowНеобязательный- Период:
1h(последний час),1d(последние 24 часа, по умолчанию),3dили7d.Допустимые значения:1d1h3d7d
Что означают параметры действия billboard_search_hot в API Douyin?
Находите растущие поисковые запросы Douyin по поисковому списку в Hot Spot Treasure. У каждого запроса указаны позиция, поисковая популярность за выбранный период и динамика популярности по дням максимум за 14 дней. При желании оставьте только запросы, содержащие keyword. На странице возвращается 50 запросов; следующие страницы получайте через next_page_token. Популярность — это собственный показатель Douyin, а не количество поисковых запросов.
keywordНеобязательный- Необязательно: оставить только поисковые запросы, содержащие это слово, например
food. Без него возвращается весь рейтинг поисковых запросов. page_tokenНеобязательный- Токен страницы. Для первой страницы (топ-50 запросов) не передавайте его, затем передавайте
next_page_tokenиз предыдущего ответа без изменений, не меняя остальные параметры. Каждая страница содержит до 50 запросов и соответствует одному вызову. Токены действуют 24 часа, на последней странице нетnext_page_token. time_windowНеобязательный- Период для популярности поисковых запросов:
1h,1d(по умолчанию),3dили7d.Допустимые значения:1d1h3d7d
Что означают параметры действия billboard_account_search в API Douyin?
Ищите аккаунты Douyin, связанные с keyword, через Hot Spot Treasure, с числом подписчиков, лайков и видео у каждого. Возвращаемый user_id и есть secUid, который принимают profile и user_posts. Около 30 аккаунтов на странице, иногда чуть меньше; следующие страницы получайте через next_page_token. Результаты содержат связанные аккаунты, а не рейтинг.
keywordОбязательный- Слово для поиска связанных аккаунтов Douyin, например
food. Для каждого аккаунта возвращается число подписчиков, лайков и видео. page_tokenНеобязательный- Токен страницы. Для первой страницы не передавайте его, затем передавайте
next_page_tokenиз предыдущего ответа без изменений. Каждая страница содержит до 30 аккаунтов (иногда на один-два меньше, и это не означает конец) и соответствует одному вызову. Токены действуют 24 часа, на последней странице нетnext_page_token.
Что означают параметры действия music_search в API Douyin?
Ищите в музыкальной библиотеке Douyin по названию песни, исполнителю или названию звука. У каждого трека есть название, исполнитель, длительность, число работ с ним, обложка, ссылка на воспроизведение, ссылка на текст, если он есть, и теги. 10 треков на странице; следующие страницы получайте через next_page_token. Наличие трека на Douyin не означает, что его можно использовать в коммерческих целях.
keywordОбязательный- Название песни, исполнитель или название звука, например
Jay Chou. Поиск идёт по музыкальной библиотеке Douyin, а не по видео. page_tokenНеобязательный- Токен страницы. Для первой страницы не передавайте его, затем передавайте
next_page_tokenиз предыдущего ответа без изменений. Каждая страница содержит до 10 треков и соответствует одному вызову. Токены действуют 24 часа, на последней странице нетnext_page_token.
Что означают параметры действия search_suggest в API Douyin?
Получите подсказки автодополнения, которые Douyin показывает в поисковой строке для keyword, в порядке, заданном Douyin. Нумерация в поле rank начинается с 1. За один вызов возвращается до 10 подсказок; обычно Douyin предлагает около пяти, пагинации нет. Объём поиска для подсказок не указывается.
keywordОбязательный- Текст, введённый в поисковую строку Douyin, например
artificial intelligence. Подсказки возвращаются в том порядке, в каком их выдаёт Douyin.
Что означают параметры действия billboard_rise_list в API Douyin?
Находите тренды, которые быстрее всего растут на Douyin, по списку растущих трендов в Hot Spot Treasure. У каждого тренда указаны позиция, число позиций, на которые он поднялся, название, ID, показатель популярности, число связанных видео, категория, время создания и почасовая кривая популярности. При желании оставьте только тренды, названия которых содержат keyword. На странице возвращается 50 записей; следующие страницы получайте через next_page_token.
keywordНеобязательный- Необязательно: оставить только тренды, содержащие это слово, например
game. Без него возвращается весь рейтинг растущих трендов. page_tokenНеобязательный- Токен страницы. Для первой страницы (топ-50 трендов) не передавайте его, затем передавайте
next_page_tokenиз предыдущего ответа без изменений, не меняя остальные параметры. Каждая страница содержит до 50 трендов и соответствует одному вызову. Токены действуют 24 часа, на последней странице нетnext_page_token.
Что означают параметры действия billboard_challenge_hot в API Douyin?
Получите список челленджей в Hot Spot Treasure, собственном инструменте трендов Douyin: весь список из 50 трендов за один вызов. У каждого тренда есть позиция, название, ID, популярность, число связанных видео, время создания и кривая популярности с шагом около десяти минут. limit может только уменьшить число записей, пагинации нет.
У этого действия нет бизнес-параметров. Передайте только идентификаторы платформы и действия.
Что означают параметры действия billboard_topic_hot в API Douyin?
Узнайте, какие хештеги Douyin набирают популярность, по списку хештегов в Hot Spot Treasure за последний час, день, 3 дня или 7 дней. У каждого хештега указаны позиция, числовой ID для hashtag_detail, название, показатель популярности, общее число просмотров и роликов за всё время, среднее число просмотров на ролик, обложка и динамика популярности по дням максимум за 14 дней. На странице возвращается 50 записей; следующие страницы получайте через next_page_token.
keywordНеобязательный- Необязательно: оставить только хештеги, в названии которых есть это слово, например
food. Без него возвращается весь рейтинг хештегов. page_tokenНеобязательный- Токен страницы. Для первой страницы (50 самых популярных хештегов) не передавайте его, затем передавайте
next_page_tokenиз предыдущего ответа без изменений, не меняя остальные параметры. Каждая страница содержит до 50 хештегов и требует отдельного вызова API. Токены действуют 24 часа; на последней странице нетnext_page_token(в одном рейтинге максимум около 1000 хештегов). time_windowНеобязательный- Период для популярности хештегов:
1h,1d(по умолчанию),3dили7d.Допустимые значения:1d1h3d7d
Что означают параметры действия music_detail в API Douyin?
Получите данные одного трека Douyin по числовому music_id из music_search или по ссылке douyin.com/music: название, исполнителя, длительность, число работ с этим треком, обложку, ссылку на воспроизведение и ссылку на текст песни, если он есть. Для поиска по названию песни используйте music_search.
music_idОбязательный- Числовой ID трека Douyin, например
7699717253151558410, из поляidзаписиmusic_search; также принимается ссылка douyin.com/music/<ID>.
Что означают параметры действия xingtu_conversion_ability в API Douyin?
Получите показатели конверсии, которые Xingtu показывает для видео по заказам Xingtu одного автора Douyin за последние 7, 30 или 90 дней: число связанных видео, медиану воспроизведений, клики по компоненту и CTR, CPC, GPM, средние продажи, продвигаемые товары и их категории. Большинство значений указаны диапазонами в формулировках Xingtu, например 500-1000, а открытые диапазоны вроде «10% или больше» даны на китайском. Данные есть только у авторов с заказами Xingtu за выбранный период; для остальных возвращается пустой результат, за который списание не производится.
douyin_idОбязательный- Видимый ID автора в Douyin (
unique_idизcreator_search) или 19-значныйcreator_idXingtu, возвращаемыйxingtu_creator_search. Если автора нет на Xingtu, возвращается пустой результат; плата за такой вызов не списывается. time_windowНеобязательный- Период данных Xingtu:
7d,30d(по умолчанию) или90d. Период отсчитывается назад от текущей даты. Это не период рейтингаxingtu_creator_rankings.Допустимые значения:30d7d90d
Что означают параметры действия xingtu_link_structure в API Douyin?
Узнайте, сколько пользователей Xingtu считает связанными с одним автором Douyin, с разбивкой по четырём уровням Xingtu: для каждого указаны число, доля от общего числа и медиана по авторам той же отрасли. Также возвращаются общее число, его место среди авторов Xingtu (total_rank_top_percent, от 0 до 1, чем меньше, тем лучше) и метка типа связи Xingtu на китайском, означающая посев или распространение.
douyin_idОбязательный- Видимый ID автора в Douyin (
unique_idизcreator_search) или 19-значныйcreator_idXingtu, возвращаемыйxingtu_creator_search. Если автора нет на Xingtu, возвращается пустой результат; плата за такой вызов не списывается.
Что означают параметры действия xingtu_recommended_videos в API Douyin?
Получите четыре группы видео со страницы автора Douyin в Xingtu: знаковые видео, последние видео, лучшие видео по заказам Xingtu и лучшие личные видео. Для каждого видео указаны только ID, ссылка, число воспроизведений и время публикации. Группы без видео не возвращаются.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеdouyin_idОбязательный- Видимый ID автора в Douyin (
unique_idизcreator_search) или 19-значныйcreator_idXingtu, возвращаемыйxingtu_creator_search. Если автора нет на Xingtu, возвращается пустой результат; плата за такой вызов не списывается.
Что означают параметры действия xingtu_touch_distribution в API Douyin?
Узнайте, из каких категорий контента пришли связанные пользователи автора Douyin по данным Xingtu: дерево до трёх уровней, обычно сначала личный контент или контент Xingtu, затем категория и подкатегория, и у каждого узла указано число.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеdouyin_idОбязательный- Видимый ID автора в Douyin (
unique_idизcreator_search) или 19-значныйcreator_idXingtu, возвращаемыйxingtu_creator_search. Если автора нет на Xingtu, возвращается пустой результат; плата за такой вызов не списывается.
Что означают параметры действия xingtu_video_performance в API Douyin?
Сравните личные видео автора Douyin и его видео по заказам Xingtu по уровню вовлечённости, медиане воспроизведений и проценту досмотров. Для каждого показателя указаны значение автора, среднее по платформе и процентиль (доля авторов, которых он опережает, от 0 до 1). Также возвращаются последние личные видео и видео по заказам Xingtu, примерно до 15 каждого вида, с названием, воспроизведениями, лайками, комментариями, репостами и длительностью.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеdouyin_idОбязательный- Видимый ID автора в Douyin (
unique_idизcreator_search) или 19-значныйcreator_idXingtu, возвращаемыйxingtu_creator_search. Если автора нет на Xingtu, возвращается пустой результат; плата за такой вызов не списывается.
Как использовать API Douyin
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
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>"}}'
Руководства по API Douyin
Практические примеры и методики на основе этих действий. Сначала сверьтесь с актуальными действиями, параметрами и полями на этой странице: примеры и ограничения из статьи не заменяют актуальный каталог.
Как получить комментарии Douyin: от URL видео к JSON со структурой ответов
Начните с актуальных параметров douyin.comments, получайте комментарии с помощью минимальных запросов, сохраняйте источник видео, ID комментариев и связи ответов, обрабатывайте лимиты, пустые результаты, разбор временных меток и повторные наблюдения.
Читать статьюКак мониторить репутацию на нескольких платформах: сначала определите охват, потом оценивайте рост негатива
Спроектируйте прослеживаемый процесс мониторинга репутации на основе списков целей, идентификаторов комментариев и инкрементальных курсоров; офлайн-примеры показывают дедупликацию и пробелы в сборе данных при сохранении ручной проверки.
Читать статьюБыстрый старт с единым API данных: от каталога возможностей к первому полученному результату
Получайте данные с разных платформ через platform, action и params: изучите каталог возможностей, выполните минимальные запросы, обработайте асинхронные задачи и частичные результаты, учтите оплату и обеспечьте прослеживаемость записей данных.
Читать статьюВопросы об API Douyin
Какие данные можно получить через API Douyin?
Укажите в platform значение douyin. В текущем каталоге: поиск, профили, посты пользователя, сведения о видео, комментарии и more. Эти названия действий соответствуют разным объектам или представлениям Douyin; это не взаимозаменяемые режимы поиска.
Есть ли у Douyin официальный API?
Douyin Open Platform предоставляет API на основе OAuth мобильным и веб-приложениям, зарегистрированным верифицированными юридическими лицами, при этом доступны только данные пользователей, авторизовавших приложение. Поиск видео по ключевым словам указан как экспериментальная возможность и для разработчиков не открыт.
Официальные источники: «Douyin Open Platform: joining as a developer» · «Douyin Open Platform: video search capability» · Проверено
Нужен ли аккаунт разработчика Douyin или API-ключ?
Нет. Запросы идут через EveryInfra с API-ключом EveryInfra: зарегистрируйтесь, создайте ключ в консоли и передавайте его в заголовке Authorization: Bearer <API_KEY>. Вам не нужно регистрировать приложение разработчика Douyin, запрашивать доступ к API Douyin или входить через аккаунт Douyin. Действия возвращают только публичные данные Douyin.
Сколько стоит Douyin API за 1 000 запросов?
От $0.56 за 1 000 запросов в зависимости от действия; цена каждого действия указана в таблице на этой странице и в публичном каталоге. Подписки нет: вы пополняете баланс в USD и платите за каждый вызов, а неудачные вызовы и пустые результаты не оплачиваются.
Какие входные данные нужны для запроса search к платформе Douyin?
Поисковый запрос для действия поиска видео, передаётся строкой, например latte art. Ищет видео; это не никнейм аккаунта и не ID видео. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Douyin?
Объявленная схема включает next_page_token, text, media_type и video_url. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Douyin возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.