tiktok/
video-transcript

공개 TikTok 동영상 URL에서 선택 언어로 스크립트를 추출하고, 텍스트, 언어, 형식, 출처 링크, 수집 시각을 정규화된 레코드로 반환합니다.

TikTok Video Transcript API

동영상 스크립트
선택 언어
일반 텍스트 또는 WebVTT
결과당 0.5 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

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를 폴링한 뒤, 정규화된 스크립트 레코드를 요청한 출처와 대조합니다.

  1. 조회 가능한 공개 TikTok 동영상 URL을 하나 이상 준비하고, 필요하면 en 같은 두 글자 언어 코드도 준비합니다.
  2. urls와 선택 사항인 language를 /v1/tiktok/video-transcript로 POST하고, 반환된 task_id를 저장합니다.
  3. status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다. 성공하더라도 제출한 URL보다 레코드가 적을 수 있습니다.
  4. 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 true

TikTok Video Transcript API 추천 활용 사례

  • 검색 가능한 음성 콘텐츠 아카이브: 스크립트 텍스트를 출처 URL, 언어, 형식, 숏코드, 수집 시각과 함께 색인해, 선택한 공개 동영상을 음성에 나온 단어로 검색할 수 있게 합니다.
  • 키워드·주제 분석: 알고 있는 동영상 세트의 정규화된 텍스트를 분석해 반복되는 단어, 구절, 주제를 찾고, 검토용 출처 링크도 함께 보관합니다.
  • 접근성 및 인용 검토: 확인된 스크립트 텍스트와 형식 메타데이터로 읽기 쉬운 사본을 준비하거나 구절을 찾은 뒤, 연결된 공개 동영상과 대조해 검증합니다.

TikTok Video Transcript API 활용 팁

  • 요청은 TikTok 호스트나 /video/{id} 경로를 강제하지 않고 비어 있지 않은 URL 문자열을 받으므로, 제출하기 전에 모든 대상이 의도한 공개 TikTok 동영상으로 연결되는지 확인하세요.
  • 공백 제거와 중복 제거는 제출한 문자열이 완전히 같을 때만 합쳐 주므로, 일괄 요청 전에 URL을 정규화하고 추적용 변형을 제거하세요.
  • 언어를 지정할 때는 en 같은 두 글자 코드를 사용하고, 선호도가 반영되었다고 가정하지 말고 반환된 language 필드를 기준으로 후속 처리를 분기하세요.
  • 성공 후 반환된 url 값을 제출한 목록과 비교해, 사용 불가, 비공개, 삭제, 제한, 자막 없음, 음성 없음 동영상이 워크플로에서 계속 확인되도록 하세요.
  • format에 따라 파싱을 나누고, WebVTT 큐가 있으면 보존하며, created_at에는 동영상 게시 시각이 들어 있지 않으므로 이력 추적에는 collected_at을 사용하세요.

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 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

TikTok Video Transcript API — 자주 묻는 질문

TikTok Video Transcript API는 공개 TikTok 동영상 URL 하나 이상에서 선택 언어 선호도에 맞춰 확인 가능한 스크립트 텍스트를 추출하는 프로그래밍 인터페이스입니다. 비어 있지 않은 스크립트 텍스트가 있으면 정규화된 텍스트, 언어, 일반 텍스트 또는 WebVTT 형식, 출처 URL, 숏코드, 수집 시각을 반환합니다.

비어 있지 않은 urls 배열을 제출하고, 필요하면 language 문자열을 추가합니다. 이 엔드포인트는 results_limit, usernames, 검색어, 미디어 다운로드 설정, AI 폴백 스위치를 받지 않습니다.

레코드마다 id, platform, resource, type, url, text, null일 수 있는 language, format, created_at, collected_at, extra.shortcode가 포함됩니다. 동영상 설명, 작성자, 참여도 지표, 커버 이미지, 다운로드 URL, 시간 구간 객체는 보관하지 않습니다.

원본이 비어 있지 않은 스크립트 텍스트를 반환할 때만 레코드가 만들어집니다. 따라서 접근 가능한 음성이나 자막이 없는 동영상, 비공개·삭제·제한·사용 불가 대상은 자리표시용 행도 남지 않을 수 있습니다.

아니요. en, es, fr 같은 두 글자 선호 코드를 사용한 뒤 반환된 language 필드를 확인하세요. 언어 제공 여부와 스크립트 정확도는 접근 가능한 원본에 따라 달라집니다.

반환된 정규화 스크립트 레코드 1건당 0.5 크레딧이 차감되며 기본 요금은 없습니다. 현재의 빈 결과 정책에서는 레코드를 만들지 못한 입력 URL에 결과별 요금이 부과되지 않습니다.