LinkedIn Video Transcript
LinkedIn 동영상 스크립트는 동영상 게시물에 붙은 자막 문구를 하나로 이어진 글로 옮긴 것으로, 출처가 된 게시물 링크와 함께 묶여 있습니다. 창업자, 경영진, 기업이 출시 소식과 실적, 채용 이야기를 점점 더 동영상으로 전하는 만큼, 그 말을 텍스트로 확보해 두면 일반 LinkedIn 게시물과 나란히 인용하고 요약하고 검색할 수 있습니다.
LinkedIn Video Transcript API 주요 기능
- 공유 링크와 activity 링크 모두 입력urls 배열에는 linkedin.com/posts/... 공유 링크와 /feed/update/urn:li:activity:... 링크를 모두 넣을 수 있고, 요청 하나에 동영상 게시물 여러 개를 담을 수 있습니다.
- 동영상 자막에서 가져온 텍스트각 행의 text 값에는 동영상에 붙은 자막 문구가 한 단락으로 담기므로, 시청자가 화면에서 읽는 내용을 그대로 따라갑니다.
- 스크립트마다 원본 게시물 연결id와 url 값에 원본 게시물 링크가 들어 있어 스크립트를 언제든 해당 동영상까지 추적할 수 있고, 같은 게시물의 다른 데이터와도 깔끔하게 결합됩니다.
LinkedIn Video Transcript API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 동영상이 담긴 LinkedIn 게시물 링크를 하나 이상 넣으며, /posts/... 또는 /feed/update/urn:li:activity:... 형식을 사용합니다. |
LinkedIn Video Transcript API 사용 방법
LinkedIn 동영상 게시물 링크를 제출하고 동영상마다 자막 스크립트 하나를 읽습니다.
- {"urls": ["https://www.linkedin.com/posts/satyanadella_keeping-over-a-million-elevators-and-escalators-activity-7518982780551340032-z4go"]}을 /v1/linkedin/post-transcript로 POST합니다.
- GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다.
- results.items에서 스크립트를 읽고, has_more 값이 true이면 results.next_cursor로 다음 페이지를 요청합니다.
curl -X POST "https://api.socq.ai/v1/linkedin/post-transcript" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/posts/satyanadella_keeping-over-a-million-elevators-and-escalators-activity-7518982780551340032-z4go"]}'LinkedIn Video Transcript API 추천 활용 사례
- 경영진의 동영상 발언 인용: text에서 정확한 문장을 가져오고 게시물 url 값을 출처로 밝혀, CEO 동영상 업데이트 속 발언을 원본과 대조할 수 있게 합니다.
- 동영상 게시물과 글 게시물 함께 분석: LinkedIn 게시물 텍스트에 이미 쓰고 있는 키워드·주제·감성 분석 파이프라인에 text 값을 넣어, 동영상 업데이트도 글 게시물과 같은 기준으로 집계합니다.
- 제품 데모·실적 요약 동영상 브리핑: text 값을 요약 도구에 넘겨 긴 데모나 실적 요약 동영상을 게시물 링크가 달린 짧은 브리핑으로 정리합니다.
LinkedIn Video Transcript API 활용 팁
- text를 처리하기 전에 format 값을 확인하세요. plaintext는 그대로 쓰면 되고, webvtt는 자막 큐 타이밍이 남아 있으므로 제거하거나 자막 파일로 다시 활용할 수 있습니다.
- language 값이 null이면 스크립트를 번역이나 언어별 모델로 보내기 전에 text에서 언어를 먼저 감지하세요.
- 작성자, 게시 시각, 반응 수도 필요하다면 같은 게시물 URL을 LinkedIn Posts API에 보내고, 두 결과를 게시물 URL 기준으로 결합하세요.
관련 API
LinkedIn Video Transcript API 외에 LinkedIn의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- LinkedIn Profiles API — 프로필 URL에서 공개 프로필 정보, 직무, 위치, 공개된 오디언스 수, 경력, 학력, 스킬을 정규화합니다.
- LinkedIn Companies API — 공개 회사 소개, 웹사이트, 로고, 공개된 팔로워 및 직원 수, 산업, 위치, 전문 분야를 정규화합니다.
- LinkedIn Posts API — 지원되는 URL에서 공개 게시물 텍스트, 작성자, 공개된 참여도, 미디어, 게시 시각, 유형, 해시태그를 수집합니다.
- LinkedIn Company Posts API — LinkedIn 회사 페이지 URL에서 공개 게시물을 찾으며, 텍스트, 작성자 맥락, 미디어, 해시태그, 타임스탬프, 공개된 참여도를 포함합니다.
- LinkedIn Post Comments API — 알고 있는 LinkedIn 게시물에 노출된 공개 댓글을 수집하며, 텍스트, 작성자 맥락, 타임스탬프, 관계 ID, 공개된 좋아요 및 답글 수를 포함합니다.
- LinkedIn Profile Posts API — LinkedIn 프로필 URL과 연결된 공개 게시물을 찾으며, 작성자 맥락, 미디어, 해시태그, 타임스탬프, 공개된 참여도를 포함합니다.