TikTok Comments
TikTok 댓글은 동영상에 달린 공개 반응으로, 텍스트와 작성자 정보, 공개된 좋아요 수, 답글 수, 멘션, 크리에이터 상호작용 신호를 담고 있습니다. 이러한 대화는 오디언스 피드백 분석, 반복되는 주제 조사, 감성 검토, 콘텐츠 반응 모니터링에 활용할 수 있습니다.
TikTok Comments API 주요 기능
- 여러 동영상의 댓글 수집TikTok 동영상 URL 여러 개를 한 번의 요청으로 보내 공개된 최상위 댓글을 수집합니다.
- 추적 가능한 댓글 레코드댓글 ID, 원본 동영상, 작성자, 게시 시각을 함께 제공하므로 피드백의 출처를 추적할 수 있습니다.
- 댓글 텍스트와 멘션댓글 텍스트와 멘션을 추출해 주제, 감성, 니즈 분석에 활용할 수 있습니다.
- 공개된 상호작용 신호댓글마다 공개된 좋아요 수, 답글 수, 고정 여부, 크리에이터 좋아요 여부를 함께 담습니다.
- 동영상별 결과 수 제한results_limit 값으로 동영상마다 표본 크기를 정할 수 있습니다.
TikTok Comments API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 공개된 최상위 댓글을 수집할 TikTok 동영상 URL의 목록으로, 필수 값입니다. |
results_limit | 선택 | 동영상 URL마다 요청할 최상위 댓글 수의 상한으로, 양수여야 합니다. 기본값은 100입니다. |
TikTok Comments API 사용 방법
분석할 동영상과 동영상별 댓글 표본 크기를 정한 뒤, 오디언스 피드백 수집을 시작합니다.
- 콘텐츠 표본을 고르고 동영상별 results_limit 값을 정합니다.
- urls와 results_limit을 /v1/tiktok/comments로 POST하고, 반환된 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 trueTikTok Comments API 추천 활용 사례
- 고객의 소리(VoC) 조사: 오디언스가 쓰는 표현 그대로 반복되는 니즈, 질문, 칭찬, 제안을 찾아냅니다.
- 토론 검토 대기열: 댓글 텍스트, 공개된 좋아요 수, 답글 수를 기준으로 고객 지원, 조사, 소셜 리스닝 검토용 댓글을 정리합니다.
- 크리에이티브 반응 분석: 동영상별 반응을 비교해 공감, 논쟁, 대화를 이끌어내는 아이디어를 찾습니다.
- 크리에이터 상호작용 검토: 고정 댓글, 크리에이터 좋아요, 답글 수를 살펴보며 크리에이터가 댓글 영역을 어떻게 이끌어 가는지 파악합니다.
TikTok Comments API 활용 팁
- 동영상의 중요도에 따라 results_limit 값을 배분하고, 여기에 URL 개수를 곱해 배치 규모를 예상하세요.
- likes_count는 공감의 정도로, replies_count는 논의의 깊이로 보고 각각 별도로 분석하세요.
- is_pinned와 creator_liked는 크리에이터가 직접 부각한 피드백을 가리키는 신호로 활용하세요.
- 댓글 id 기준으로 중복을 제거하고, 출처를 분명히 하도록 동영상 URL과 collected_at을 함께 보관하세요.
- 댓글 텍스트를 대시보드, 티켓, 보고서에 넣기 전에 이스케이프 처리하고, 검토를 위해 원문도 보관하세요.
- 상호작용 신호로 검토 순서를 정한 뒤, 원본 댓글 텍스트를 주제나 감성별로 분류하세요.
관련 API
TikTok Comments API 외에 TikTok의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- TikTok Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 계정 속성, 오디언스 수치를 가져옵니다.
- TikTok Hashtags API — 지정한 해시태그의 공개 동영상, 크리에이터, 미디어, 사운드, 참여도를 수집합니다.
- TikTok Videos API — 동영상 URL에서 크리에이터, 캡션, 미디어, 음악, 태그, 멘션, 참여도를 가져옵니다.
- TikTok Search API — 키워드로 공개 동영상을 검색하며, 지원되는 정렬 및 게시 기간 필터를 사용할 수 있습니다.
- TikTok Comment Replies API — TikTok 동영상 URL과 댓글 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