TikTok Hashtags
Хештеги TikTok — это тематические метки, которые объединяют публичные видео вокруг общей фразы, кампании, события или интереса, с данными об авторах, контенте, медиа, звуке и вовлеченности. Эти записи помогают находить тренды, отслеживать темы, исследовать кампании и анализировать аудиторию.
Возможности TikTok Hashtags API
- Параллельный сбор по хештегамОтправляйте параллельно несколько хештегов кампаний, брендов или сообществ.
- Нормализация входных хештеговЗначения #campaign и campaign приводятся к единому формату хештега.
- Лимиты результатов на каждый хештегПрименяйте results_limit к каждому хештегу отдельно для понятного планирования выборки.
- Контекст совпавшего хештегаПоле matched_hashtag в каждом видео сохраняет, к какой отправленной группе оно относится.
- Сопоставимые записи видеоСравнивайте просмотры хештегов, авторов, креативные элементы и вовлеченность видео в единой структуре данных.
Параметры TikTok Hashtags API
| Параметры | Обязательный | Описание |
|---|---|---|
hashtags | Обязательный | Обязательный список явно заданных хештегов; начальный # необязателен. |
results_limit | Необязательный | Положительный лимит запрашиваемых видео на каждый хештег. По умолчанию 100. |
Как использовать TikTok Hashtags API
Составьте список хештегов для отслеживания, задайте размер выборки видео для каждого и получите датасет, готовый к сравнению групп.
- Соберите хештеги кампаний, брендов или сообществ, приведите space и #space к одному виду и удалите дубли.
- Отправьте hashtags и results_limit методом POST на /v1/tiktok/hashtags и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте data.results.items. Если has_more равно true, продолжайте с next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok/hashtags" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtags":["space","#astronomy"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования TikTok Hashtags API
- Отслеживание UGC-кампаний: Собирайте участие в официальных хештегах кампаний и изучайте охват авторов, направление контента и распределение вовлеченности.
- Библиотеки контента по брендовым хештегам: Превращайте видео с хештегами брендов и товаров в библиотеку с поиском для маркетинговых и SMM-команд.
- Профили сообществ по интересам: Используйте данные об авторах, подписи, музыку и вовлеченность, чтобы понять культуру контента вокруг тематического хештега.
- Сравнение групп хештегов: Собирайте несколько хештегов параллельно и сравнивайте состав авторов, креативные элементы и результативность между группами.
Практические советы по TikTok Hashtags API
- Удаляйте начальный #, приводите регистр к единому виду и убирайте дубли, чтобы у каждого хештега была четкая группа выборки.
- Используйте число хештегов, умноженное на results_limit, как запрашиваемый максимум, а не как гарантированное итоговое число результатов.
- Сохраняйте matched_hashtag, чтобы у видео, собранных через несколько групп, сохранялось полное происхождение.
- При сравнении групп хештегов используйте одинаковый results_limit и одинаковое время сбора.
- Считайте число просмотров хештега и метрики вовлеченности каждого видео отдельными значениями на момент сбора.
- Обогащайте данные о часто встречающихся авторах через Profiles, чтобы понять, каких авторов привлекает каждый хештег.
Связанные API
Помимо TikTok Hashtags API, используйте эти API, когда нужен другой тип публичных данных TikTok.
- TikTok Comments API — Собирайте публичные комментарии верхнего уровня, авторов, вовлеченность, упоминания и признаки взаимодействия с автором видео.
- TikTok Videos API — Получайте по URL видео автора, подпись, медиа, музыку, теги, упоминания и вовлеченность.
- TikTok Search API — Ищите публичные видео по ключевому слову с поддерживаемой сортировкой и фильтрами по дате публикации.
- TikTok Live Room Info API — Получайте данные об одном известном прямом эфире по паре ID эфира и владельца: статус, контекст владельца, обложка и число зрителей.
- TikTok Search Users API — Ищите публичные аккаунты TikTok по ключевому слову.
- TikTok Hashtag Views API — Узнавайте общее число видео и просмотров по хештегам — до 20 хештегов за один запрос.
- TikTok Profiles API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API