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, отправьте асинхронную задачу сбора ответов и читайте нормализованные записи с курсорной пагинацией результатов.
- Запустите TikTok Comments API для видео и выберите id комментария верхнего уровня, ответы на который вам нужны.
- Отправьте тот же url видео, этот comment_id и необязательный results_limit методом POST на /v1/tiktok/comment-replies.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- Читайте 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, и экранируйте пользовательский текст перед показом в своих инструментах.
Связанные API
Помимо 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 Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Live Room Info API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users 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 Hashtag Views 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