TikTok Videos
TikTok 동영상은 캡션, 크리에이터 정보, 미디어, 음악, 재생 시간, 해시태그, 멘션, 게시 정보, 공개된 참여도를 담은 숏폼 게시물입니다. 이러한 콘텐츠 신호는 트렌드 조사, 크리에이티브 분석, 캠페인 검토, 성과 비교에 활용할 수 있습니다.
TikTok Videos API 주요 기능
- 동영상 URL 일괄 조회TikTok 동영상 링크 여러 개를 일관된 콘텐츠 레코드로 변환합니다.
- 변하지 않는 동영상 식별 정보동영상 ID와 정식 URL로 동영상의 정체와 출처를 확인합니다.
- 콘텐츠 및 크리에이터 필드캡션, 언어, 게시 시각, 크리에이터, 재생 시간, 커버 정보를 추출합니다.
- 크리에이티브 맥락 필드해시태그, 멘션, 음악, 콘텐츠 플래그를 크리에이티브 분석에 활용할 수 있습니다.
- 특정 시점의 지표공개된 참여도 수치를 collected_at과 함께 담아 성과 스냅샷을 만듭니다.
TikTok Videos API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 현재 공개적으로 접근할 수 있는 TikTok 동영상 URL의 목록으로, 필수 값입니다. |
TikTok Videos API 사용 방법
북마크, 보고서, 내부 시스템에 있는 링크를 분석에 바로 쓸 수 있는 동영상 목록으로 바꿉니다.
- 동영상 링크를 모으고 URL 형식을 정규화한 뒤 목록의 중복을 제거합니다.
- urls 배열을 /v1/tiktok/videos로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 succeeded 또는 failed 상태가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽습니다. has_more가 true이면 next_cursor로 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/tiktok/videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.tiktok.com/@nasa/video/7412345678901234567"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueTikTok Videos API 추천 활용 사례
- 콘텐츠 패턴 분석: 캡션, 해시태그, 멘션, 음악, 재생 시간을 조합해 선택한 동영상 전반에서 반복되는 요소를 비교합니다.
- 캠페인 동영상 리포팅: 선택한 에셋 세트의 조회수와 참여도를 수집해 캠페인 성과를 일관되게 비교합니다.
- 동영상 에셋 카탈로그: 동영상 ID, 정식 URL, 커버, 크리에이터, 게시 시각으로 콘텐츠를 색인해 빠르게 찾을 수 있게 합니다.
- 주제·형식 태깅: 언어, 캡션, 해시태그, 음악으로 주제, 형식, 의도한 타깃 오디언스를 분류합니다.
TikTok Videos API 활용 팁
- 중복된 에셋은 id 기준으로 병합하고, 검토와 원본 이동을 위해 url을 보관하세요.
- published_at은 게시 시각으로, collected_at은 지표 스냅샷 시각으로 구분해서 저장하세요.
- caption, hashtags, mentions, music을 조합해 검색 가능한 콘텐츠 특성으로 만드세요.
- views가 있고 0보다 클 때, 이를 좋아요·댓글·공유 비율의 분모로 사용하세요.
- 같은 동영상 ID로 Comments 레코드를 조인하면 에셋 성과를 오디언스 반응과 비교할 수 있습니다.
- 참여도 스냅샷이 의미를 갖도록 비교할 세트는 시간적으로 가까운 시점에 수집하세요.
관련 API
TikTok Videos API 외에 TikTok의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- TikTok Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 계정 속성, 오디언스 수치를 가져옵니다.
- TikTok Comments API — 공개된 최상위 댓글, 작성자, 참여도, 멘션, 크리에이터 상호작용 플래그를 수집합니다.
- TikTok User Videos API — 사용자 이름으로 공개 프로필 피드 동영상을 수집하며, 캡션, 크리에이터, 미디어, 타임스탬프, 참여도, 출처 계정 맥락을 포함합니다.
- TikTok Trending Feed API — 지역별 현재 공개 동영상 피드를 수집하며, 크리에이터, 캡션, 커버, 타임스탬프, 공개된 참여도 필드를 포함합니다.
- TikTok Video Transcript API — 공개 동영상 URL에서 제공되는 스크립트 텍스트, 언어, 형식, 출처 맥락을 추출합니다.
- TikTok Fake Views Checker API — 동영상 URL의 가짜 조회수 위험을 점수로 매기며, 추정 가짜 조회수와 트래픽 단계를 포함합니다.
- TikTok Hashtags API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info 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 Comment Keywords API