API TikTok
Поиск видео, хештегов, профилей пользователей и товаров магазинов TikTok: расшифровки, комментарии и показатели электронной коммерции.
Для расшифровок нужен действительный URL видео TikTok. Комментарии возвращаются как записи верхнего уровня с несколькими ответами, без полных деревьев обсуждений.
Доступность платформы
- Состояние за 24 ч
- 96%
За последние 30 дней
Доступные возможности
Все действия TikTok: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите в TikTok по ключевому слову на вкладке видео, аккаунтов или топа: подпись, автор и число лайков, комментариев, репостов и просмотров. | $0.56 за 1 000 запросов | Норма |
Профилиprofile | Найдите аккаунт TikTok по имени пользователя: описание, внешнюю ссылку, число подписчиков, подписок, лайков, видео и друзей и дату создания. | $0.56 за 1 000 запросов | Работает стабильно · состояние 100% |
Видео пользователяuser_videos | Получите список видео автора TikTok с подписью, временем публикации и числом лайков, комментариев, репостов и просмотров. | $0.56 за 1 000 запросов | Работает стабильно · состояние 100% |
Сведения о видеоvideo | Получите подпись, автора, время публикации и число лайков, комментариев, репостов и просмотров одного видео TikTok по URL. | $0.56 за 1 000 запросов | Работает стабильно · состояние 99% |
Комментарииcomments | Получите комментарии к видео TikTok: лайки, число ответов, ссылки на ответы, а также признаки того, поставил ли автор видео лайк каждому комментарию и закрепил ли он его. | $0.56 за 1 000 запросов | Норма |
Хештегhashtag | Просматривайте видео TikTok с определённым хештегом. | $0.56 за 1 000 запросов | Норма |
Подписчикиfollowers | Узнайте общее число подписчиков, подписок, постов и лайков аккаунта TikTok по имени пользователя, с флагом точности для округлённых чисел. | $0.56 за 1 000 запросов | Норма |
Расшифровкаtranscript | Извлеките расшифровку видео TikTok по URL. | $0.56 за 1 000 запросов | Норма |
Поиск товаров в Shopshop_search | Находите товары TikTok Shop по ключевому слову: цена, исходная цена, число продаж, рейтинг, число отзывов, категория и название магазина. | $0.56 за 1 000 запросов | Норма |
Сведения об авторе в Shopshop_creator | Оцените автора TikTok Shop по имени пользователя: категории, подписчики, число видео, продвигаемые товары, число продаж и средние просмотры. | $0.56 за 1 000 запросов | Норма |
Поиск по хештегамhashtag_search | Ищите хештеги TikTok по keyword. | $0.81 за 1 000 запросов | Норма |
Поиск музыкиmusic_search | Ищите в библиотеке звуков TikTok по keyword, например по песне или исполнителю. | $0.81 за 1 000 запросов | Норма |
Музыкальный чартmusic_chart | Получите музыкальный чарт TikTok: top50 (по умолчанию) или viral50. | $0.81 за 1 000 запросов | Норма |
Поиск аккаунтовuser_search | Ищите аккаунты TikTok по keyword в порядке ранжирования поиска TikTok. | $0.56 за 1 000 запросов | Работает стабильно · состояние 100% |
Видео с этим звукомsound_videos | Получите список видео TikTok с одним звуком по music_id или ссылке на страницу звука. | $0.56 за 1 000 запросов | Норма |
Ответы на комментарииcomment_replies | Получите ответы на один комментарий к видео TikTok по url видео и id комментария, который вернуло comments. | $0.56 за 1 000 запросов | Норма |
Хиты продаж в Shopshop_hot_products | Получите список бестселлеров TikTok Shop для одного рынка Юго-Восточной Азии или Азии: ID, JP, MX, MY (по умолчанию), PH, SG, TH или VN. | $0.81 за 1 000 запросов | Норма |
Товары Shop по категориямshop_category_products | Получите список товаров TikTok Shop в одной категории по category_id, например 601450 для красоты и личной гигиены, на выбранном рынке. | $0.81 за 1 000 запросов | Норма |
Подпискиfollowing | Получите список аккаунтов, на которые подписан пользователь TikTok, по имени пользователя. | $0.64 за 1 000 запросов | Норма |
Ссылки на скачивание видеоvideo_download | Получите ссылки для скачивания одного видео TikTok без водяного знака по url. | $0.64 за 1 000 запросов | Норма |
Прямой эфирlive_room | Проверьте по имени пользователя, ведёт ли аккаунт TikTok прямой эфир прямо сейчас. | $0.81 за 1 000 запросов | Норма |
Товары магазина в Shopshop_products | Получите список товаров одного магазина TikTok Shop по shop_id или ссылке на магазин на выбранном рынке. | $0.81 за 1 000 запросов | Норма |
Отзывы о товарах Shopshop_product_reviews | Получите отзывы покупателей об одном товаре TikTok Shop по product_id или ссылке на товар. | $0.76 за 1 000 запросов | Норма |
Трендовые хештегиtrending_hashtags | Получите трендовые хештеги TikTok для одного рынка за последние 7, 30 или 90 дней, при необходимости для одной отрасли. | $0.81 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API TikTok?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите в TikTok по ключевому слову на вкладке видео, аккаунтов или топа: подпись, автор и число лайков, комментариев, репостов и просмотров. Вкладка выбирается в | keyword | content_type | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | id · url · text · author_name · author_username · like_count · comment_count · share_count · view_count · posted_at · collect_count · repost_count · duration_sec · duration_seconds · cover_image_url · language · country · hashtags · music · is_ad · is_pinned · is_sponsored · is_slideshow · has_shop_product · author_id · author_url · author_avatar_url · author_bio · author_is_verified · author_is_private · author_is_seller · author_follower_count · author_following_count · author_like_count · author_video_count · platform |
profileПрофили Найдите аккаунт TikTok по имени пользователя: описание, внешнюю ссылку, число подписчиков, подписок, лайков, видео и друзей и дату создания. Указывайте имя пользователя с @ или без, а не URL профиля или secUid из Douyin. Закрытая аналитика не включается. | username | — | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | user_id · username · display_name · bio · url · external_url · follower_count · following_count · like_count · video_count · friend_count · is_verified · is_private · avatar_url · created_at · platform |
user_videosВидео пользователя Получите список видео автора TikTok с подписью, временем публикации и числом лайков, комментариев, репостов и просмотров. Фильтруйте через | username | min_likes, sort, until | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | id · url · text · author_name · author_username · like_count · comment_count · share_count · view_count · posted_at · collect_count · repost_count · duration_sec · duration_seconds · cover_image_url · language · country · hashtags · music · is_ad · is_pinned · is_sponsored · is_slideshow · has_shop_product · author_id · author_url · author_avatar_url · author_bio · author_is_verified · author_is_private · author_is_seller · author_follower_count · author_following_count · author_like_count · author_video_count · platform |
videoСведения о видео Получите подпись, автора, время публикации и число лайков, комментариев, репостов и просмотров одного видео TikTok по URL. Для комментариев и расшифровки есть отдельные действия, история показателей не сохраняется. | url | — | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | id · url · text · author_name · author_username · like_count · comment_count · share_count · view_count · posted_at · collect_count · repost_count · duration_sec · duration_seconds · cover_image_url · language · country · hashtags · music · is_ad · is_pinned · is_sponsored · is_slideshow · has_shop_product · author_id · author_url · author_avatar_url · author_bio · author_is_verified · author_is_private · author_is_seller · author_follower_count · author_following_count · author_like_count · author_video_count · platform |
commentsКомментарии Получите комментарии к видео TikTok: лайки, число ответов, ссылки на ответы, а также признаки того, поставил ли автор видео лайк каждому комментарию и закрепил ли он его. К каждому комментарию верхнего уровня прилагается не более двух ответов, поэтому полное дерево обсуждения не гарантируется. | url | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | id · text · author_username · author_id · like_count · reply_count · reply_to_id · is_reply · liked_by_author · pinned_by_author · posted_at · platform |
hashtagХештег Просматривайте видео TikTok с определённым хештегом. У каждого видео есть подпись, автор и число лайков, комментариев, репостов и просмотров. Передайте хештег с символом # или без него. Это не текстовый поиск, и общий объём или динамика хештега не измеряются. | hashtag | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=30. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | id · url · text · author_name · author_username · like_count · comment_count · share_count · view_count · posted_at · collect_count · repost_count · duration_sec · duration_seconds · cover_image_url · language · country · hashtags · music · is_ad · is_pinned · is_sponsored · is_slideshow · has_shop_product · author_id · author_url · author_avatar_url · author_bio · author_is_verified · author_is_private · author_is_seller · author_follower_count · author_following_count · author_like_count · author_video_count · platform |
followersПодписчики Узнайте общее число подписчиков, подписок, постов и лайков аккаунта TikTok по имени пользователя, с флагом точности для округлённых чисел. Возвращаются числа, а не имена подписчиков. | username | channel | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform |
transcriptРасшифровка Извлеките расшифровку видео TikTok по URL. Вы получите полный текст, а также сегменты с таймкодами, если они есть. Сначала проверьте | url | — | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | id · url · text · segments · has_transcript · platform |
shop_searchПоиск товаров в Shop Находите товары TikTok Shop по ключевому слову: цена, исходная цена, число продаж, рейтинг, число отзывов, категория и название магазина. Рынок задаётся в | keyword | country, page | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | id · url · name · price · original_price · currency · sold_count · rating · rating_scale · review_count · category · shop_name · image_url · platform |
shop_creatorСведения об авторе в Shop Оцените автора TikTok Shop по имени пользователя: категории, подписчики, число видео, продвигаемые товары, число продаж и средние просмотры. | username | country | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | id · username · url · name · text · avatar_url · country · categories · follower_count · video_count · product_count · sold_count · avg_views · platform |
hashtag_searchПоиск по хештегам Ищите хештеги TikTok по | keyword | page_token | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 20. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет. | $0.81 за 1 000 запросов | hashtag_id · hashtag_name · url · description · video_count · view_count · next_page_token · platform |
music_searchПоиск музыки Ищите в библиотеке звуков TikTok по | keyword | page_token | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 20. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет. | $0.81 за 1 000 запросов | id · url · title · author_name · album · duration_seconds · duration_sec · use_count · is_original · is_commercial · released_at · cover_image_url · audio_url · next_page_token · platform |
music_chartМузыкальный чарт Получите музыкальный чарт TikTok: | chart | Режим выдачи: Sync | Значения в каталоге: defaultLimit=50, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Можно передать большее значение limit, но оно будет ограничено значением 50. | $0.81 за 1 000 запросов | rank · id · url · title · author_name · album · language · duration_seconds · duration_sec · use_count · is_commercial · released_at · cover_image_url · audio_url · platform | |
user_searchПоиск аккаунтов Ищите аккаунты TikTok по | keyword | page_token | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 20. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет. | $0.56 за 1 000 запросов | user_id · username · display_name · url · sec_uid · follower_count · following_count · like_count · video_count · is_verified · verified_label · avatar_url · is_live · next_page_token · platform |
sound_videosВидео с этим звуком Получите список видео TikTok с одним звуком по | music_id | page_token | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 20. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет. | $0.56 за 1 000 запросов | id · url · text · author_name · author_username · like_count · comment_count · share_count · view_count · posted_at · collect_count · repost_count · duration_sec · duration_seconds · cover_image_url · language · country · hashtags · music · is_ad · is_pinned · is_sponsored · is_slideshow · has_shop_product · author_id · author_url · author_avatar_url · author_bio · author_is_verified · author_is_private · platform · next_page_token |
comment_repliesОтветы на комментарии Получите ответы на один комментарий к видео TikTok по | url, comment_id | page_token | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 20. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет. | $0.56 за 1 000 запросов | id · text · like_count · author_username · author_name · author_id · author_url · author_avatar_url · liked_by_author · is_reply · reply_to_id · reply_to_reply_id · language · posted_at · video_id · next_page_token · platform |
shop_hot_productsХиты продаж в Shop Получите список бестселлеров TikTok Shop для одного рынка Юго-Восточной Азии или Азии: ID, JP, MX, MY (по умолчанию), PH, SG, TH или VN. У каждого товара есть | country | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Можно передать большее значение limit, но оно будет ограничено значением 100. | $0.81 за 1 000 запросов | rank · id · url · name · price · original_price · currency · sold_count · rating · rating_scale · review_count · shop_name · shop_id · image_url · platform | |
shop_category_productsТовары Shop по категориям Получите список товаров TikTok Shop в одной категории по | category_id | country, page_token | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 15. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет. | $0.81 за 1 000 запросов | id · url · name · price · original_price · currency · sold_count · rating · rating_scale · review_count · shop_name · shop_id · image_url · platform · next_page_token |
followingПодписки Получите список аккаунтов, на которые подписан пользователь TikTok, по имени пользователя. У каждого аккаунта есть ID пользователя, имя пользователя, отображаемое имя, | username | page_token | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 20. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет. | $0.64 за 1 000 запросов | user_id · username · display_name · url · sec_uid · bio · follower_count · following_count · like_count · video_count · is_verified · verified_label · avatar_url · country · next_page_token · platform |
video_downloadСсылки на скачивание видео Получите ссылки для скачивания одного видео TikTok без водяного знака по | url | — | Режим выдачи: Sync | — | $0.64 за 1 000 запросов | id · url · text · author_username · duration_seconds · duration_sec · video_url · video_backup_urls · width · height · size_bytes · hd_video_url · hd_width · hd_size_bytes · watermarked_video_url · audio_url · cover_image_url · image_urls · is_slideshow · expires_at · platform |
live_roomПрямой эфир Проверьте по имени пользователя, ведёт ли аккаунт TikTok прямой эфир прямо сейчас. Во время эфира вы получите ID комнаты, название, ссылку, текущее, пиковое и общее число зрителей, лайки, репосты, число товаров, время начала, обложку и ссылку на поток с ограниченным сроком действия. Если аккаунт не в эфире, возвращается одна запись с | username | — | Режим выдачи: Sync | — | $0.81 за 1 000 запросов | username · display_name · user_id · is_live · room_id · url · title · viewer_count · peak_viewer_count · total_viewer_count · like_count · share_count · product_count · started_at · cover_image_url · stream_url · platform |
shop_productsТовары магазина в Shop Получите список товаров одного магазина TikTok Shop по | shop_id | country, page_token | Режим выдачи: Sync | Чтобы получить следующую страницу, передайте next_page_token как page_token, не меняя остальные параметры; каждая страница — отдельный вызов. | $0.81 за 1 000 запросов | id · url · name · price · original_price · currency · sold_count · rating · rating_scale · review_count · shop_name · shop_id · image_url · platform · next_page_token |
shop_product_reviewsОтзывы о товарах Shop Получите отзывы покупателей об одном товаре TikTok Shop по | product_id | country, page_token, rating, sort | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 20. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет. | $0.76 за 1 000 запросов | id · rating · rating_scale · text · posted_at · variant · is_verified_purchase · is_incentivized · image_urls · author_name · country · product_id · next_page_token · platform |
trending_hashtagsТрендовые хештеги Получите трендовые хештеги TikTok для одного рынка за последние 7, 30 или 90 дней, при необходимости для одной отрасли. У каждого хештега есть | country, industry, page_token, time_window | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 20. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token. Параметр limit принимается, но ни на что не влияет. | $0.81 за 1 000 запросов | rank · hashtag_id · hashtag_name · url · video_count · view_count · trend · next_page_token · platform |
Что означают параметры действия search в API TikTok?
Ищите в TikTok по ключевому слову на вкладке видео, аккаунтов или топа: подпись, автор и число лайков, комментариев, репостов и просмотров. Вкладка выбирается в content_type. Результаты не являются полной выборкой, а ранжирование не раскрывается.
keywordОбязательный- Поисковый запрос для поиска публичных видео в действии
search. Вshop_searchон ищет товары TikTok Shop, которые берутся из отдельного набора данных. content_typeНеобязательный- Фильтрует результаты по вкладке в действии
search. Допустимые значения:videoдля видео,profileдля пользователей иtopдля популярного контента. В действиях с фиксированным автором, видео или хештегом этот параметр может не сработать, поэтому после смены вкладки проверяйте возвращаемые объекты и поля ответа.Допустимые значения:profiletopvideo
Что означают параметры действия profile в API TikTok?
Найдите аккаунт TikTok по имени пользователя: описание, внешнюю ссылку, число подписчиков, подписок, лайков, видео и друзей и дату создания. Указывайте имя пользователя с @ или без, а не URL профиля или secUid из Douyin. Закрытая аналитика не включается.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеusernameОбязательный- Публичное имя пользователя TikTok, символ
@в начале необязателен. Не передавайте токеныsecUidиз Douyin и полные URL профилей. Вfollowersвозвращает число подписчиков, вshop_creatorзапрашивает данные автора об электронной торговле на указанном рынке.TikTok: чем имя пользователя отличается от отображаемого никнейма — TikTok различает username и nickname: username — это имя с символом @, которое также входит в URL профиля, а nickname — отображаемое имя, которое видят другие пользователи. При смене username меняется и URL профиля. · Проверено
Что означают параметры действия user_videos в API TikTok?
Получите список видео автора TikTok с подписью, временем публикации и числом лайков, комментариев, репостов и просмотров. Фильтруйте через min_likes, ограничивайте дату публикации через until или сортируйте через sort по новизне, давности или популярности. Черновики и закрытые посты не включаются.
usernameОбязательный- Публичное имя пользователя TikTok, символ
@в начале необязателен. Не передавайте токеныsecUidиз Douyin и полные URL профилей. Вfollowersвозвращает число подписчиков, вshop_creatorзапрашивает данные автора об электронной торговле на указанном рынке.TikTok: чем имя пользователя отличается от отображаемого никнейма — TikTok различает username и nickname: username — это имя с символом @, которое также входит в URL профиля, а nickname — отображаемое имя, которое видят другие пользователи. При смене username меняется и URL профиля. · Проверено min_likesНеобязательный- Числовой порог минимального числа лайков у видео. Применяется только к user_videos и не фильтрует по числу подписчиков автора или лайкам комментариев.
sortНеобязательный- Сортирует списки видео автора в действии
user_videos. Допустимые значения:newest,oldestиpopular. Применяется только кuser_videos.Допустимые значения:newestoldestpopular untilНеобязательный- Верхняя граница даты публикации видео, а не даты получения данных. Применяется только к user_videos.
Что означают параметры действия video в API TikTok?
Получите подпись, автора, время публикации и число лайков, комментариев, репостов и просмотров одного видео TikTok по URL. Для комментариев и расшифровки есть отдельные действия, история показателей не сохраняется.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- URL видео TikTok, обязательный для действий
video,commentsиtranscript. Вcommentsвозвращает комментарии к посту, где у каждого комментария верхнего уровня не больше двух ответов; полное дерево обсуждения не гарантируется.
Что означают параметры действия comments в API TikTok?
Получите комментарии к видео TikTok: лайки, число ответов, ссылки на ответы, а также признаки того, поставил ли автор видео лайк каждому комментарию и закрепил ли он его. К каждому комментарию верхнего уровня прилагается не более двух ответов, поэтому полное дерево обсуждения не гарантируется.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- URL видео TikTok, обязательный для действий
video,commentsиtranscript. Вcommentsвозвращает комментарии к посту, где у каждого комментария верхнего уровня не больше двух ответов; полное дерево обсуждения не гарантируется.
Что означают параметры действия hashtag в API TikTok?
Просматривайте видео TikTok с определённым хештегом. У каждого видео есть подпись, автор и число лайков, комментариев, репостов и просмотров. Передайте хештег с символом # или без него. Это не текстовый поиск, и общий объём или динамика хештега не измеряются.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеhashtagОбязательный- Название хештега для действия
hashtag, с#в начале или без. Параметр фильтрует именно по хештегу и не работает как произвольный полнотекстовый запрос.
Что означают параметры действия followers в API TikTok?
Узнайте общее число подписчиков, подписок, постов и лайков аккаунта TikTok по имени пользователя, с флагом точности для округлённых чисел. Возвращаются числа, а не имена подписчиков.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеusernameОбязательный- Публичное имя пользователя TikTok, символ
@в начале необязателен. Не передавайте токеныsecUidиз Douyin и полные URL профилей. Вfollowersвозвращает число подписчиков, вshop_creatorзапрашивает данные автора об электронной торговле на указанном рынке.TikTok: чем имя пользователя отличается от отображаемого никнейма — TikTok различает username и nickname: username — это имя с символом @, которое также входит в URL профиля, а nickname — отображаемое имя, которое видят другие пользователи. При смене username меняется и URL профиля. · Проверено channelНеобязательный- Имя аккаунта для действия
followers, параметр совместимости. Приоритет ниже, чем уusername. Для поиска товаров TikTok Shop не используется.
Что означают параметры действия transcript в API TikTok?
Извлеките расшифровку видео TikTok по URL. Вы получите полный текст, а также сегменты с таймкодами, если они есть. Сначала проверьте has_transcript. Наличие распознаваемой речи, перевод и абсолютная точность не гарантируются.
urlОбязательный- URL видео TikTok, обязательный для действий
video,commentsиtranscript. Вcommentsвозвращает комментарии к посту, где у каждого комментария верхнего уровня не больше двух ответов; полное дерево обсуждения не гарантируется.
Что означают параметры действия shop_search в API TikTok?
Находите товары TikTok Shop по ключевому слову: цена, исходная цена, число продаж, рейтинг, число отзывов, категория и название магазина. Рынок задаётся в country (по умолчанию US), а страницы переключаются через page. Остатки и GMV не рассчитываются.
keywordОбязательный- Поисковый запрос для поиска публичных видео в действии
search. Вshop_searchон ищет товары TikTok Shop, которые берутся из отдельного набора данных. countryНеобязательный- Код региона рынка для действий
shop_searchиshop_creator; по умолчаниюUSилиus. Не фильтрует по национальности автора или местоположению контента на платформе. Поддерживаемые рынки смотрите в каталоге. pageНеобязательный- Номер страницы (целое число, начиная с 1) для пагинации товаров в
shop_search; по умолчанию1. Не используется для пагинации комментариев к видео или списков видео автора.
Что означают параметры действия shop_creator в API TikTok?
Оцените автора TikTok Shop по имени пользователя: категории, подписчики, число видео, продвигаемые товары, число продаж и средние просмотры. country выбирает рынок Shop, а не гражданство автора. Закрытые данные о продажах, комиссионных и покупателях не показываются.
usernameОбязательный- Публичное имя пользователя TikTok, символ
@в начале необязателен. Не передавайте токеныsecUidиз Douyin и полные URL профилей. Вfollowersвозвращает число подписчиков, вshop_creatorзапрашивает данные автора об электронной торговле на указанном рынке. countryНеобязательный- Код региона рынка для действий
shop_searchиshop_creator; по умолчаниюUSилиus. Не фильтрует по национальности автора или местоположению контента на платформе. Поддерживаемые рынки смотрите в каталоге.
Что означают параметры действия hashtag_search в API TikTok?
Ищите хештеги TikTok по keyword. У каждого хештега есть ID, название, ссылка, описание, число видео и число просмотров. 20 записей на страницу; следующую страницу запрашивайте с next_page_token. Действие находит хештеги, а не видео с ними; чтобы получить видео, передайте название в hashtag.
keywordОбязательный- Слова для поиска по названиям хештегов TikTok, например fitness; начальный символ # удаляется.
page_tokenНеобязательный- Токен страницы для списочных действий TikTok, таких как
hashtag_search,user_search,followingиshop_products. Для первой страницы не передавайте его, затем передавайтеnext_page_tokenиз предыдущего ответа в точности как получили, не меняя остальные параметры. У последней страницы токена нет.
Что означают параметры действия music_search в API TikTok?
Ищите в библиотеке звуков TikTok по keyword, например по песне или исполнителю. У каждого звука есть ID, название, исполнитель, альбом, длительность, число видео с ним, флаги оригинального звука и коммерческой библиотеки, дата выхода, обложка и ссылка на короткое превью. 20 записей на страницу; следующую страницу запрашивайте с next_page_token.
keywordОбязательный- Название песни, исполнитель или название звука для поиска, например taylor swift.
page_tokenНеобязательный- Токен страницы для списочных действий TikTok, таких как
hashtag_search,user_search,followingиshop_products. Для первой страницы не передавайте его, затем передавайтеnext_page_tokenиз предыдущего ответа в точности как получили, не меняя остальные параметры. У последней страницы токена нет.
Что означают параметры действия music_chart в API TikTok?
Получите музыкальный чарт TikTok: top50 (по умолчанию) или viral50. У каждого звука есть rank, ID, название, исполнитель, альбом, язык, длительность, число использований, флаг коммерческой библиотеки, дата выхода, обложка и ссылка на превью. Один вызов возвращает весь чарт из 50 позиций.
chartНеобязательный- Музыкальный чарт, который читает
music_chart:top50(по умолчанию) илиviral50.Допустимые значения:top50viral50
Что означают параметры действия user_search в API TikTok?
Ищите аккаунты TikTok по keyword в порядке ранжирования поиска TikTok. У каждого аккаунта есть ID пользователя, имя пользователя, отображаемое имя, sec_uid, число подписчиков, подписок, лайков и видео, верификация, аватар и признак того, идёт ли сейчас эфир. 20 записей на страницу; следующую страницу запрашивайте с next_page_token.
keywordОбязательный- Слова для поиска аккаунтов TikTok, например cooking. Совпадения ищутся в именах пользователей, отображаемых именах и описаниях профилей так же, как в поиске TikTok.
page_tokenНеобязательный- Токен страницы для списочных действий TikTok, таких как
hashtag_search,user_search,followingиshop_products. Для первой страницы не передавайте его, затем передавайтеnext_page_tokenиз предыдущего ответа в точности как получили, не меняя остальные параметры. У последней страницы токена нет.
Что означают параметры действия sound_videos в API TikTok?
Получите список видео TikTok с одним звуком по music_id или ссылке на страницу звука. У каждого видео есть подпись, автор, время публикации, число просмотров, лайков, комментариев, репостов и сохранений, длительность, хештеги и флаги рекламы, закрепления и слайд-шоу. Около 20 записей на страницу; следующую страницу запрашивайте с next_page_token.
music_idОбязательный- Числовой ID звука TikTok для
sound_videos(idзаписи изmusic_searchилиmusic_chart) или ссылка на страницу звука, например https://www.tiktok.com/music/<name>-<ID>. page_tokenНеобязательный- Токен страницы для списочных действий TikTok, таких как
hashtag_search,user_search,followingиshop_products. Для первой страницы не передавайте его, затем передавайтеnext_page_tokenиз предыдущего ответа в точности как получили, не меняя остальные параметры. У последней страницы токена нет.
Что означают параметры действия comment_replies в API TikTok?
Получите ответы на один комментарий к видео TikTok по url видео и id комментария, который вернуло comments. У каждого ответа есть текст, лайки, время, имя пользователя, имя и ID автора ответа и признак того, лайкнул ли его автор видео. До 20 записей на страницу; следующую страницу запрашивайте с next_page_token.
urlОбязательный- Видео TikTok, к которому относится комментарий: https://www.tiktok.com/@<user>/video/<ID> или ID видео.
comment_idОбязательный- Числовой ID комментария верхнего уровня, ответы на который получает
comment_replies:idзаписи изcomments. page_tokenНеобязательный- Токен страницы для списочных действий TikTok, таких как
hashtag_search,user_search,followingиshop_products. Для первой страницы не передавайте его, затем передавайтеnext_page_tokenиз предыдущего ответа в точности как получили, не меняя остальные параметры. У последней страницы токена нет.
Что означают параметры действия shop_hot_products в API TikTok?
Получите список бестселлеров TikTok Shop для одного рынка Юго-Восточной Азии или Азии: ID, JP, MX, MY (по умолчанию), PH, SG, TH или VN. У каждого товара есть rank, ID, ссылка, название, цена, исходная цена, валюта, число продаж, рейтинг, число отзывов, название магазина и shop_id. Для США, Великобритании и Бразилии списка бестселлеров нет.
countryНеобязательный- Рынок TikTok Shop: ID, JP, MX, MY (по умолчанию), PH, SG, TH или VN. Для США, Великобритании и Бразилии нет списка бестселлеров, поэтому такие запросы отклоняются до списания средств.
Что означают параметры действия shop_category_products в API TikTok?
Получите список товаров TikTok Shop в одной категории по category_id, например 601450 для красоты и личной гигиены, на выбранном рынке. У каждого товара есть ID, ссылка, название, цена, исходная цена, валюта, число продаж, рейтинг, число отзывов, название магазина и shop_id. Около 15 записей на страницу; следующую страницу запрашивайте с next_page_token.
category_idОбязательный- Числовой ID категории TikTok Shop для
shop_category_products, например 601450 (красота и уход за собой). Подходят категории первого, второго и третьего уровня. countryНеобязательный- Рынок TikTok Shop: US (по умолчанию), SG, MY, PH, TH, VN, ID, JP или MX.
page_tokenНеобязательный- Токен страницы для списочных действий TikTok, таких как
hashtag_search,user_search,followingиshop_products. Для первой страницы не передавайте его, затем передавайтеnext_page_tokenиз предыдущего ответа в точности как получили, не меняя остальные параметры. У последней страницы токена нет.
Что означают параметры действия following в API TikTok?
Получите список аккаунтов, на которые подписан пользователь TikTok, по имени пользователя. У каждого аккаунта есть ID пользователя, имя пользователя, отображаемое имя, sec_uid, описание, число подписчиков, подписок, лайков и видео, верификация, аватар и страна. 20 записей на страницу; следующую страницу запрашивайте с next_page_token. Если пользователь скрыл список, возвращается пустой список.
usernameОбязательный- Имя пользователя TikTok, подписки которого нужно получить, например zachking; начальный символ @ удаляется. Также подходит
sec_uid. page_tokenНеобязательный- Токен страницы для списочных действий TikTok, таких как
hashtag_search,user_search,followingиshop_products. Для первой страницы не передавайте его, затем передавайтеnext_page_tokenиз предыдущего ответа в точности как получили, не меняя остальные параметры. У последней страницы токена нет.
Что означают параметры действия video_download в API TikTok?
Получите ссылки для скачивания одного видео TikTok без водяного знака по url. Вы получите video_url с резервными ссылками, размер, ширину и высоту, ссылку в более высоком качестве, если она есть, ссылку с водяным знаком, звук, обложку и expires_at, время, когда ссылки перестанут работать. Для фотопоста вместо этого возвращается image_urls.
urlОбязательный- Одна ссылка на видео TikTok (https://www.tiktok.com/@<user>/video/<ID> или ссылка /photo/) либо ID видео. Короткие ссылки vt.tiktok.com не принимаются.
Что означают параметры действия live_room в API TikTok?
Проверьте по имени пользователя, ведёт ли аккаунт TikTok прямой эфир прямо сейчас. Во время эфира вы получите ID комнаты, название, ссылку, текущее, пиковое и общее число зрителей, лайки, репосты, число товаров, время начала, обложку и ссылку на поток с ограниченным сроком действия. Если аккаунт не в эфире, возвращается одна запись с is_live false.
usernameОбязательный- Имя пользователя TikTok для проверки, например tiktoklive_latam; начальный символ @ удаляется, также подходит ссылка на профиль.
Что означают параметры действия shop_products в API TikTok?
Получите список товаров одного магазина TikTok Shop по shop_id или ссылке на магазин на выбранном рынке. У каждого товара есть ID, ссылка, название, цена, исходная цена, валюта, число продаж, рейтинг, число отзывов, название магазина и shop_id. До 30 товаров на страницу; следующую страницу запрашивайте с next_page_token.
shop_idОбязательный- Числовой ID магазина TikTok Shop для
shop_products:shop_idиз записи о товаре или ссылка на магазин shop.tiktok.com, которая оканчивается этим ID. countryНеобязательный- Рынок TikTok Shop, на котором работает магазин: US (по умолчанию), SG, MY, PH, TH, VN, ID, JP или MX.
page_tokenНеобязательный- Токен страницы для списочных действий TikTok, таких как
hashtag_search,user_search,followingиshop_products. Для первой страницы не передавайте его, затем передавайтеnext_page_tokenиз предыдущего ответа в точности как получили, не меняя остальные параметры. У последней страницы токена нет.
Что означают параметры действия shop_product_reviews в API TikTok?
Получите отзывы покупателей об одном товаре TikTok Shop по product_id или ссылке на товар. У каждого отзыва есть оценка в звёздах rating, текст, время публикации, купленный вариант, флаги подтверждённой покупки и поощрённого отзыва, фото, скрытое имя покупателя и страна. Сортируйте по новизне или рекомендованному порядку; с помощью rating оставляйте отзывы только с одной выбранной оценкой. 20 записей на страницу.
product_idОбязательный- Числовой ID товара TikTok Shop для
shop_product_reviews(idзаписи о товаре) или ссылка на товар shop.tiktok.com. countryНеобязательный- Рынок TikTok Shop, на котором продаётся товар: US (по умолчанию), SG, MY, PH, TH, VN, ID, JP или MX.
page_tokenНеобязательный- Токен страницы для списочных действий TikTok, таких как
hashtag_search,user_search,followingиshop_products. Для первой страницы не передавайте его, затем передавайтеnext_page_tokenиз предыдущего ответа в точности как получили, не меняя остальные параметры. У последней страницы токена нет. ratingНеобязательный- Оставляет в
shop_product_reviewsтолько отзывы с указанным числом звёзд, от 1 до 5. Не передавайте параметр, чтобы получить все отзывы.Допустимые значения:12345 sortНеобязательный- Порядок отзывов:
newest(по умолчанию) илиrecommended(порядок TikTok Shop).Допустимые значения:newestrecommended
Что означают параметры действия trending_hashtags в API TikTok?
Получите трендовые хештеги TikTok для одного рынка за последние 7, 30 или 90 дней, при необходимости для одной отрасли. У каждого хештега есть rank, ID, название, ссылка, число видео, число просмотров и trend, ежедневная популярность от 0 до 100. 20 записей на страницу, всего 100; следующую страницу запрашивайте с next_page_token.
Как использовать API TikTok
- 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":"tiktok","action":"search","params":{"keyword":"<keyword>"}}'
Руководства по API TikTok
Практические примеры и методики на основе этих действий. Сначала сверьтесь с актуальными действиями, параметрами и полями на этой странице: примеры и ограничения из статьи не заменяют актуальный каталог.
API данных об авторах TikTok: предварительный отбор по профилю и выборке видео
Подключите эндпоинты TikTok profile и user_videos, храните снимки аккаунтов и видео отдельно, рассчитывайте вовлечённость по понятным формулам, обрабатывайте пропущенные значения и не трактуйте публичные данные как показатели конверсии.
Читать статьюКак структурировать данные об авторах для проверки перед кампанией: почему число подписчиков не доказывает наличие аудитории
Продукты на данных об авторах не должны выдавать непрозрачные оценки подлинности. В статье разбираем, как публичные метрики, авторизованная аналитика, соответствие контента бренду, требования к раскрытию сотрудничества, небольшие тесты и обратная связь после кампании позволяют проводить проверку перед запуском с опорой на проверяемые данные.
Читать статьюБыстрый старт с единым API данных: от каталога возможностей к первому полученному результату
Получайте данные с разных платформ через platform, action и params: изучите каталог возможностей, выполните минимальные запросы, обработайте асинхронные задачи и частичные результаты, учтите оплату и обеспечьте прослеживаемость записей данных.
Читать статьюВопросы об API TikTok
Какие данные можно получить через API TikTok?
Укажите в platform значение tiktok. В текущем каталоге: поиск, профили, видео пользователя, сведения о видео, комментарии и more. Эти названия действий соответствуют разным объектам или представлениям TikTok; это не взаимозаменяемые режимы поиска.
Есть ли у TikTok официальный API?
TikTok предоставляет официальные API через TikTok for Developers, но Display API и Content Posting API работают только с аккаунтами, владельцы которых авторизовали ваше приложение. Широкий доступ к публичным видео и комментариям даёт Research API, но он открыт только одобренным некоммерческим академическим и исследовательским организациям в поддерживаемых регионах.
Официальные источники: «TikTok for Developers: Research API» · «TikTok for Developers: scopes overview» · Проверено
Нужен ли аккаунт разработчика TikTok или API-ключ?
Нет. Запросы идут через EveryInfra с API-ключом EveryInfra: зарегистрируйтесь, создайте ключ в консоли и передавайте его в заголовке Authorization: Bearer <API_KEY>. Вам не нужно регистрировать приложение разработчика TikTok, запрашивать доступ к API TikTok или входить через аккаунт TikTok. Действия возвращают только публичные данные TikTok.
Сколько стоит TikTok API за 1 000 запросов?
От $0.56 за 1 000 запросов в зависимости от действия; цена каждого действия указана в таблице на этой странице и в публичном каталоге. Подписки нет: вы пополняете баланс в USD и платите за каждый вызов, а неудачные вызовы и пустые результаты не оплачиваются.
Какие входные данные нужны для запроса search к платформе TikTok?
Поисковый запрос для поиска публичных видео в действии search. В shop_search он ищет товары TikTok Shop, которые берутся из отдельного набора данных. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе TikTok?
Объявленная схема включает text, author_name, author_username и like_count. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия TikTok возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.