twitch/
clip

클립 URL로 공개 Twitch 클립을 가져와 제목, 조회수, 길이, 생성 시각, 스트리머 프로필과 바로 내려받을 수 있는 MP4 파일 및 썸네일을 반환합니다.

Twitch Clip Downloader API

클립 URL 입력
MP4 직접 링크
조회수
스트리머 프로필
요청당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Twitch Clip Downloader

Twitch 클립은 시청자가 생방송이나 다시보기에서 잘라 낸 짧은 하이라이트로, 자체 제목과 slug, 조회수, 길이, 생성 시각, 원본 스트리머, 렌더링된 영상과 썸네일을 함께 가집니다. 이 정보로 명장면을 영상째 보관하고, 클립이 얼마나 퍼졌는지 측정하며, 재게시할 때 원래 채널을 정확히 표기할 수 있습니다.

Twitch Clip Downloader API 주요 기능

  • 두 가지 클립 링크 형식 지원twitch.tv/채널/clip/slug 형식과 clips.twitch.tv/slug 단축 링크를 같은 클립으로 처리하므로, 채팅이나 X, Discord에서 복사한 링크를 그대로 보낼 수 있습니다.
  • 재생 가능한 MP4와 썸네일media에 클립의 MP4 직접 주소와 thumbnail_url이 담겨 하이라이트를 저장하거나 미리 보는 데 필요한 파일이 모두 갖춰집니다.
  • 조회수·길이·생성 시각metrics.views_count, duration_seconds, published_at으로 누적 조회수, 초 단위 길이, 클립이 만들어진 시각을 확인합니다.
  • 스트리머 정보 포함author에는 스트리머의 ID, 로그인 이름, 표시 이름, 채널 링크, 프로필 이미지, 파트너 여부가 들어 있어 각 클립이 어느 채널에서 나왔는지 바로 연결됩니다.
  • slug 기반 고정 식별자shortcode는 클립 slug를, id는 숫자 클립 ID를 반환하며 제목과 조회수가 바뀌어도 두 값은 그대로입니다.

Twitch Clip Downloader API 매개변수

매개변수필수설명
url필수공개 Twitch 클립 링크 하나. https://www.twitch.tv/<channel>/clip/<slug> 또는 https://clips.twitch.tv/<slug> 형식입니다.

Twitch Clip Downloader API 사용 방법

클립 링크 하나를 보내고 한 행의 결과로 클립을 읽습니다.

  1. /v1/twitch/clip에 {"url": "https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ"}을 POST합니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. results.items에서 클립을 읽습니다. has_more와 results.next_cursor는 일반 페이지네이션 규칙을 따르며 이 단일 행 결과에서는 비어 있습니다.
curl -X POST "https://api.socq.ai/v1/twitch/clip" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ"}'

Twitch Clip Downloader API 추천 활용 사례

  • 방송 하이라이트 보관: media의 MP4를 제목, 스트리머, published_at과 함께 저장해 채널 명장면을 검색 가능한 라이브러리로 만듭니다.
  • 클립 확산 추적: 같은 클립을 며칠에 걸쳐 다시 읽고 collected_at별 metrics.views_count를 그래프로 그려 반응이 커지는지 확인합니다.
  • 재게시 시 출처 표기: 모음 영상, 뉴스레터, SNS 게시물에 쓰기 전에 author의 로그인 이름, 표시 이름, 채널 링크로 출처를 정확히 밝힙니다.

Twitch Clip Downloader API 활용 팁

  • media 주소는 서명이 붙어 약 하루 뒤 만료되므로 작업이 끝나면 바로 MP4를 내려받으세요.
  • 같은 클립이 두 가지 링크로 공유될 수 있으니 저장할 때는 제출한 URL 대신 shortcode나 id를 키로 쓰세요.
  • 클립을 다시 읽을 때마다 collected_at을 views_count와 함께 저장하면 나중에 수치를 비교할 수 있습니다.

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

  • Twitch Profile API — 공개 Twitch 사용자 이름 하나를 정규화된 계정 레코드로 변환하며, 확인 가능한 계정 정보, 소개글, 이미지, 계정 속성, 공개된 지표, 수집 맥락을 포함합니다.
  • Twitch User Videos API

다른 플랫폼 둘러보기

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

Twitch Clip Downloader API — 자주 묻는 질문

Twitch Clip Downloader API는 클립 URL로 공개 Twitch 클립을 가져오는 프로그래밍 인터페이스입니다. 클립 제목, 조회수, 길이, 생성 시각, slug, 스트리머 프로필, MP4 직접 링크와 썸네일을 반환합니다.

요청마다 클립 링크 하나를 보내며 twitch.tv/채널/clip/slug와 clips.twitch.tv/slug 모두 가능합니다. 링크 형식은 작업 생성 전에 확인됩니다.

네. media에 클립의 MP4 직접 주소가 들어 있습니다. 서명된 주소라 약 하루 뒤 만료되니 작업이 끝나면 곧바로 받으세요.

표준 결과에는 클립, 지표, 스트리머가 담깁니다. 게임 이름, 클립을 잘라 낸 계정, 사용 가능한 모든 화질은 작업 파일 목록의 원본 JSONL에 보관됩니다.

요청 한 번에 클립 하나를 읽고 0.5 크레딧이 듭니다. 클립을 찾지 못하면 작업이 실패하고 전액 환불됩니다.