프로필
1 크레딧/v1/twitch/profile공개 프로필 정보를 반환합니다. 표시 이름, 소개, 카운터, URL이 포함됩니다.
handle
Twitch 엔드포인트
공개 Twitch 읽기 엔드포인트는 4개입니다. 프로필, 영상, 일정, 클립을 제공합니다. 데이터 API만 지원합니다.
사용자 영상
1 크레딧/v1/twitch/user/videos공개 사용자 영상 데이터를 반환합니다. 본문, 참여 지표, 작성자 필드가 포함됩니다.
handle, filter_by, sort_by
일정
1 크레딧/v1/twitch/user/schedule공개 일정 데이터를 반환합니다. 필드는 레지스트리 스키마를 따릅니다.
handle
클립
1 크레딧/v1/twitch/clip공개 클립 데이터를 반환합니다. 본문, 참여 지표, 작성자 필드가 포함됩니다.
url
Twitch API4개 엔드포인트 지원
문서 보기Twitch 스트리머의 공개 프로필을 돌려줍니다: 표시 이름, 팔로워 수, 소개, 프로필 이미지 URL, 방송 언어, 파트너 여부.
handle로 채널을 훑어본 뒤 그 채널의 영상이나 방송 일정을 가져가려 할 때 사용하세요.
1크레딧
GET/v1/twitch/profile?handle=ninja
handle · Twitch username
$ curl https://www.socialcrawl.dev/v1/twitch/profile?handle=ninja \
-H "x-api-key: sc_YOUR_API_KEY"대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다Twitch API 동작 방식
Twitch도 다른 SocialCrawl 소셜 엔드포인트와 같습니다. API 키로 GET /v1/twitch/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다. 별도 SDK는 없습니다.
호출 인증
x-api-key 헤더에 키를 보냅니다. SocialCrawl 카탈로그 전 구간에 같은 키를 사용합니다.
GET과 쿼리 파라미터
라우트는 GET입니다. handle, url, query, cursor를 쿼리로 전달합니다. 과금 전에 형식을 검증합니다.
크레딧 과금
라이브 미스는 라우트 티어를 차감합니다. 캐시 히트는 0입니다. 빈 응답과 하드 실패는 환불됩니다.
JSON 봉투
응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다.
연동 순서
대부분 제품은 계정을 확인한 뒤 목록을 보고 필요한 게시물만 깊게 읽습니다.
01계정
GET /v1/twitch/profileAuthor 형태 프로필입니다.
핸들 또는 id를 한 번 확정합니다.
02목록
GET /v1/twitch/user/videos최근 공개 항목의 PostList입니다.
라우트가 지원하면 cursor 또는 after로 페이지를 넘깁니다.
03항목
GET /v1/twitch/user/scheduleURL 또는 id 기준 전체 Post입니다.
목록 행만으로 부족할 때 사용합니다.
04댓글
GET /v1/twitch/clip플랫폼이 제공하는 CommentList입니다.
스레드가 중요할 때만 확장합니다.
요청
GET /v1/twitch/profile
?handle=ninja
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here응답 봉투
{
"success": true,
"data": { "/* Author | Post | PostList | CommentList | … */": true },
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}data 형태
archetype이 맞으면 필드 이름은 SocialCrawl 나머지 플랫폼과 같습니다.
Authorprofile
id, username, display_name, avatar_url, bio, followers, url, ext
PostList / Postuser/videos
items[].post에 id, url, content, engagement, author, published_at, ext
CommentListuser/schedule
댓글 라우트가 있을 때 items[]에 author, content.text, engagement, published_at
Search / Mediaclip
검색 결과, 미디어 메타데이터, 대본 등 라우트별 필드
게이트웨이 내부
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명 주기입니다.
- 01
엣지 수신
Next.js catch-all이 Hono 소셜 API로 연결됩니다. request_id를 발급하고 키를 인증한 뒤 속도 제한과 동시성을 적용합니다.
- 02
검증 후 차감
레지스트리에서 라우트를 찾습니다. 필수 파라미터를 먼저 검사합니다. 잘못된 입력은 미과금 400입니다. 유효 호출은 upstream 전에 차감합니다.
- 03
캐시 또는 수집
platform + resource + params로 캐시 키를 만듭니다. 히트는 credits_used 0입니다. 미스는 재시도와 서킷 브레이커로 upstream을 호출합니다.
- 04
정규화 후 반환
upstream JSON을 Author / Post / PostList / CommentList(또는 라우트 archetype)로 매핑하고 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.
운영에서 중요한 과금 규칙
- 표준 라이브 미스: 티어 비용(보통 1 크레딧)
- 고급 읽기: 보통 5 크레딧
- 프리미엄 읽기: 보통 10 크레딧
- 종량제 라우트: 문서화된 최소 바닥
- 캐시 히트: 0 크레딧
- 빈 응답·하드 실패: 자동 환불
- 잘못된 파라미터: 400, 미과금
- 크레딧 부족: 402, 미과금
- 비활성 라우트: 503, 미과금
데이터 수집 방식
Twitch은 SocialCrawl의 공개 읽기 데이터입니다. 공유 스키마로 정규화하므로 별도 OAuth를 배울 필요가 없습니다.
이 API에서의 Twitch
레지스트리에 노출된 공개 Twitch 표면입니다. 연구·모니터링·제품 작업을 위한 읽기 전용입니다.
SocialCrawl 접근 방식
하나의 게이트웨이 뒤에서 소셜 읽기 upstream을 호출합니다. 등록된 두꺼운 라우트는 Prism 컴포지트로 단계를 묶습니다.
엣지에서 나가는 형태
success, data, credits_used, request_id, cached 통일 JSON 봉투입니다. Author / Post / Comment 리프를 공유합니다.
제공하지 않는 범위
쓰기 엔드포인트와 비공개 수신함은 없습니다. 비활성 라우트는 활성 개수에 넣지 않습니다.
필드 매핑
public profile / channel→ author.*프로필 식별자와 카운터
public post / media→ post.* / items[].post게시물 본문과 참여 지표
list / search page→ items[] or hits댓글 또는 검색 결과
이 API의 활용 분야
이 API가 가장 많이 사용되는 작업입니다.
4active Twitch endpoints in the registry
1 / 5 / 10표준·고급·프리미엄 크레딧 단계
스트리머 일정·VOD 모니터링
호출은 Twitch 프로필, 콘텐츠 목록, 검색, 심화 경로에 집중됩니다. 공유 스키마의 구조화 Twitch JSON과 SocialCrawl API 키 하나입니다.
상세 읽기는 캐시 미스 기준 수 초 수준입니다. 검색과 두꺼운 컴포지트는 더 느린 경로입니다.
Twitch API 활용 사례
Twitch 데이터가 가장 많이 쓰이는 작업입니다. 각 항목에서 엔드포인트 순서와 과금 방식을 확인합니다.
활용 사례
이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.
모니터링 잡
Python, cron, Slack 봇Twitch 프로필과 피드를 폴링합니다. 참여 속도가 뛰면 알립니다.
리서치·VoC
Node, 노트북, BI 적재Twitch에서 검색 후 게시물을 확장해 브랜드·제품·경쟁 언어를 모읍니다.
백엔드 제품 잡
Go, 워커, Explorer해석-목록-상세를 파이프라인에 연결합니다. 캐시 히트로 반복 비용을 낮춥니다.
두 줄로 호출
라이브 미스는 티어별 크레딧을 사용합니다. 캐시 히트는 무료입니다. 빈 응답과 하드 실패는 환불됩니다.
curl "https://www.socialcrawl.dev/v1/twitch/profile?handle=ninja" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/twitch/user/videos?handle=ishowspeed" \
-H "x-api-key: sc_your_api_key_here"엔드포인트
Twitch API는 어떤 데이터를 돌려주나요
모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
비교
SocialCrawl과 공식 Twitch Helix API, 뭐가 다른가요?
같은 Twitch 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.
| 항목 | SocialCrawl | 공식 Twitch Helix API |
|---|---|---|
| 인증 방식 | x-api-key 헤더 하나면 돼요 | OAuth 클라이언트 크리덴셜로 앱 액세스 토큰을 발급받아야 해요 |
| 시작 절차 | 가입 후 몇 분 안에 바로 호출할 수 있어요 | 개발자 콘솔에서 앱 등록과 클라이언트 ID·시크릿 설정이 필요해요 |
| 레이트 리밋 | 크레딧 잔액만 신경 쓰면 돼요 | 클라이언트 단위 토큰 버킷 레이트 리밋을 직접 추적해야 해요 |
| 응답 스키마 | 51개 플랫폼이 같은 통합 JSON 스키마를 써요 | Helix 전용 응답 객체예요 |
| 요금 | 호출당 1 크레딧, 가입 시 100 크레딧 무료예요 | 등록된 앱이라면 레이트 리밋 안에서 무료예요 |
| 데이터 범위 | 프로필, 클립, 채널 영상, 방송 일정까지 커버해요 | 스트림·채팅까지 공식 범위가 넓지만 스코프 설정이 필요해요 |
| 유지보수 | 키 하나로 Twitch와 다른 50개 플랫폼을 함께 써요 | 토큰 갱신과 Helix 버전 변경을 직접 챙겨야 해요 |
인증 방식
SocialCrawl
x-api-key 헤더 하나면 돼요
공식 Twitch Helix API
OAuth 클라이언트 크리덴셜로 앱 액세스 토큰을 발급받아야 해요
시작 절차
SocialCrawl
가입 후 몇 분 안에 바로 호출할 수 있어요
공식 Twitch Helix API
개발자 콘솔에서 앱 등록과 클라이언트 ID·시크릿 설정이 필요해요
레이트 리밋
SocialCrawl
크레딧 잔액만 신경 쓰면 돼요
공식 Twitch Helix API
클라이언트 단위 토큰 버킷 레이트 리밋을 직접 추적해야 해요
응답 스키마
SocialCrawl
51개 플랫폼이 같은 통합 JSON 스키마를 써요
공식 Twitch Helix API
Helix 전용 응답 객체예요
요금
SocialCrawl
호출당 1 크레딧, 가입 시 100 크레딧 무료예요
공식 Twitch Helix API
등록된 앱이라면 레이트 리밋 안에서 무료예요
데이터 범위
SocialCrawl
프로필, 클립, 채널 영상, 방송 일정까지 커버해요
공식 Twitch Helix API
스트림·채팅까지 공식 범위가 넓지만 스코프 설정이 필요해요
유지보수
SocialCrawl
키 하나로 Twitch와 다른 50개 플랫폼을 함께 써요
공식 Twitch Helix API
토큰 갱신과 Helix 버전 변경을 직접 챙겨야 해요
자주 묻는 질문
자주 묻는 질문
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기Twitch 데이터는 어떻게 수집하나요?
SocialCrawl에서 스트리머 프로필, 클립 상세, 채널 영상 목록, 방송 일정까지 총 4개 Twitch 엔드포인트를 바로 쓰실 수 있어요. x-api-key만 있으면 Twitch 개발자 앱 등록이나 OAuth, Helix 클라이언트 크리덴셜 플로우 없이 바로 호출할 수 있어요.
SocialCrawl은 어떤 Twitch 엔드포인트를 지원하나요?
엔드포인트 4종을 쓰실 수 있어요: Profile, Clip, User Videos, and User Schedule. 모든 응답이 다른 50개 플랫폼과 동일한 통합 스키마로 와요.
Twitch Helix API의 대체제로 써도 되나요?
네, Twitch Helix API와 달리 SocialCrawl은 개발자 앱 등록이나 OAuth 클라이언트 크리덴셜, 액세스 토큰 갱신이 필요 없어요. x-api-key 하나로 공개 스트리머와 클립 데이터를 받아볼 수 있고, 응답 스키마가 다른 플랫폼과 똑같이 통일돼 있어요.
Twitch API는 요금이 얼마인가요?
Twitch 엔드포인트 4종 모두 호출당 1 크레딧(스탠다드 티어)이 소진돼요. 새 계정에는 100 크레딧이 무료로 제공되고, 신용카드 없이 Twitch 엔드포인트를 100번 호출해 보며 4개 엔드포인트를 처음부터 끝까지 테스트해 보실 수 있어요.
Twitch 스트리머와 클립을 수집하는 게 법적으로 괜찮나요?
SocialCrawl은 Twitch의 공개 데이터만 가져와요. 누구나 볼 수 있는 정보이지만, Twitch의 Developer Services Agreement와 약관, 개인정보 관련 법령에 사용 목적이 맞는지 직접 확인하고 사용해 주세요. SocialCrawl은 GDPR 정당한 이익에 기반한 문서화된 프레임워크로 운영돼요. 로그인 없이 볼 수 있는 공개 데이터만 다루고, 계정 자격 증명은 일절 사용하지 않으며, 캐시는 2~30분만 유지되고 영구 저장하지 않아요. 자신의 공개 정보에 대한 옵트아웃 채널도 운영해요. 자세한 내용은 socialcrawl.dev/legal/public-data-notice에서 확인하실 수 있어요.
크리에이터 발굴이나 광고 리서치에도 쓸 수 있나요?
네, 프로필 엔드포인트는 팔로워 수, 파트너·어필리에이트 여부, 방송 언어를 돌려줘서 인플루언서 쇼트리스트에 딱이에요. 클립 엔드포인트는 조회 수와 게임 태그까지 와서 바이럴 순간을 재가공하는 콘텐츠 리서치에 쉽고 간편하게 쓸 수 있어요.
가장 좋은 Twitch 스크래퍼 API는 무엇인가요?
Helix 앱 없이 공개 Twitch 데이터를 읽는다면 SocialCrawl이 가장 빨라요. 프로필, 클립, 채널 영상, 방송 일정까지 4개 엔드포인트를 호출당 1 크레딧으로 쓸 수 있고, 신용카드 없이 100 크레딧이 무료예요. 공식 Helix API는 무료에 범위도 넓지만 앱 등록과 OAuth 토큰, 레이트 리밋 관리가 필요해요.
Twitch 스크래핑 API와 공식 Twitch API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 Twitch 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.
AI에게 SocialCrawl을 물어보세요