TikTok Comments
Комментарии TikTok — это публичные реакции на видео с текстом, данными об авторе, видимым числом лайков и ответов, упоминаниями и сигналами взаимодействия со стороны автора видео. Эти обсуждения помогают анализировать отзывы аудитории, исследовать повторяющиеся темы, оценивать тональность и отслеживать реакцию на контент.
Возможности TikTok Comments API
- Сбор комментариев с нескольких видеоСобирайте публичные комментарии верхнего уровня по нескольким прямым URL видео TikTok в одном запросе.
- Отслеживаемые записи комментариевСохраняйте происхождение каждого отзыва через ID комментария, исходное видео, автора и время публикации.
- Текст комментариев и упоминанияИзвлекайте текст комментариев и упоминания для анализа тем, тональности и потребностей.
- Публичные сигналы взаимодействияКаждая запись комментария содержит видимое число лайков и ответов, статус закрепления и отметку лайка от автора видео.
- Лимиты результатов на каждое видеоРаспределяйте размер выборки по видео с помощью results_limit.
Параметры TikTok Comments API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательный список прямых URL видео TikTok, по которым собираются публичные комментарии верхнего уровня. |
results_limit | Необязательный | Положительный лимит запрашиваемых комментариев верхнего уровня на каждый URL видео. По умолчанию 100. |
Как использовать TikTok Comments API
Выберите видео для изучения и размер выборки комментариев для каждого из них, а затем запустите сбор отзывов аудитории.
- Отберите контент для выборки и запланируйте results_limit для каждого видео.
- Отправьте urls и results_limit методом POST на /v1/tiktok/comments и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте 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, чтобы происхождение данных было прозрачным.
- Экранируйте текст комментариев перед выводом в аналитические панели, тикеты или отчеты и сохраняйте исходный текст для проверки.
- Используйте сигналы взаимодействия, чтобы задать порядок просмотра, а затем классифицируйте исходный текст комментариев по темам или тональности.
Связанные API
Помимо 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 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