tiktok/
hashtags

Собирайте публичные видео TikTok по одному или нескольким хештегам и получайте нормализованные данные об авторе, подписи, медиа, звуке, вовлеченности и совпавшем хештеге.

TikTok Hashtags API

Отслеживание кампаний
Контент сообществ
Сравнение хештегов
0,7 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

TikTok Hashtags

Хештеги TikTok — это тематические метки, которые объединяют публичные видео вокруг общей фразы, кампании, события или интереса, с данными об авторах, контенте, медиа, звуке и вовлеченности. Эти записи помогают находить тренды, отслеживать темы, исследовать кампании и анализировать аудиторию.

Возможности TikTok Hashtags API

  • Параллельный сбор по хештегамОтправляйте параллельно несколько хештегов кампаний, брендов или сообществ.
  • Нормализация входных хештеговЗначения #campaign и campaign приводятся к единому формату хештега.
  • Лимиты результатов на каждый хештегПрименяйте results_limit к каждому хештегу отдельно для понятного планирования выборки.
  • Контекст совпавшего хештегаПоле matched_hashtag в каждом видео сохраняет, к какой отправленной группе оно относится.
  • Сопоставимые записи видеоСравнивайте просмотры хештегов, авторов, креативные элементы и вовлеченность видео в единой структуре данных.

Параметры TikTok Hashtags API

ПараметрыОбязательныйОписание
hashtagsОбязательныйОбязательный список явно заданных хештегов; начальный # необязателен.
results_limitНеобязательныйПоложительный лимит запрашиваемых видео на каждый хештег. По умолчанию 100.

Как использовать TikTok Hashtags API

Составьте список хештегов для отслеживания, задайте размер выборки видео для каждого и получите датасет, готовый к сравнению групп.

  1. Соберите хештеги кампаний, брендов или сообществ, приведите space и #space к одному виду и удалите дубли.
  2. Отправьте hashtags и results_limit методом POST на /v1/tiktok/hashtags и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте 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, чтобы понять, каких авторов привлекает каждый хештег.

Помимо 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 с публичными данными других поддерживаемых соцсетей.

TikTok Hashtags API — FAQ

TikTok Hashtags API собирает общедоступные видео по одному или нескольким указанным хештегам TikTok. Он возвращает нормализованные данные о видео, авторе, подписи, медиа, звуке, вовлеченности и совпавшем хештеге.

Укажите названия хештегов в массиве hashtags. Принимаются оба формата, fyp и #fyp, а начальный # нормализуется перед сбором.

Да. hashtags принимает несколько названий хештегов, которые собираются по отдельности в рамках одной асинхронной задачи.

results_limit применяется отдельно к каждому входному хештегу, по умолчанию 100. Для трех хештегов со значением 100 запрашивается до 100 видео по каждому хештегу.

matched_hashtag фиксирует входной хештег, по которому было получено видео, и его можно сопоставлять с публичным числом просмотров хештега для атрибуции и группового анализа.

Результаты содержат ID видео, URL, подпись, время публикации, автора, публичную вовлеченность, хештеги, упоминания, медиа, музыку и время сбора.

Сгруппируйте результаты по matched_hashtag, а затем сравнивайте состав авторов, подписи, музыку, просмотры хештегов и вовлеченность видео между группами.

Каждый возвращенный нормализованный результат видео по хештегу стоит 0,7 кредита.