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 사용 방법
클립 링크 하나를 보내고 한 행의 결과로 클립을 읽습니다.
- /v1/twitch/clip에 {"url": "https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ"}을 POST합니다.
- status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- 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와 함께 저장하면 나중에 수치를 비교할 수 있습니다.
관련 API
Twitch Clip Downloader API 외에 Twitch의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Twitch Profile API — 공개 Twitch 사용자 이름 하나를 정규화된 계정 레코드로 변환하며, 확인 가능한 계정 정보, 소개글, 이미지, 계정 속성, 공개된 지표, 수집 맥락을 포함합니다.
- Twitch User Videos API