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을 대조합니다. 비어 있지 않은 스크립트 텍스트가 있는 경우에만 결과 항목이 생성되기 때문입니다.
- 알고 있는 공개 Facebook 동영상 게시물 또는 릴스 URL을 하나 이상 준비합니다. 이 엔드포인트는 페이지의 동영상 피드를 찾아 주지 않습니다.
- urls 배열을 /v1/facebook/video-transcript로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 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=50Facebook 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로 이어서 읽으세요.
관련 API
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에서 공개 릴스를 캡션, 작성자 맥락, 동영상 메타데이터, 공개된 참여도, 출처 참조와 함께 수집합니다.