facebook/
video-transcript

공개 Facebook 동영상 게시물과 릴스 URL에서 확인 가능한 스크립트 텍스트를 추출하고, 원본 링크, 형식, 수집 시각을 정규화된 레코드로 반환합니다.

Facebook Video Transcript API

동영상 스크립트
알고 있는 URL
원본 링크가 있는 텍스트
결과당 0.7 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Facebook Video Transcript

Facebook 동영상 스크립트 레코드는 공개 동영상 게시물과 릴스의 음성 텍스트를 담고 있으며, 원본 URL, 스크립트 텍스트, 형식, 수집 시각이 함께 제공됩니다. 이러한 레코드는 음성 색인, 선택한 콘텐츠 검토, 원본 링크가 있는 아카이브, 따로 수집한 게시물 메타데이터와 함께 쓰는 정보 보강에 활용할 수 있습니다.

Facebook Video Transcript API 주요 기능

  • 알고 있는 URL 스크립트 일괄 처리공개 Facebook 동영상 게시물 또는 릴스 URL 목록을 받아, 스크립트를 가져오기 전에 완전히 같은 문자열을 제거합니다.
  • 원본 링크가 있는 스크립트 레코드확인된 스크립트마다 제출한 원본 URL과, 해당 URL로 대체되는 레코드 ID를 함께 반환합니다.
  • 명시적인 텍스트 형식반환된 텍스트가 plaintext인지 WebVTT인지 표시하고, 후속 처리에 쓸 스크립트 수집 시각을 포함합니다.
  • 확인된 결과만 생성제출한 공개 URL에서 비어 있지 않은 스크립트 텍스트가 확인될 때만 정규화된 레코드를 만들므로, 결과 수가 입력 수보다 적을 수 있습니다.

Facebook Video Transcript API 매개변수

매개변수필수설명
urls필수알고 있는 공개 Facebook 동영상 게시물 또는 릴스 URL로, 쉼표 또는 줄바꿈으로 구분합니다.

Facebook Video Transcript API 사용 방법

알고 있는 공개 Facebook 동영상 게시물 또는 릴스 URL을 제출한 뒤 반환된 원본 URL을 대조합니다. 비어 있지 않은 스크립트 텍스트가 있는 경우에만 결과 항목이 생성되기 때문입니다.

  1. 알고 있는 공개 Facebook 동영상 게시물 또는 릴스 URL을 하나 이상 준비합니다. 이 엔드포인트는 페이지의 동영상 피드를 찾아 주지 않습니다.
  2. urls 배열을 /v1/facebook/video-transcript로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽고, has_more가 true인 동안에는 next_cursor를 따라가며, 텍스트를 저장할 때는 각 url과 format을 함께 사용합니다.
curl -X POST "https://api.socq.ai/v1/facebook/video-transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/reel/1535656380759655"]}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

Facebook Video Transcript API 추천 활용 사례

  • 음성 콘텐츠 검색 색인: 스크립트 텍스트를 원본 URL, 레코드 ID, 형식, 수집 시각과 함께 색인해, 선택한 공개 동영상을 음성 속 단어로 검색할 수 있게 합니다.
  • 선택한 동영상·릴스 검토: 원본 링크가 있는 스크립트 텍스트로, 엄선한 공개 동영상 게시물과 릴스 URL의 음성 내용을 검토합니다.
  • 게시물 메타데이터 보강: 데이터셋에 음성 내용과 공개 게시물 정보가 모두 필요할 때, 원본 URL을 기준으로 스크립트 텍스트를 따로 수집한 게시물 상세와 연결합니다.

Facebook Video Transcript API 활용 팁

  • 각 대상에 접근할 수 있는지 확인한 뒤 알고 있는 공개 동영상 게시물 또는 릴스 URL을 제출하세요. 형식이 잘못되었거나 비공개이거나 삭제되었거나 지원되지 않는 미디어는 레코드가 생성되지 않을 수 있습니다.
  • 백엔드는 완전히 같은 문자열만 중복으로 제거하므로, 같은 동영상이 추적 매개변수나 다른 URL 형태로 나타날 수 있다면 일괄 제출 전에 URL 문자열을 표준 형태로 맞추세요.
  • 작업이 성공한 뒤에는 반환된 url 값을 제출한 목록과 비교해, 비어 있지 않은 스크립트 텍스트가 없는 URL이 워크플로에서 계속 보이도록 하세요.
  • 텍스트를 파싱하기 전에 format을 먼저 읽으세요. webvtt 레코드에는 구조화되지 않은 plaintext로 처리하면 안 되는 큐 마크업이 남아 있을 수 있습니다.
  • URL 일괄 처리 분량이 결과 페이지 하나를 넘으면 has_more가 true인 동안 results.next_cursor로 이어서 읽으세요.

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

  • Facebook Posts API — 지원되는 Facebook URL에서 공개 게시물, 미디어, 반응, 댓글, 공유 수를 수집합니다.
  • Facebook Comments API — 게시물 URL에서 공개 댓글, 작성자, 참여도, 미디어, 출처 링크를 수집합니다.
  • Facebook Group Posts API — Facebook 그룹 URL에서 공개 게시물을 수집하며, 정렬 방식과 그룹별 제한을 선택할 수 있고 작성자 맥락, 동영상 미디어, 공개된 참여도를 포함합니다.
  • Facebook Ad Transcript API — Facebook 광고 라이브러리 URL에서 제공되는 음성 텍스트, 언어, 형식, 출처 맥락을 추출합니다.
  • Facebook Profile Photos API — 프로필 또는 페이지 URL에서 공개 사진을 캡션, 작성자 맥락, 참여도, 이미지 메타데이터, 출처 참조와 함께 수집합니다.
  • Facebook Reels API — 프로필 또는 페이지 URL에서 공개 릴스를 캡션, 작성자 맥락, 동영상 메타데이터, 공개된 참여도, 출처 참조와 함께 수집합니다.

다른 플랫폼 둘러보기

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

Facebook Video Transcript API — 자주 묻는 질문

Facebook Video Transcript API는 알고 있는 공개 Facebook 동영상 게시물 또는 릴스 URL에서 확인 가능한 스크립트 텍스트를 추출하는 API입니다. 비어 있지 않은 스크립트 텍스트가 있으면 원본 URL, 텍스트, 출력 형식, 수집 시각을 반환합니다.

알고 있는 공개 Facebook 동영상 게시물 또는 릴스 URL이 담긴 비어 있지 않은 urls 배열을 제출하세요. 페이지 이름, 검색어, 언어 선택, 스크립트 형식, results_limit은 받지 않습니다.

정규화된 레코드마다 id, platform, resource, type, url, text, null일 수 있는 language, format, created_at, collected_at, extra가 들어 있습니다. 동영상 제목, 작성자, 재생 시간, 썸네일, 참여도, 구간별 타임스탬프는 응답에서 표준화하지 않습니다.

출처에서 비어 있지 않은 스크립트 텍스트가 반환될 때만 결과가 저장됩니다. 따라서 비공개, 삭제, 지원되지 않음, 확인할 수 없음, 스크립트가 없는 미디어는 임의의 행을 남기지 않습니다.

이 엔드포인트는 언어 매개변수를 받지 않습니다. 정규화된 스키마에는 null일 수 있는 language 필드가 예약되어 있지만, 현재의 Facebook 수집기는 언어 선택을 제공하지 않으며 출처 언어 라벨도 보장하지 않습니다.

반환된 정규화 스크립트 결과 1건마다 0.7 크레딧이 차감됩니다. 현재의 빈 결과 정책에 따라, 결과가 생성되지 않은 입력 URL에는 결과당 요금이 발생하지 않습니다.