TikTok Comments
TikTok Comments are public responses to videos, with text, author context, visible likes, reply counts, mentions, and creator interaction signals. These conversations support audience feedback analysis, recurring-theme research, sentiment review, and content-response monitoring.
Features
- Multi-video comment collectionCollect public top-level comments across multiple direct TikTok video URLs in one request.
- Traceable comment recordsKeep feedback traceable through comment ID, source video, author, and publication time.
- Comment text and mentionsExtract comment text and mentions for topic, sentiment, and needs analysis.
- Public interaction signalsInclude visible likes, reply counts, pin status, and creator-like status with each comment record.
- Per-video result limitsAllocate sample size per video through results_limit.
Parameters
| Parameters | Required | Description |
|---|---|---|
urls | Required | Required list of direct TikTok video URLs used to collect public top-level comments. |
results_limit | Optional | Positive requested top-level comment limit per video URL. Defaults to 100. |
How to Use
Choose the videos to study and the comment sample size for each, then start collecting audience feedback.
- Select the content sample and plan a results_limit for each video.
- POST urls and results_limit to /v1/tiktok/comments and save the returned task_id.
- Poll /v1/tasks/{task_id} until the task succeeds or fails.
- Read data.results.items. When has_more is true, continue with 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 trueBest Use Cases
- Voice-of-customer research: Find recurring needs, questions, praise, and suggestions in audience language.
- Discussion review queues: Use comment text, visible likes, and reply counts to organize comments for support, research, or listening review.
- Creative response analysis: Compare reactions across videos to find the ideas that drive resonance, debate, or conversation.
- Creator interaction review: Study pins, creator likes, and reply counts to understand how creators shape their comment sections.
Pro Tips
- Allocate results_limit by video importance, then multiply by the URL count to estimate batch size.
- Treat likes_count as recognition and replies_count as discussion depth in separate analyses.
- Use is_pinned and creator_liked as signals of feedback the creator actively amplified.
- Deduplicate by comment id and retain the video URL and collected_at for clear provenance.
- Escape comment text before placing it in dashboards, tickets, or reports, and retain the source text for review.
- Use interaction signals to create a review order, then classify the original comment text by theme or sentiment.
Related APIs
Use these APIs when you need a different type of public TikTok data.
- TikTok Profiles API — Retrieve public profile identity, biographies, account flags, and audience counts by username.
- TikTok Hashtags API — Collect public videos, creators, media, sound, and engagement for specified hashtags.
- TikTok Videos API — Retrieve creator, caption, media, music, tags, mentions, and engagement from video URLs.
- TikTok Search API — Search public videos by keyword with supported sorting and publication filters.
- TikTok Comment Replies API — Collect public replies for a known comment using its TikTok video URL and comment ID, with authors, engagement, timestamps, and parent context.
- TikTok Followers List API — Collect normalized profiles visible in public follower lists, with retained source context and supported metrics.
- TikTok Following List API — Collect public profiles followed by TikTok accounts with normalized identity, biographies, visible metrics, and source-account context.
- TikTok User Videos API — Collect public profile-feed videos by username with captions, creators, media, timestamps, engagement, and source-account context.
- TikTok Live Room Info API — Look up one known live room by paired room and owner IDs, returning status, owner context, cover media, and audience counts.
- TikTok Trending Feed API — Collect the current public video feed for a region with creator, caption, cover, timestamp, and visible engagement fields.
- TikTok Video Transcript API — Extract available transcript text, language, format, and source context from public video URLs.