x/
post-transcript

게시물 URL로 X 동영상의 음성을 텍스트로 변환하며, 말한 내용을 일반 텍스트로, 동영상 길이를 초 단위로 반환하고 요청 하나에 여러 게시물을 처리합니다.

Twitter Video Transcript API

게시물 URL 입력
일반 텍스트 스크립트
초 단위 길이
결과당 0.7 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Twitter Video Transcript

X(구 트위터) 동영상에는 인터뷰, 발표, 제품 시연, 해설이 음성으로 담겨 있으며, 스크립트는 이 음성을 초 단위 클립 길이와 함께 일반 텍스트로 바꿔 줍니다. 글로 옮긴 음성은 정확하게 인용하고, 요약하고, 번역하고, 일반 게시물에 쓰는 키워드·주제 분석 방법 그대로 검색할 수 있습니다.

Twitter Video Transcript API 주요 기능

  • URL로 동영상 게시물 지정동영상이 있는 트윗의 x.com/{username}/status/{post_id} 링크를 하나 이상 넘기면, 동영상마다 게시물 id와 url 값이 담긴 행 하나가 반환됩니다.
  • 이어지는 일반 텍스트로 된 음성text 필드에는 동영상에서 말한 내용이 하나의 일반 텍스트 블록으로 담기고 format 값은 "text"이며, 화자가 사용한 언어로 작성됩니다.
  • 스크립트마다 동영상 길이duration_seconds 값은 동영상 재생 시간으로, 클립을 길이순으로 정렬하거나 발화 밀도를 측정할 때 유용합니다.

Twitter Video Transcript API 매개변수

매개변수필수설명
urls필수/{username}/status/{post_id} 형식의 X 게시물 URL을 하나 이상 넣으며, 각각 동영상이 담긴 게시물을 가리켜야 합니다.

Twitter Video Transcript API 사용 방법

동영상 게시물 URL을 제출하고 동영상마다 스크립트 하나를 읽습니다.

  1. {"urls": ["https://x.com/NASA/status/2119833829389041896"]}을 /v1/x/post-transcript로 POST합니다.
  2. GET /v1/tasks/{task_id}를 폴링합니다. status가 succeeded가 되면 스크립트가 준비된 것입니다.
  3. results.items에서 스크립트를 하나씩 읽고, has_more가 true이면 results.next_cursor로 나머지를 가져옵니다.
curl -X POST "https://api.socq.ai/v1/x/post-transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/NASA/status/2119833829389041896"]}'

# Videos up to 2 minutes cost 0.7 credits; longer ones cost 4 credits per started minute.

Twitter Video Transcript API 추천 활용 사례

  • 클립 속 발언 인용: text에서 정확한 문장을 가져오고 게시물 url 값을 출처로 밝혀, 인터뷰나 보도 클립의 인용을 원본과 대조할 수 있게 합니다.
  • 동영상 게시물 요약·번역: text 값을 요약 도구나 번역 모델에 보내 긴 동영상 게시물을 짧은 메모나 다른 언어로 바꿉니다.
  • 여러 동영상의 음성 내용 검색: 크리에이터나 브랜드의 동영상 게시물 스크립트를 색인해, 특정 제품, 인물, 주제를 언급한 클립을 모두 찾습니다.
  • 동영상의 텍스트 버전 게시: 기사, 뉴스레터, 도움말 페이지의 동영상 아래에 text 내용을 넣어, 소리를 끈 독자도 내용을 따라갈 수 있게 합니다.

Twitter Video Transcript API 활용 팁

  • 긴 녹화본은 예산을 따로 잡으세요. 2분 이하 동영상은 0.7 크레딧이지만 10분짜리 녹화본은 40 크레딧이며, 전체 길이에서 시작된 1분마다 요금이 부과됩니다.
  • 번역으로 보내기 전에 text의 언어를 감지하세요. 스크립트는 동영상에서 말한 언어로 작성됩니다.
  • 어느 게시물에 동영상이 있는지 확실하지 않다면 게시물 URL을 섞어서 제출하세요. 동영상 게시물은 스크립트를 반환하고 나머지는 요금이 청구되지 않으며, 텍스트나 이미지 게시물로만 이루어진 목록은 실패 처리되고 전액 환불됩니다.

Twitter Video Transcript API 외에 X의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Twitter Tweet Scraper API — x.com 또는 twitter.com 게시물 URL에서 공개 게시물 텍스트, 작성자, 참여도, 미디어, 해시태그, 멘션, 대화 관계를 가져옵니다.
  • Twitter User Tweets Scraper API — 사용자 이름으로 최근 공개 게시물, 작성자, 미디어, 해시태그, 멘션, 참여도를 수집하며 답글은 제외합니다.
  • X Post Quotes API — 알고 있는 게시물 URL에 대한 공개 인용 게시물을 수집하며, 코멘트, 작성자, 참여도, 미디어, 타임스탬프, 원본 게시물 맥락을 포함합니다.
  • X Post Replies API — X 게시물 URL에서 공개 답글을 수집하며, 정렬 방식을 선택할 수 있고 답글 텍스트, 작성자, 공개된 참여도, 미디어, 상위 게시물 맥락을 포함합니다.
  • Twitter Mentions API — 지정한 계정을 멘션한 공개 게시물을 수집합니다.
  • Twitter Media Scraper API — 계정이 올린 사진·동영상·GIF 게시물을 최고 화질 미디어 파일과 함께 수집합니다.

다른 플랫폼 둘러보기

X 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Twitter Video Transcript API — 자주 묻는 질문

Twitter Video Transcript API는 동영상이 담긴 게시물 URL로 X 동영상의 음성을 텍스트로 변환하는 프로그래밍 인터페이스입니다. 동영상마다 일반 텍스트 스크립트와 초 단위 동영상 길이를 반환합니다.

게시물 링크를 복사해 urls 배열에 넣고(요청 하나에 여러 링크 가능), 작업이 성공하면 text 필드에서 스크립트를 읽으세요.

아니요. 동영상마다 format 값이 "text"인 일반 텍스트 스크립트 하나와 전체 duration_seconds 값이 반환되며, 줄별 타이밍은 없습니다.

2분 이하 동영상은 0.7 크레딧입니다. 더 긴 동영상은 전체 길이에서 시작된 1분마다 4 크레딧이 부과되므로, 3분짜리 동영상은 12 크레딧입니다.

스크립트는 동영상에서 말한 언어로 작성됩니다. 결과에는 언어 표시가 없으므로 워크플로에 필요하면 text에서 언어를 감지하세요.

동영상이 없는 게시물은 행이 반환되지 않고 요금도 청구되지 않습니다. 제출한 게시물 중 동영상이 있는 것이 하나도 없으면 작업이 실패하고 전액 환불됩니다.