tiktok/
comments

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

TikTok Comments API

Голос аудитории
Исследование отзывов
Приоритет комментариев
0,25 кредита за результат
Готово
Готово

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

README

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

TikTok Comments

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

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

  • Сбор комментариев с нескольких видеоСобирайте публичные комментарии верхнего уровня по нескольким прямым URL видео TikTok в одном запросе.
  • Отслеживаемые записи комментариевСохраняйте происхождение каждого отзыва через ID комментария, исходное видео, автора и время публикации.
  • Текст комментариев и упоминанияИзвлекайте текст комментариев и упоминания для анализа тем, тональности и потребностей.
  • Публичные сигналы взаимодействияКаждая запись комментария содержит видимое число лайков и ответов, статус закрепления и отметку лайка от автора видео.
  • Лимиты результатов на каждое видеоРаспределяйте размер выборки по видео с помощью results_limit.

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

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

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

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

  1. Отберите контент для выборки и запланируйте results_limit для каждого видео.
  2. Отправьте urls и results_limit методом POST на /v1/tiktok/comments и сохраните возвращенный 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/comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.tiktok.com/@nasa/video/7412345678901234567"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Сценарии использования TikTok Comments API

  • Исследование голоса клиента: Находите повторяющиеся потребности, вопросы, похвалу и предложения, сформулированные словами самой аудитории.
  • Очереди на разбор обсуждений: Используйте текст комментариев, видимое число лайков и ответов, чтобы распределять комментарии для поддержки, исследований или мониторинга.
  • Анализ реакции на креатив: Сравнивайте реакции на разные видео, чтобы находить идеи, которые вызывают отклик, споры или обсуждение.
  • Анализ взаимодействия авторов: Изучайте закрепления, лайки от авторов видео и число ответов, чтобы понять, как авторы формируют свои разделы комментариев.

Практические советы по TikTok Comments API

  • Распределяйте results_limit по важности видео, а затем умножайте на число URL, чтобы оценить размер пакета.
  • В отдельных анализах трактуйте likes_count как признание, а replies_count как глубину обсуждения.
  • Используйте is_pinned и creator_liked как сигналы отзывов, которые автор видео активно продвигал.
  • Удаляйте дубли по id комментария и сохраняйте URL видео и collected_at, чтобы происхождение данных было прозрачным.
  • Экранируйте текст комментариев перед выводом в аналитические панели, тикеты или отчеты и сохраняйте исходный текст для проверки.
  • Используйте сигналы взаимодействия, чтобы задать порядок просмотра, а затем классифицируйте исходный текст комментариев по темам или тональности.

Помимо TikTok Comments API, используйте эти API, когда нужен другой тип публичных данных TikTok.

  • TikTok Profiles API — Получайте по имени пользователя публичные данные профиля, описание, признаки аккаунта и счетчики аудитории.
  • TikTok Hashtags API — Собирайте публичные видео, авторов, медиа, звук и вовлеченность по заданным хештегам.
  • TikTok Videos API — Получайте по URL видео автора, подпись, медиа, музыку, теги, упоминания и вовлеченность.
  • TikTok Search API — Ищите публичные видео по ключевому слову с поддерживаемой сортировкой и фильтрами по дате публикации.
  • TikTok Comment Replies API — Собирайте публичные ответы на известный комментарий по URL видео TikTok и ID комментария: авторы, вовлеченность, метки времени и родительский контекст.
  • TikTok Comment Keywords API — Находите ключевые слова, которые чаще всего встречаются в комментариях к видео, вместе с самими комментариями.

Другие платформы

Объединяйте данные TikTok с публичными данными других поддерживаемых соцсетей.

TikTok Comments API — FAQ

TikTok Comments API собирает публично видимые комментарии верхнего уровня по прямым URL видео TikTok. Он возвращает нормализованный текст, данные об авторах, число лайков и ответов, упоминания и признаки взаимодействия автора видео; текст ответов не включается.

Отправьте один или несколько прямых URL видео TikTok в массиве urls и задайте через results_limit запрашиваемое число комментариев на каждое видео.

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

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

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

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

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

Каждый возвращенный нормализованный комментарий стоит 0,25 кредита.