활용 사례

소셜 영상과 숏폼을 텍스트로 반환하는 자막 API

영상이 게시된 플랫폼에서 텍스트를 가져오고 모든 네트워크에 같은 스키마를 사용합니다. 커버리지는 플랫폼이 보유한 범위를 따릅니다. 업스트림에 자막이 없는 영상은 추정하지 않고 없다고 반환합니다.

/v1/youtube

자막이 있는 영상의 텍스트

GET /v1/youtube/video/transcript
GET /v1/tiktok/post/transcript
GET /v1/instagram/media/transcript
GET /v1/youtube/transcripts

영상 자막 API는 영상 파일을 내려받거나 음성 인식을 직접 돌리지 않고 발화 내용을 구조화된 텍스트로 반환합니다. SocialCrawl은 플랫폼이 이미 보유한 자막을 유튜브와 틱톡, 인스타그램 등에서 같은 스키마로 가져옵니다. 자막이 없는 영상이 많아 커버리지는 부분적이며 응답이 어느 경우인지 알려 줍니다.

실제로 만들어지는 것

모두 현재 운영 중인 패턴입니다. 각 카드 아래의 엔드포인트 순서가 실제 호출 순서입니다.

채널 전체를 텍스트로 축적

채널의 영상 목록을 조회한 뒤 각 영상의 자막을 요청합니다. 크리에이터나 경쟁사가 영상에서 말한 내용 전체가 검색 가능한 텍스트로 남습니다. 제목만 모으는 것보다 분석 입력으로 훨씬 유용합니다.

엔드포인트 순서channel/videos -> video/transcript

영상 ID 묶음 요청

유튜브 영상 ID를 한 요청에 모아 전달합니다. 가져올 영상이 이미 정해진 파이프라인은 이 호출 위에 구성합니다. 야간 배치 작업과 요청 한도 초과 문제를 가르는 지점입니다.

엔드포인트 순서youtube/transcripts (batch by id)

틱톡 계정 순회

프로필의 영상을 조회한 뒤 각 영상의 텍스트를 요청합니다. 틱톡은 커버리지가 얕은 레인입니다. 짧은 영상 상당수가 업스트림에 자막이 아예 없으므로 재시도 대신 건너뛰도록 설계해야 합니다.

엔드포인트 순서tiktok/profile/videos -> post/transcript

캠페인 검수용 릴스 텍스트

계정의 릴스를 조회하고 필요한 항목의 자막을 요청합니다. 검증 대상 주장이 캡션이 아니라 음성으로 전달된 경우에 사용합니다.

엔드포인트 순서instagram/profile/reels -> media/transcript

페이스북 영상은 보조 레인

같은 키로 호출할 수 있습니다. 페이스북은 극히 일부 영상에만 텍스트를 노출하므로 반환값은 보조 자료로만 취급하고 워크플로가 의존하는 단계로 두지 않아야 합니다.

엔드포인트 순서facebook/post/transcript

대체 영상 플랫폼

럼블은 검색과 영상 상세, 댓글, 자막을 다른 플랫폼과 같은 스키마로 반환합니다. 규모는 작지만 응답이 깔끔하며 해당 플랫폼에서만 논의되는 사안에 유용합니다.

엔드포인트 순서rumble/video/transcript

영상 자막 API 동작 방식

네 번의 호출로 단건과 대량 작업, 두 개의 소셜 레인을 모두 처리합니다. 영상을 이미 어떤 형태로 갖고 있는지에 따라 시작점을 고릅니다.

조회는 크레딧으로 과금되며 업스트림 실패는 자동 환불됩니다. 자막 커버리지는 플랫폼과 영상에 따라 달라지므로 반환되지 않는 경우를 오류가 아니라 정상 결과로 처리해야 합니다.

GET /v1/youtube/video/transcript

URL로 단건 조회

영상 URL을 전달하면 텍스트를 반환합니다. 가장 단순한 호출이며 사람이 직접 영상을 고른 경우에 적합합니다.

호출당

GET /v1/youtube/transcripts

영상 ID 묶음 조회

가져올 목록이 이미 정해졌다면 ID를 한 요청에 모아 전달합니다. 정기 백필 작업은 이 호출 위에 구성합니다.

영상당

GET /v1/tiktok/post/transcript

틱톡 레인 추가

형태는 같고 플랫폼만 다릅니다. 커버리지가 얕으므로 반환되지 않은 영상은 재시도하지 말고 결과로 기록합니다.

호출당

GET /v1/instagram/media/transcript

인스타그램 레인 추가

이미 확보한 릴스나 영상 게시물의 텍스트를 요청합니다. 앞의 두 단계와 같은 루프에서 공통 스키마로 동작합니다.

호출당

텍스트를 가져오는 소스

자막을 반환하는 플랫폼과 이미 텍스트를 제공하는 플랫폼이 함께 있습니다. 링크를 열면 해당 플랫폼의 전체 엔드포인트를 확인합니다.

YouTube커버리지가 가장 넓은 레인입니다. URL 단건 조회와 영상 ID 묶음 조회를 지원합니다. 보유 플랫폼 중 가장 넓지만 전체 영상을 포괄하지는 않습니다.

TikTok자막 트랙이 있는 영상에 한해 텍스트를 반환합니다. 짧은 영상에서 누락이 잦으므로 반환되지 않은 항목을 기록하고 넘어가도록 구성합니다.

Instagram릴스와 영상 게시물의 텍스트를 계정 목록 조회 이후 항목 단위로 요청합니다.

Facebook일부 게시물에 한해 영상 텍스트를 제공합니다. 같은 키로 호출되지만 커버리지가 얕아 단독으로 워크플로를 지탱하기 어렵습니다.

X게시물이 텍스트를 그대로 포함하므로 검색과 게시물 상세만으로 문구를 확인합니다.

LinkedIn게시물 텍스트가 게시물 레코드에 포함되어 반환됩니다. 업스트림이 가장 불안정하므로 의존하기 전에 확인이 필요합니다.

Rumble검색과 영상 상세, 댓글, 자막을 공통 스키마로 제공합니다. 표면은 작지만 응답이 안정적입니다.

Reddit본문이 이미 텍스트입니다. 스레드와 댓글 트리에 자막 단계가 필요하지 않아 콘텐츠 파이프라인에서 가장 저렴한 레인입니다.

Spotify팟캐스트와 에피소드 목록을 메타데이터와 함께 제공합니다. 영상과 병행하는 오디오 작업의 시작점입니다.

직접 구축한 파이프라인과 비교

대부분 영상을 내려받아 음성 인식을 직접 실행합니다. 달라지는 지점은 다음과 같습니다.

Capability	SocialCrawl	일반적인 구성
운영 대상	영상 한 건당 HTTP 호출 한 번 또는 묶음당 호출 한 번으로 처리합니다.	다운로더와 큐, 모델, 모델이 도는 GPU를 모두 운영합니다.
미디어 처리	텍스트가 바로 반환되므로 영상 파일을 내려받거나 저장할 일이 생기지 않습니다.	변환에 앞서 미디어를 받아 캐시에 보관해야 합니다.
커버리지 고지	커버리지 한계를 문서로 밝히고 업스트림에 자막이 없는 영상은 누락으로 명확히 반환합니다.	빈 문자열을 그대로 반환하거나 무음 구간을 모델이 지어냅니다.
플랫폼 확장	보유한 모든 영상 플랫폼에서 키 하나와 스키마 하나를 사용합니다.	플랫폼별 추출기를 따로 두고 각각 별개로 깨집니다.
과금 방식	소멸되지 않는 크레딧 팩으로 호출당 과금하며 업스트림 실패는 환불합니다.	결과 사용 가능 여부와 무관하게 연산 시간으로 과금됩니다.
첫 결과까지	가입 무료 크레딧으로 첫 호출을 1분 안에 실행합니다.	첫 결과를 보기 전에 파이프라인부터 구축해야 합니다.

영상 자막 API 자주 묻는 질문

영상 자막 API란 무엇입니까?

영상 자막 API는 영상에서 발화된 내용을 검색과 색인, 재작성에 쓸 수 있는 구조화된 텍스트로 반환합니다. 파일을 내려받아 음성 인식을 실행하는 대신 영상 URL이나 ID를 전달하면 플랫폼이 보유한 텍스트를 반환합니다.

어떤 플랫폼이 자막을 반환합니까?

유튜브의 커버리지가 가장 넓고 틱톡과 인스타그램이 그다음입니다. 페이스북과 럼블도 같은 키로 호출되지만 커버리지가 얕습니다. 레딧과 X, 링크드인은 게시물 텍스트를 그대로 제공하므로 자막 호출이 필요하지 않습니다.

자막이 없는 영상은 어떻게 처리됩니까?

지어내지 않고 결과 없음으로 반환합니다. 이 제품의 명확한 한계입니다. 자막 유무는 플랫폼이 결정하고 짧은 영상 상당수는 자막 트랙이 애초에 생성되지 않으며 없는 텍스트를 반환할 수 있는 공급자는 없습니다. 부분 커버리지를 전제로 설계하시기 바랍니다.

음성 인식을 직접 실행합니까?

실행하지 않습니다. 엔드포인트는 플랫폼이 해당 영상에 대해 보유한 자막 트랙을 반환합니다. 업로드 단계와 미디어 다운로드, 분당 연산 과금이 없는 이유이며 동시에 플랫폼의 커버리지에서 범위가 끝나는 이유이기도 합니다.

자막을 대량으로 가져올 수 있습니까?

가능합니다. 유튜브 묶음 엔드포인트가 영상 ID 여러 건을 한 요청으로 처리하므로 정기 백필의 기반이 됩니다. 다른 플랫폼은 계정의 영상 목록을 먼저 조회한 뒤 항목 단위로 텍스트를 요청합니다.

자막 조회 비용은 얼마입니까?

조회는 소멸되지 않는 크레딧 팩에서 차감됩니다. 좌석이나 오디오 분량이 아니라 호출 단위로 과금하며 업스트림 실패는 자동 환불됩니다. 가입 시 무료 크레딧 100개를 제공하며 카드 등록이 필요하지 않습니다.

이 텍스트로 제품을 만들 수 있습니까?

AI에게 SocialCrawl을 물어보세요

ChatGPT에 물어보기 Perplexity에 물어보기 Gemini에 물어보기 Claude에 물어보기 Grok에 물어보기

첫 영상 자막 조회

가입 시 무료 크레딧 100개를 제공합니다. 카드 등록과 미디어 업로드, 자체 모델 운영이 필요하지 않습니다.

무료로 시작 문서 보기

요청

curl -G "https://socialcrawl.dev/v1/youtube/video/transcript" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY" \
  --data-urlencode "url=https://www.youtube.com/watch?v=dQw4w9WgXcQ"

curl -G "https://socialcrawl.dev/v1/tiktok/post/transcript" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY" \
  --data-urlencode "url=https://www.tiktok.com/@user/video/123"

두 호출 모두 실제 데이터로 동작합니다. 키와 영상 URL만 바꾸면 그대로 실행됩니다.