TikTok Video Transcript
TikTok Video Transcript 레코드에는 공개 동영상에서 확인 가능한 음성이나 자막이 언어, 일반 텍스트 또는 WebVTT 형식, 출처 URL, 숏코드, 수집 시각과 함께 담겨 있습니다. 이러한 레코드는 음성 콘텐츠 검색, 키워드·주제 분석, 접근성 검토, 출처 링크가 있는 인용 조사에 활용할 수 있습니다.
TikTok Video Transcript API 주요 기능
- 여러 URL의 스크립트 조회공개 TikTok 동영상 URL을 하나의 작업으로 하나 이상 처리하며, 조회마다 선택 사항인 언어 선호도를 함께 전달할 수 있습니다.
- 정규화된 텍스트와 출처 정보스크립트 텍스트를 언어, 일반 텍스트 또는 WebVTT 형식, 출처 URL, 레코드 ID, 숏코드, 수집 시각과 함께 일관된 구조로 반환합니다.
- 확인된 스크립트만 반환원본이 비어 있지 않은 스크립트 텍스트를 반환했을 때만 결과를 내보내므로, 응답에는 자리표시용 행 없이 확인 가능한 스크립트만 구분되어 담깁니다.
TikTok Video Transcript API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 조회 가능한 공개 TikTok 동영상 URL을 하나 이상 쉼표 또는 줄바꿈으로 구분해 입력합니다. |
language | 선택 | 선호하는 스크립트 언어이며 선택 사항입니다. en, es, fr 같은 두 글자 코드를 사용하세요. |
TikTok Video Transcript API 사용 방법
알고 있는 공개 TikTok 동영상 URL을 비동기 작업으로 제출하고 작업 ID를 폴링한 뒤, 정규화된 스크립트 레코드를 요청한 출처와 대조합니다.
- 조회 가능한 공개 TikTok 동영상 URL을 하나 이상 준비하고, 필요하면 en 같은 두 글자 언어 코드도 준비합니다.
- urls와 선택 사항인 language를 /v1/tiktok/video-transcript로 POST하고, 반환된 task_id를 저장합니다.
- status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다. 성공하더라도 제출한 URL보다 레코드가 적을 수 있습니다.
- data.results.items를 읽고, 각 url을 입력 목록과 대조하며, results.has_more가 true인 동안 results.next_cursor로 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/tiktok/video-transcript" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.tiktok.com/@stoolpresidente/video/7499229683859426602"],"language":"en"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueTikTok Video Transcript API 추천 활용 사례
- 검색 가능한 음성 콘텐츠 아카이브: 스크립트 텍스트를 출처 URL, 언어, 형식, 숏코드, 수집 시각과 함께 색인해, 선택한 공개 동영상을 음성에 나온 단어로 검색할 수 있게 합니다.
- 키워드·주제 분석: 알고 있는 동영상 세트의 정규화된 텍스트를 분석해 반복되는 단어, 구절, 주제를 찾고, 검토용 출처 링크도 함께 보관합니다.
- 접근성 및 인용 검토: 확인된 스크립트 텍스트와 형식 메타데이터로 읽기 쉬운 사본을 준비하거나 구절을 찾은 뒤, 연결된 공개 동영상과 대조해 검증합니다.
TikTok Video Transcript API 활용 팁
- 요청은 TikTok 호스트나 /video/{id} 경로를 강제하지 않고 비어 있지 않은 URL 문자열을 받으므로, 제출하기 전에 모든 대상이 의도한 공개 TikTok 동영상으로 연결되는지 확인하세요.
- 공백 제거와 중복 제거는 제출한 문자열이 완전히 같을 때만 합쳐 주므로, 일괄 요청 전에 URL을 정규화하고 추적용 변형을 제거하세요.
- 언어를 지정할 때는 en 같은 두 글자 코드를 사용하고, 선호도가 반영되었다고 가정하지 말고 반환된 language 필드를 기준으로 후속 처리를 분기하세요.
- 성공 후 반환된 url 값을 제출한 목록과 비교해, 사용 불가, 비공개, 삭제, 제한, 자막 없음, 음성 없음 동영상이 워크플로에서 계속 확인되도록 하세요.
- format에 따라 파싱을 나누고, WebVTT 큐가 있으면 보존하며, created_at에는 동영상 게시 시각이 들어 있지 않으므로 이력 추적에는 collected_at을 사용하세요.
관련 API
TikTok Video Transcript API 외에 TikTok의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- TikTok Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 계정 속성, 오디언스 수치를 가져옵니다.
- TikTok Comments API — 공개된 최상위 댓글, 작성자, 참여도, 멘션, 크리에이터 상호작용 플래그를 수집합니다.
- TikTok Videos API — 동영상 URL에서 크리에이터, 캡션, 미디어, 음악, 태그, 멘션, 참여도를 가져옵니다.
- TikTok User Videos API — 사용자 이름으로 공개 프로필 피드 동영상을 수집하며, 캡션, 크리에이터, 미디어, 타임스탬프, 참여도, 출처 계정 맥락을 포함합니다.
- TikTok Trending Feed API — 지역별 현재 공개 동영상 피드를 수집하며, 크리에이터, 캡션, 커버, 타임스탬프, 공개된 참여도 필드를 포함합니다.
- TikTok Song API — 클립 ID 또는 음악 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 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
- TikTok Comment Keywords API