TikTok Comment Replies
TikTok 댓글 답글은 알고 있는 동영상 댓글 아래에 달린 공개 반응으로, 답글 텍스트, 작성자 정보, 타임스탬프, 공개된 좋아요 수와 답글 수, 부모 댓글 참조를 담고 있습니다. 이러한 대화 레코드는 스레드 재구성, 참여자 검토, 반응 조사, 답글 단위 모니터링에 활용할 수 있습니다.
TikTok Comment Replies API 주요 기능
- 댓글 지정 답글 범위지원되는 TikTok 동영상 URL 하나를 알고 있는 comment_id와 짝지어, 동영상의 최상위 댓글이 아니라 해당 댓글의 공개 답글 피드를 수집합니다.
- 답글, 작성자, 참여 필드답글 ID와 텍스트, 공개 작성자 정보와 계정 속성, 타임스탬프, 공개된 좋아요 수와 답글 수, 멘션, 원본 동영상 맥락을 받습니다.
- 제한된 범위의 중복 제거 순회제공되는 답글 커서를 따라가며 중복된 댓글 ID를 제거하고, 요청한 한도, 스레드의 끝, 100페이지 수집 상한 중 먼저 도달하는 지점에서 멈춥니다.
TikTok Comment Replies API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
url | 필수 | /video/{numeric_id} 경로를 가진 tiktok.com, www.tiktok.com 또는 m.tiktok.com의 TikTok 동영상 URL로, 필수 값입니다. |
comment_id | 필수 | 같은 동영상에서 선택한 최상위 댓글의 공개 댓글 ID로, 비어 있지 않아야 하는 필수 값입니다. |
results_limit | 선택 | 댓글 하나에 대해 요청할 답글의 최대 개수입니다. 기본값은 100이며 20~2,000 범위의 정수를 받습니다. |
TikTok Comment Replies API 사용 방법
TikTok 동영상 하나의 최상위 댓글 ID로 시작해 비동기 답글 작업을 제출하고, 정규화된 레코드를 결과 커서 페이지네이션으로 읽습니다.
- 해당 동영상에 TikTok Comments API를 실행해, 답글이 필요한 최상위 댓글의 id를 선택합니다.
- 같은 동영상 url, 그 comment_id, 선택 사항인 results_limit을 /v1/tiktok/comment-replies로 POST합니다.
- 상태가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- /v1/tasks/{task_id}?limit=50에서 data.results.items를 읽고, results.has_more가 true인 동안 results.next_cursor를 전달합니다.
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는 TikTok Comments 결과 중 최상위 댓글의 정규화된 id에서 가져오고 그 결과의 동영상 URL을 그대로 사용하세요. 동영상 ID는 댓글 ID가 아닙니다.
- 단축 링크, 프로필, 동영상이 아닌 링크가 입력 검사에서 실패하지 않도록, 제출하기 전에 URL 호스트와 숫자 /video/ 경로를 검증하세요.
- 필요한 답글 수에 맞게 results_limit을 설정하세요. 공개 스레드가 한도 전에 끝날 수 있으며, 수집은 원본 100페이지 이후 멈춥니다.
- 여러 작업을 합칠 때는 답글 id 기준으로 중복을 제거하되, 답글이 올바른 대화에 연결되도록 extra.parent_comment_id와 extra.input_url을 함께 보관하세요.
- 답글 텍스트, 작성자 필드, 지표, 멘션, 타임스탬프는 null 허용 값으로 취급하고, 사용자가 작성한 텍스트는 후속 도구에 표시하기 전에 이스케이프하세요.
관련 API
TikTok Comment Replies API 외에 TikTok의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- 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