tiktok/
comment-replies

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

TikTok Comment Replies API

Ответы на известный комментарий
Данные об авторе
Ссылка на родительский комментарий
0,5 кредита за результат
Готово
Готово

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

README

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

TikTok Comment Replies

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

Возможности TikTok Comment Replies API

  • Ответы на конкретный комментарийУкажите один поддерживаемый URL видео TikTok вместе с известным comment_id, чтобы собрать публичную ленту ответов на этот комментарий, а не комментарии верхнего уровня к видео.
  • Поля ответа, автора и вовлеченностиПолучайте ID и текст ответов, публичные данные об авторе и признаки аккаунта, метки времени, видимое число лайков и ответов, упоминания и контекст исходного видео.
  • Ограниченный обход без дубликатовПереходит по доступным курсорам ответов, удаляет повторяющиеся ID комментариев и останавливается на запрошенном лимите, в конце ветки или на пределе сбора в 100 страниц.

Параметры TikTok Comment Replies API

ПараметрыОбязательныйОписание
urlОбязательныйОбязательный URL видео TikTok на tiktok.com, www.tiktok.com или m.tiktok.com с путем /video/{numeric_id}.
comment_idОбязательныйОбязательный непустой публичный ID выбранного комментария верхнего уровня к тому же видео.
results_limitНеобязательныйМаксимальное число ответов, запрашиваемых для комментария; по умолчанию 100, допускаются целые числа от 20 до 2 000.

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

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

  1. Запустите TikTok Comments API для видео и выберите id комментария верхнего уровня, ответы на который вам нужны.
  2. Отправьте тот же url видео, этот comment_id и необязательный results_limit методом POST на /v1/tiktok/comment-replies.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  4. Читайте data.results.items из /v1/tasks/{task_id}?limit=50 и передавайте results.next_cursor, пока results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/tiktok/comment-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.tiktok.com/@loganpaul/video/7411198650782731563","comment_id":"7411205662439736097","results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then read data.results.items and follow results.next_cursor.

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

  • Восстановление ветки известного комментария: Связывайте ID ответов, extra.parent_comment_id и extra.input_url, чтобы восстановить публичную ветку ответов под одним выбранным комментарием верхнего уровня.
  • Анализ реакций на уровне ответов: Используйте текст ответов, метки времени, видимое число лайков и ответов, чтобы изучать и сравнивать публичные реакции в рамках конкретного обсуждения.
  • Карта участников обсуждения: Используйте публичные ID авторов, имена пользователей, ссылки на профили, аватары и признаки аккаунтов, чтобы составить карту участников из полученной ленты ответов.

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

  • Берите comment_id из нормализованного id результата TikTok Comments верхнего уровня и используйте URL видео из того же результата; ID видео — это не ID комментария.
  • Перед отправкой проверяйте хост URL и числовой путь /video/, чтобы короткие ссылки, ссылки на профили и не ведущие на видео ссылки не проваливали проверку входных данных.
  • Задавайте results_limit по нужному объему ответов, учитывая, что публичная ветка может закончиться раньше лимита, а сбор останавливается после 100 страниц источника.
  • При объединении задач удаляйте дубли по id ответа, сохраняя extra.parent_comment_id и extra.input_url, чтобы ответы оставались привязанными к нужному обсуждению.
  • Считайте, что текст ответа, поля автора, метрики, упоминания и метки времени могут быть null, и экранируйте пользовательский текст перед показом в своих инструментах.

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

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

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

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

TikTok Comment Replies API — FAQ

TikTok Comment Replies API — это программный интерфейс для сбора публичных ответов под одним известным комментарием к видео TikTok по URL видео и ID комментария. Он возвращает нормализованный текст ответов, данные об авторах, метки времени, видимую вовлеченность и контекст родительского комментария.

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

Используйте URL на tiktok.com, www.tiktok.com или m.tiktok.com, путь которого содержит /video/ и числовой ID видео. Короткая ссылка, URL профиля или URL видео без непустого comment_id не соответствуют спецификации запроса.

Запись может содержать ID и текст ответа, URL исходного видео, публичные данные об авторе и признаки аккаунта, число лайков и ответов, упоминания, created_at, collected_at, extra.parent_comment_id и extra.input_url.

results_limit — это максимум, а не гарантия. Сбор может завершиться, когда публичная лента ответов заканчивается, новые уникальные ID ответов перестают поступать, лента перестает продвигать курсор или достигнут предел в 100 страниц.

Каждый сохраненный нормализованный ответ стоит 0,5 кредита, базовой платы за задачу нет. Первоначальная оценка рассчитывается по results_limit или по значению по умолчанию 100, а итоговое списание зависит от фактически сохраненных записей; если ответы не сохранены, плата за результаты не взимается.