LinkedIn동영상 스크립트자막소셜 리스닝API 가이드

LinkedIn 동영상 스크립트 API: LinkedIn 동영상 자막을 텍스트로 변환하기

게시물 URL로 LinkedIn 동영상에서 말한 내용을 일반 텍스트로 가져오세요. 게시물 URL을 대량으로 보내고, 반환된 자막 동영상 1개당 0.7 크레딧만 지불합니다.

SocQ2026년 11월 19일 업데이트약 6분 소요

창업자와 경영진은 긴 글을 쓰는 대신 LinkedIn 동영상으로 이야기하는 경우가 늘고 있습니다. 제품 데모, 강연, 실적 요약이 동영상으로 올라오기 때문에 게시물 텍스트만 읽는 파이프라인은 그 안에서 한 말을 놓치게 됩니다.

2026-11-17 SocQ는 LinkedIn Video Transcript API를 추가했습니다. 게시물 링크를 전달하면 동영상에 첨부된 자막을 바탕으로 스크립트가 반환되며, 바로 인용하거나 요약하거나 검색할 수 있는 일반 텍스트 형태입니다. 이 가이드에서는 요청, 응답, 가격, 그리고 기존 LinkedIn 워크플로에 통합하는 방법을 다룹니다.

빠른 답변: 동영상이 포함된 LinkedIn 게시물 URL을 urls에 담아 POST /v1/linkedin/post-transcript로 보내세요. GET /v1/tasks/{task_id}를 폴링하고 data.results.items에서 자막이 있는 동영상마다 1행씩 읽으며, 자막 텍스트는 text에 있습니다. 반환된 스크립트 1개당 0.7 크레딧($0.0035)입니다.

엔드포인트가 반환하는 내용

1 SocQ 크레딧 = $0.005입니다.

엔드포인트반환 내용가격
LinkedIn Video Transcript API자막이 있는 LinkedIn 동영상마다 1행: 일반 텍스트로 된 자막, 게시물 URL, 제공되는 경우 스크립트 언어·형식·길이반환된 스크립트 1개당 0.7 크레딧($0.0035)

과금은 반환된 스크립트 기준이므로, 행을 생성한 자막 동영상에 대해서만 비용을 지불합니다.

인증과 비동기 작업 흐름

모든 SocQ 요청은 API 키로 인증하며, 제출, 작업 상태 조회, 결과 조회 요청에 같은 헤더를 사용합니다.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

모든 수집은 백그라운드 작업으로 실행됩니다.

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

제출 응답에는 data.task_id와 data.status가 담겨 있습니다. 이 ID로 작업을 폴링하세요.

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

status가 succeeded가 되면 응답의 data.results.items에 정규화 레코드의 첫 페이지가 담깁니다. limit의 기본값은 50이고 최대 500입니다. has_more가 true이면 results.next_cursor를 cursor로 전달해 다음 페이지를 읽으세요. 작업이 queued, running, failed 상태일 때는 results 없이 작업 메타데이터만 반환됩니다.

제출 본문에 선택 사항인 callback_url을 넣으면 작업이 끝났을 때 SocQ가 작업 요약을 담은 POST를 한 번 보냅니다. 레코드는 GET /v1/tasks/{task_id}로 읽으세요. 클라이언트 측 타임아웃이 작업을 취소하지는 않으므로, 중복으로 비용을 내지 말고 같은 작업 ID로 조회를 이어가세요. 402는 크레딧이 부족하다는 뜻이고, 429는 키가 속도 또는 크레딧 한도에 도달했다는 뜻입니다.

LinkedIn 동영상 스크립트 요청하기

동영상이 포함된 LinkedIn 게시물 URL을 urls에 넣으세요. /posts/...와 /feed/update/urn:li:activity:... 두 가지 URL 형식을 모두 사용할 수 있습니다.

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"
    ]
  }'

SocQ는 제출한 URL 수를 기준으로 크레딧을 미리 예약할 수 있으며, 작업이 끝나면 실제 result_count로 최종 금액을 정산하고 사용하지 않은 크레딧은 돌려줍니다.

스크립트 레코드 이해하기

문서 예시는 다음 행을 반환합니다(텍스트는 줄임).

{
  "id": "https://www.linkedin.com/posts/satyanadella_keeping-over-a-million-elevators-and-escalators-activity-7518982780551340032-z4go",
  "platform": "linkedin",
  "resource": "post-transcript",
  "type": "transcript",
  "url": "https://www.linkedin.com/posts/satyanadella_keeping-over-a-million-elevators-and-escalators-activity-7518982780551340032-z4go",
  "published_at": null,
  "collected_at": "2026-11-17T14:40:24.363764Z",
  "text": "TKL Rate is one of the leading companies in global infrastructure and mobility. ...",
  "language": null,
  "format": "plaintext",
  "duration_seconds": null
}

필드 설명:

  • id와 url: 스크립트가 속한 게시물입니다. 게시물 데이터와 다시 연결할 때 URL을 조인 키로 사용하세요.
  • text: 동영상 자막에서 가져온 음성 스크립트입니다.
  • language: 제공되는 경우 스크립트 언어입니다. 예시처럼 null일 수 있으므로, 언어별로 분기한다면 언어를 직접 감지하세요.
  • format: 스크립트의 표현 형식입니다. 예시에서는 plaintext입니다.
  • duration_seconds: 제공되는 경우 동영상 길이입니다.
  • collected_at: SocQ가 행을 수집한 시각입니다.

텍스트는 동영상에 첨부된 자막에서 가져오므로 일반 자막과 같은 주의가 필요합니다. 특히 인명과 회사명에 인식 오류가 있을 수 있습니다. 인용할 때는 게시물 링크를 함께 남기세요. 전체 스키마: LinkedIn Video Transcript 문서.

LinkedIn 워크플로에 통합하기

스크립트 엔드포인트는 이미 갖고 있는 게시물 URL을 대상으로 동작합니다. 일반적인 파이프라인은 다음과 같습니다.

  1. 게시물 찾기. LinkedIn Profile Posts API나 LinkedIn Company Posts API로 팔로우하는 사람이나 회사의 게시물을 수집합니다.
  2. 동영상 게시물 선별. 동영상이 포함된 게시물만 남깁니다.
  3. 스크립트 가져오기. 해당 URL을 LinkedIn Video Transcript API로 보냅니다.
  4. 조인과 색인. URL로 각 스크립트를 게시물과 연결하고, 검색, 요약, 검색 증강 생성(RAG)을 위해 게시물 텍스트와 스크립트를 함께 색인합니다.

프로필, 회사, 게시물, 채용 공고 데이터를 더 폭넓게 살펴보려면 API로 LinkedIn을 스크래핑하는 방법과 LinkedIn 스크래퍼 API 비교를 참고하세요. 같은 파이프라인을 YouTube에서 운영한다면 YouTube 스크립트 가이드에서 언어 처리와 자막 누락을 더 깊이 다룹니다.

활용 사례

  • 경영진·경쟁사 모니터링. 리더가 동영상에서 한 말을 작성한 게시물과 함께 검색 가능한 텍스트로 만듭니다.
  • 콘텐츠 재활용. 강연이나 데모 스크립트를 출처 링크와 함께 가져와 블로그 글, 뉴스레터, 인용 카드의 초안으로 씁니다.
  • 영업·시장 조사. 동영상으로만 존재하는 제품 발표와 고객 사례를 요약합니다.
  • 아카이브와 RAG. 스크립트를 게시물 URL, collected_at과 함께 저장해 생성된 모든 답변이 출처를 인용할 수 있게 합니다.

운영 팁

  1. URL 중복을 제거하세요. /posts/... 링크와 /feed/update/urn:li:activity:... 링크로 공유된 같은 게시물은 동일한 activity ID를 가집니다. 두 번 비용을 내지 않도록 제출 전에 정규화하세요.
  2. URL보다 적은 행을 예상하세요. 자막이 있는 동영상만 행을 반환합니다. 나머지는 재시도하지 말고 스크립트 없음으로 표시하세요.
  3. 텍스트는 반환된 그대로 보관하세요. 원본 text를 저장하고, 정리와 청크 분할은 파생 사본에서 하세요.
  4. 타임스탬프를 만들어 내지 마세요. 예시 형식은 plaintext입니다. 시간 위치가 아니라 게시물을 인용하세요.

자주 묻는 질문(FAQ)

LinkedIn Video Transcript API란 무엇인가요?

동영상이 포함된 LinkedIn 게시물 URL을 받아, 동영상에 첨부된 자막을 바탕으로 동영상에서 말한 내용을 일반 텍스트로 반환하는 SocQ 엔드포인트입니다.

어떤 URL을 받나요?

동영상이 포함된 /posts/... 또는 /feed/update/urn:li:activity:... 형식의 LinkedIn 게시물 URL입니다. 여러 개를 urls 배열에 담아 보내세요.

자막이 없는 동영상도 과금되나요?

과금은 반환된 스크립트 기준입니다. 자막이 있는 동영상은 행 1개를 반환하고 0.7 크레딧($0.0035)이 부과되며, 행을 반환하지 않은 URL에는 스크립트 단위 요금이 추가되지 않습니다.

오디오를 직접 음성 인식하나요?

스크립트는 동영상에 첨부된 자막에서 가져옵니다. 문서에는 자막이 없는 동영상에 대한 음성 인식(STT) 대체 처리가 설명되어 있지 않습니다.

스크립트 1,000개는 비용이 얼마인가요?

개당 0.7 크레딧이므로 스크립트 1,000개는 700 크레딧, 즉 $3.50입니다.

LINKEDIN API

공개 LinkedIn URL로 워크플로를 테스트하세요

공개 데이터 입력을 제출하면 출처를 추적할 수 있는 컨텍스트가 포함된 정규화된 레코드를 받을 수 있습니다.

LinkedIn API 살펴보기