Подсказки хэштегов TikTok и популярные хэштеги через API
API TikTok for Business предлагает хэштеги через GET /business/hashtag/suggestion/. Запрос принимает ключевое слово на одном из 35 языков и возвращает 10 хэштегов, каждый с числом публикаций, которые его используют, для токена аккаунта TikTok. Популярные хэштеги берутся из GET /discovery/trending_list/: эндпоинт ранжирует топ-200 по стране, отрасли и периоду для токена рекламодателя.
easyCoexistence подключает аккаунты TikTok через API for Business, поэтому ваш собственный код получает подсказки хэштегов с токеном из get_social_credentials, а Claude, ChatGPT или этот код вписывают их в подпись и публикуют или планируют пост через publish_tiktok_post, при круглосуточном мониторинге каждого подключения.
Языки, которые принимает параметр language эндпоинта подсказок, по умолчанию en; подсказки возвращаются на языке ключевого слова.
Количество запросов, которые один авторизованный аккаунт может отправить на один эндпоинт Accounts API, включая подсказки хэштегов.
Значение rank_change для популярного хэштега, которого не было в топ-200 предыдущего периода.
Наибольший период trending_history, то есть ежедневный ранг и просмотры, которые TikTok возвращает для каждого популярного хэштега.
Наибольшее число hashtag_ids, которое /discovery/video_list/ принимает за один вызов, с топ-20 трендовых видео для каждого.
Какие эндпоинты TikTok возвращают хэштеги?
Пять эндпоинтов API for Business в TikTok возвращают хэштеги для органических публикаций. Они различаются токеном, который принимают: собственным токеном аккаунта TikTok или токеном рекламодателя из авторизованного рекламного аккаунта. Шестой, среди инструментов Marketing API, рекомендует хэштеги для таргетинга рекламы:
Как вызвать эндпоинт подсказок?
Это GET-запрос с business_id аккаунта, ключевым словом и, необязательно, language. Его 35 значений идут от en, значения по умолчанию, через es, pt-BR и ja-JP до zh-Hant-TW; TikTok подбирает подсказки под язык ключевого слова. Заголовок Access-Token содержит токен аккаунта TikTok. В справочнике API TikTok эндпоинт относится к разрешению Video Publish из раздела TikTok Accounts, то же самое, что нужно для публикации видео:
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'keyword=summer' \
--data-urlencode 'language=en'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"suggestions": [
{ "name": "summer", "post_count": 65296335 },
{ "name": "summertime", "post_count": 4787632 },
{ "name": "summeroutfit", "post_count": 2245117 }
]
}
}Что содержит каждая подсказка?
Название, хэштег для использования и post_count, общее число публикаций, которые его использовали. TikTok возвращает 10 подсказок: сначала точные совпадения с ключевым словом, затем остальные по числу публикаций. Список не содержит данных о трендах: высокий post_count показывает хэштег, который уже используют многие публикации, и это другой сигнал, нежели растущие позиции, которые показывает /discovery/trending_list/.
Какие токены и разрешения нужны каждому эндпоинту?
Они отличаются сильнее, чем подсказывают пути, поэтому проверьте их перед сборкой:
- /business/hashtag/suggestion/: токен доступа аккаунта TikTok и
business_id; у приложения должно быть разрешение Video Publish из раздела TikTok Accounts. - /discovery/
trending_list/, /discovery/detail/ и /discovery/video_list/: токен доступа рекламодателя иadvertiser_idиз авторизации рекламного аккаунта; у приложения должно быть разрешение Discovery из раздела Creative Management. - /business/mention/
top_hashtag/list/: область biz.brand.insights, для аккаунта с Advanced Access или Verified Business Account. - /tool/hashtag/recommend/: токен рекламодателя и
advertiser_id; в справочнике TikTok для него не указано разрешение.
Что возвращают популярные хэштеги?
GET /discovery/trending_list/ принимает discovery_type со значением HASHTAG, единственным возможным, и необязательные country_code, category_name и date_range. Параметр category_name принимает отрасль первого или второго уровня, например FOOD_AND_BEVERAGE или COOKING. Для каждого хэштега эндпоинт возвращает:
rank_positionвнутри категории иrank_changeотносительно предыдущего периода: положительное значение, если хэштег вырос, отрицательное, если упал, NEW, если его не было в топ-200.- Поля views и posts в выбранной стране и периоде, рядом с
views_global_lifetimeиposts_global_lifetime. top_country_list: пять мест, где хэштег наиболее популярен.trending_history: до 30 днейrank_position_dailyиviews_daily; значение null, если хэштег не был в тренде или набрал меньше 1 000 просмотров за день.
Как изучить один популярный хэштег?
Двумя дополнительными вызовами с тем же токеном рекламодателя. /discovery/detail/ принимает hashtag_id из списка, с теми же country_code и date_range, что и вызов списка, и добавляет hashtag_status: ONLINE, когда хэштег доступен для создания рекламы, и возрастные группы зрителей 18-24, 25-34 и 35+. Они пусты, если статус OFFLINE или ожидаемая аудитория меньше 1 000. /discovery/video_list/ принимает до 10 hashtag_id и возвращает топ-20 трендовых видео для каждого, ранжированных по оценке, которая объединяет просмотры, комментарии, лайки и репосты.
Как AI-ассистент подписывает публикацию подсказками?
С первым шагом в вашем собственном коде. Инструменты easyCoexistence не получают подсказки, поэтому ваш код запрашивает их у TikTok с токеном из get_social_credentials; затем ассистент оставляет подходящие для публикации, вписывает их в подпись со знаком # и публикует через publish_tiktok_post сразу или на заданное время. В справочнике публикации TikTok отмечено, что хэштеги в подписи, отправленной через API, отображаются в приложении как обычный текст:
Что может достать easyCoexistence, а что вне его досягаемости?
get_social_credentials даёт вашему коду токен и business_id аккаунта для путей TikTok под business/. Поэтому подсказки хэштегов работают, как и /business/mention/top_hashtag/list/, где TikTok открывает Mentions API для аккаунта. Эндпоинты Discovery недоступны: они принимают токен рекламодателя и advertiser_id, а не токен аккаунта. Его специализированные инструменты хэштеги не возвращают.
GET https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/
?business_id=<BUSINESS_ID>&keyword=recetas&language=es
Access-Token: <ACCESS_TOKEN>
publish_tiktok_post {
"account_id": "<ACCOUNT_ID>",
"video_url": "https://media.example.com/tiktok/tortilla.mp4",
"caption": "Tortilla en 10 minutos #recetas #recetasfaciles #cocina",
"scheduled_at": "2026-11-12T19:30:00+01:00"
}Распространённые ошибки
- Вставка значений name в подпись как есть. Пример TikTok возвращает названия без знака #, поэтому добавьте его перед каждым.
- Ранжирование подсказок по view_count. TikTok отметил это поле к отключению до 9 октября 2026 года, поэтому ранжируйте по post_count.
- Принятие подсказки с post_count 0 за используемый хэштег. TikTok так возвращает само ключевое слово, когда ему нечего предложить.
- Запрос к /discovery/detail/ с country_code или date_range, отличными от вызова списка. TikTok отвечает ошибкой, а хэштег вне списка даёт пустой ответ.
От US$ 9 до US$ 0,75 за подключение в месяц, по мере добавления подключений, с бесплатным пробным периодом 3 дня.
Часто задаваемые вопросы
Сколько хэштегов может быть в подписи TikTok через API?
В справочниках публикации TikTok нет отдельного лимита на хэштеги: они входят в подпись, которая может быть до 2 200 символов UTF-16 у видеопоста и до 4 000 у фотопоста. Упоминаний @ при этом не больше 30.
Можно ли получить подсказки хэштегов на других языках?
Да. Передайте language вместе с ключевым словом, например pt-BR, es или ja-JP. Подсказки следуют языку ключевого слова, а по умолчанию используется английский.
Может ли аккаунт TikTok получить популярные хэштеги без рекламного аккаунта?
Не через /discovery/trending_list/, который принимает токен рекламодателя. Аккаунт с Advanced Access или Verified Business Account может читать 20 хэштегов, которые чаще всего используют в публикациях, где упоминается сам аккаунт.
Сколько стоит easyCoexistence для аккаунта TikTok?
От US$ 9 до US$ 0,75 за подключение в месяц, по мере добавления подключений, с бесплатным пробным периодом 3 дня. Каждый аккаунт TikTok составляет одно подключение.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на