API 목록으로 돌아가기
Twitch 공개 데이터

Twitch 공개 데이터 API

알고 있는 공개 Twitch 사용자 이름을 정규화된 프로필로 확인하거나 공개 동영상 목록을 수집하고, 클립 하나를 내려받을 수 있는 동영상과 함께 가져와 크리에이터 리서치, 카탈로그 정보 보강, 비교, 스냅샷 모니터링에 활용합니다.

사용할 수 있는 Twitch API

정규화된 계정 식별 정보는 Twitch Profile API, 지원하는 유형·정렬 필터를 적용한 공개 동영상 한 페이지는 Twitch User Videos API, 클립 URL로 공개 클립 하나를 가져올 때는 Twitch Clip Downloader API를 사용합니다.

어떤 Twitch 데이터를 가져올 수 있나요?

Twitch 카탈로그는 사용자 이름으로 정규화된 공개 계정 레코드 하나 또는 정규화된 공개 동영상 한 페이지를, 클립 URL로 공개 클립 하나를 반환하며, 원본에서 값을 제공하지 않으면 해당 필드는 null이 됩니다.

프로필 식별 정보

제공되는 계정 ID, 공개 URL, 사용자 이름, 표시 이름, 소개글을 가져옵니다.

프로필 구성 요소

제공되는 프로필 사진, 커버 이미지, 연결된 웹사이트 필드를 보존합니다.

계정 신호

null이 가능한 인증 여부와 비공개 여부 플래그를 읽으며, 없는 값을 추측하지 않습니다.

공개된 계정 수치

제공되는 팔로워, 팔로잉, 게시물 수를 collected_at과 함께 보관해 특정 시점 비교에 활용합니다.

공개 사용자 동영상

원본 한 페이지에서 동영상 식별 정보, 크리에이터 정보, 미디어, 길이, 게시 시각, 공개된 참여도를 수집합니다.

공개 클립

클립의 제목, 조회수, 길이, 생성 시각, 스트리머, 내려받을 수 있는 MP4 링크와 썸네일을 가져옵니다.

SocQ vs Twitch API

SocQ는 정규화된 작업 워크플로로 공개 프로필, 사용자 동영상, 클립을 가져옵니다. Twitch 고유 API와 인증은 권한이 부여된 애플리케이션 연동과 채널 운영에 적합합니다.

기능SocQTwitch API
주요 용도공개 프로필 확인, 사용자 동영상 한 페이지 수집 또는 클립 하나 가져오기Twitch 리소스를 기반으로 한 Twitch 고유 연동 구축
인증SocQ API 키Twitch 애플리케이션과 해당 사용자 또는 앱 권한
시작 입력사용자 이름 하나(클립은 클립 URL 하나)고유 요청 매개변수와 Twitch 리소스 식별자
채널 관리지원하지 않음권한이 부여된 Twitch API와 필요한 권한 사용
응답 형식정규화된 SocQ AccountItem 또는 ReelVideoItem 레코드Twitch 고유 응답 객체

Twitch API 작동 방식

모든 Twitch API는 SocQ 공통 비동기 작업과 저장된 결과 흐름을 따릅니다.

  1. 1. 엔드포인트 선택

    올바른 공개 사용자 이름 하나를 /v1/twitch/profile 또는 /v1/twitch/user-videos에, 또는 클립 URL 하나를 /v1/twitch/clip에 POST하고 task_id를 저장합니다.

  2. 2. 작업 추적

    작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.

  3. 3. 저장된 레코드 읽기

    프로필 또는 동영상 레코드는 data.results.items에서 읽고, 수집 시점 정보를 함께 보관합니다.

공개 Twitch 프로필 확인

SocQ API 키로 인증하고 지원하는 사용자 이름을 정확히 하나만 제출합니다. 성공한 작업은 건당 0.19 크레딧의 고정 요금이 부과됩니다.

curl -X POST "https://api.socq.ai/v1/twitch/profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"ninja"}'

# Poll GET /v1/tasks/{task_id}
# Read the normalized account in data.results.items

Twitch API 주요 활용 사례

크리에이터 식별 정보 보강

알고 있는 크리에이터 레코드에 제공되는 Twitch 식별 정보, 소개글, 이미지, 웹사이트, 계정 플래그, 공개 수치를 추가합니다.

핸들 확인

공개 프로필을 내부 리서치 대상에 연결하기 전에 제출한 사용자 이름을 확인합니다.

계정 비교

따로 수집한 프로필을 null이 가능한 동일한 식별 정보·지표 필드로 비교합니다.

스냅샷 모니터링

공개 프로필 값과 함께 collected_at을 보관해, 이후 실행 결과를 서로 구분되는 스냅샷으로 유지합니다.

동영상 목록 정보 보강

알고 있는 채널에 공개 동영상 식별 정보, 미디어, 크리에이터 정보, 길이, 타임스탬프, 공개된 참여도를 연결합니다.

하이라이트 보관

클립의 MP4를 제목, 스트리머, 생성 시각과 함께 저장해 채널 명장면을 검색 가능한 라이브러리로 만듭니다.

제한 사항과 공개 데이터 정책

Twitch 엔드포인트는 읽기 전용 공개 프로필·사용자 동영상·클립 조회입니다. 인증이 필요한 채널 작업이나 시청자 데이터는 제공하지 않습니다.

  • Profile과 User Videos는 사용자 이름 하나만 받으며, 채널 URL, 사용자 이름 목록, results_limit은 받지 않습니다.
  • Twitch Clip Downloader는 twitch.tv/<channel>/clip/<slug> 또는 clips.twitch.tv/<slug> 형식의 클립 URL 하나를 받으며, 반환되는 MP4 링크는 서명되어 약 하루 뒤 만료됩니다.
  • 사용자 이름은 @로 시작할 수 있으며, 그 외에는 영문 ASCII 문자, 숫자, 점, 밑줄, 하이픈으로 이루어진 1~64자여야 합니다.
  • 프로필 조회는 원본 프로필 객체를 최대 1개 반환합니다. User Videos는 원본 한 페이지를 수집하며 호출자가 지정하는 커서나 results_limit을 받지 않습니다.
  • 공개 원본 데이터가 없으면 프로필 식별 정보, 이미지, 웹사이트, 플래그, 위치, 개별 지표는 null일 수 있습니다.
  • 이 엔드포인트는 로그인, 게시, 모더레이션, 채널 관리, 비공개 분석 조회, OAuth 권한이 필요한 계정 작업을 하지 않습니다.

Twitch API 자주 묻는 질문

Twitch API란 무엇인가요?

Twitch API는 비동기 작업으로 알고 있는 공개 사용자 이름 하나를 정규화된 프로필로 확인하거나 공개 동영상 한 페이지를 수집하고, 클립 URL로 공개 클립 하나를 가져옵니다.

현재 어떤 Twitch API를 사용할 수 있나요?

현재 Twitch Profile API, Twitch User Videos API, Twitch Clip Downloader API를 사용할 수 있습니다.

Twitch URL을 제출할 수 있나요?

Twitch Clip Downloader API는 url로 클립 URL 하나를 받습니다. Twitch Profile과 User Videos는 username을 필수로 요구하며, url, urls와 그 외 선언되지 않은 필드는 거부합니다.

이 API로 Twitch 채널을 관리할 수 있나요?

아니요. 모든 Twitch 엔드포인트는 읽기 전용 공개 조회이며, Twitch 사용자 인증, 게시, 모더레이션, 채널 설정 관리, 비공개 분석 조회는 제공하지 않습니다.

필드가 null인 이유는 무엇인가요?

정규화된 계정·동영상 레코드는 수집 시점에 원본이나 데이터 제공자가 값을 제공하지 않으면 선택적인 공개 필드를 null로 보존하기 때문입니다.

Twitch 요청 요금은 어떻게 되나요?

성공한 Twitch Profile 또는 User Videos 작업은 건당 0.19 SocQ 크레딧의 고정 요금이 부과됩니다. Twitch Clip Downloader 요청은 건당 0.5 크레딧이며, 클립을 찾지 못하면 전액 환불됩니다.

여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.