플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Twitch 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | 키워드로 Twitch 채널을 찾으며, 팔로워 수, Partner 또는 Affiliate 상태, 라이브 여부, 마지막 방송 정보를 제공합니다. | 요청 1,000개당 $1.39 | 정상 |
프로필profile | Twitch 채널의 프로필, Partner 또는 Affiliate 상태, 라이브 스트림 정보, 마지막 방송을 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
클립clips | Twitch 채널에서 만들어진 클립을 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
스트림streams | 카테고리에서 현재 라이브 중인 Twitch 채널을 스트림 제목, 시청자 수, 팔로워 수, 시작 시각과 함께 나열합니다. | 요청 1,000개당 $1.39 | 정상 |
인기 스트림top_streams | 입력 없이 Twitch 인기 라이브 스트림을 채널, 제목, 게임, 시청자 수, 시작 시각과 함께 확인합니다. | 요청 1,000개당 $1.39 | 정상 |
인기 게임top_games | 입력 없이 Twitch 인기 게임을 시청자 수, 방송자 수, 박스 아트와 함께 확인합니다. | 요청 1,000개당 $1.39 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Twitch 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 키워드로 Twitch 채널을 찾으며, 팔로워 수, Partner 또는 Affiliate 상태, 라이브 여부, 마지막 방송 정보를 제공합니다. 채팅이 아닌 채널을 검색하며, | keyword | — | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=30. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | user_id · username · display_name · bio · url · avatar_url · banner_url · follower_count · is_partner · is_affiliate · is_live · current_viewers · stream_title · current_game · stream_started_at · last_broadcast_title · last_broadcast_game · last_broadcast_at · created_at · platform |
profile프로필 Twitch 채널의 프로필, Partner 또는 Affiliate 상태, 라이브 스트림 정보, 마지막 방송을 가져옵니다. 최근 동영상과 인기 클립은 기본으로 포함됩니다. 해당 섹션을 제외하려면 | username | include_clips, include_videos | Sync 응답 | — | 요청 1,000개당 $1.39 | user_id · username · display_name · bio · url · avatar_url · banner_url · follower_count · is_partner · is_affiliate · is_live · current_viewers · stream_title · current_game · stream_started_at · last_broadcast_title · last_broadcast_game · last_broadcast_at · created_at · recent_videos · top_clips · platform |
clips클립 Twitch 채널에서 만들어진 클립을 가져옵니다. 각 클립에는 제목, 조회수, 길이, 게임, 클립을 만든 시청자가 포함됩니다. | username | period | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=30. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · title · url · view_count · duration_seconds · duration_sec · game · channel_username · channel_name · curator_username · curator_name · thumbnail_url · created_at · platform |
streams스트림 카테고리에서 현재 라이브 중인 Twitch 채널을 스트림 제목, 시청자 수, 팔로워 수, 시작 시각과 함께 나열합니다. | game | — | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=30. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | stream_id · username · display_name · follower_count · title · viewer_count · game · started_at · url · avatar_url · platform |
top_streams인기 스트림 입력 없이 Twitch 인기 라이브 스트림을 채널, 제목, 게임, 시청자 수, 시작 시각과 함께 확인합니다. 순서는 지속적인 순위도, 자체 추천도 아닙니다. | — | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=30. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | stream_id · username · display_name · follower_count · title · viewer_count · game · started_at · url · avatar_url · platform | |
top_games인기 게임 입력 없이 Twitch 인기 게임을 시청자 수, 방송자 수, 박스 아트와 함께 확인합니다. 수치는 Twitch 시청 현황만 나타내며, 판매량, 전체 플레이어 수, 다른 곳에서의 인기를 나타내지 않습니다. | — | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · name · viewer_count · broadcaster_count · box_art_url · url · platform |
Twitch search 파라미터는 각각 무엇을 의미하나요?
키워드로 Twitch 채널을 찾으며, 팔로워 수, Partner 또는 Affiliate 상태, 라이브 여부, 마지막 방송 정보를 제공합니다. 채팅이 아닌 채널을 검색하며, is_live는 호출 시점의 상태를 반영할 뿐 보장하지는 않습니다.
keyword필수- search에 사용할 채널 키워드입니다. streams 엔드포인트에는 임의의 방송 제목 키워드가 아니라 game으로 전달하는 정확한 게임 또는 카테고리 이름이 필요합니다.
Twitch profile 파라미터는 각각 무엇을 의미하나요?
Twitch 채널의 프로필, Partner 또는 Affiliate 상태, 라이브 스트림 정보, 마지막 방송을 가져옵니다. 최근 동영상과 인기 클립은 기본으로 포함됩니다. 해당 섹션을 제외하려면 include_videos 또는 include_clips를 불리언 false로 설정해야 합니다. 수익, 구독자 이름, 비공개 분석 데이터는 제공되지 않습니다.
username필수- profile 또는 clips에 사용할 Twitch 채널 로그인 단축 이름이며, @ 접두사는 선택입니다. twitch.tv 전체 URL은 파싱하지 않습니다.Twitch: 로그인 이름, 표시 이름, 방송인 유형 — Twitch 공식 문서는 login, display_name, broadcaster_type을 각각 정의합니다. 여기서 username에는 채널의 짧은 이름을 사용해야 하며, 표시 이름이나 Partner/Affiliate 유형을 로그인 값으로 취급해서는 안 됩니다. 공식 사용자 조회에서 지원하는 다른 파라미터가 이 API에 자동으로 추가되지는 않습니다. · 확인일
include_clips선택- profile 응답에 엄선된 클립 정보를 포함할지 여부를 나타내는 boolean 값이며, 기본값은 true입니다. 기간 범위는 별도 clips 엔드포인트와 다릅니다.
include_videos선택- profile 응답에 최근 동영상 아카이브 정보를 포함할지 여부를 나타내는 boolean 값이며, 기본값은 true입니다. 이 섹션을 제외하려면 false로 설정하고, 문자열 "false"는 전달하지 마세요.
Twitch clips 파라미터는 각각 무엇을 의미하나요?
Twitch 채널에서 만들어진 클립을 가져옵니다. 각 클립에는 제목, 조회수, 길이, 게임, 클립을 만든 시청자가 포함됩니다. period로 지난 하루, 일주일(기본값), 한 달 또는 전체 기간을 선택합니다. 해당 기간 내 모든 클립이 포함되지 않을 수 있습니다.
username필수- profile 또는 clips에 사용할 Twitch 채널 로그인 단축 이름이며, @ 접두사는 선택입니다. twitch.tv 전체 URL은 파싱하지 않습니다.
period선택- clips의 기간으로, LAST_DAY(최근 1일), LAST_WEEK(최근 1주, 기본값), LAST_MONTH(최근 1개월), ALL_TIME(제한 없음) 중 하나입니다. 대소문자를 구분하지 않으며, 잘못된 값은 LAST_WEEK로 대체됩니다.Twitch: 클립 생성자, 원본 채널, 조회수 — Twitch 공식 클립 문서는 broadcaster와 creator를 구분하고, view_count를 클립 조회수로, duration을 초 단위로 정의합니다. 이 섹션은 용어만 확인하며, 공식 시작/종료 날짜, 커서, 클립 생성 파라미터를 그대로 제공하지 않습니다. · 확인일
Twitch streams 파라미터는 각각 무엇을 의미하나요?
카테고리에서 현재 라이브 중인 Twitch 채널을 스트림 제목, 시청자 수, 팔로워 수, 시작 시각과 함께 나열합니다. game에는 Just Chatting처럼 정확한 카테고리 이름이 필요하며, 시청자 수는 스냅샷입니다.
game필수- streams에 사용할 정확한 Twitch 카테고리 이름입니다(예: Just Chatting). 해당 게임의 과거 동영상 아카이브가 아니라 현재 그 카테고리에서 방송 중인 채널을 반환합니다.Twitch: 라이브 방송 카테고리와 현재 시청자 수 — 공식 라이브 스트림 문서는 카테고리, 채널, 현재 진행 중인 라이브 스트림을 구분하며, viewer_count를 현재 해당 스트림을 시청 중인 사용자 수로 정의합니다. 이는 클립 조회수, 팔로워 수, 누적 총 조회수가 아닙니다. 공식 game_id 파라미터는 이 페이지에서 요구하는 카테고리 이름을 대신할 수 없습니다. · 확인일
Twitch top_streams 파라미터는 각각 무엇을 의미하나요?
입력 없이 Twitch 인기 라이브 스트림을 채널, 제목, 게임, 시청자 수, 시작 시각과 함께 확인합니다. 순서는 지속적인 순위도, 자체 추천도 아닙니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태이 액션에는 비즈니스 파라미터가 없습니다. 플랫폼과 액션 식별자만 보내면 됩니다.
Twitch top_games 파라미터는 각각 무엇을 의미하나요?
입력 없이 Twitch 인기 게임을 시청자 수, 방송자 수, 박스 아트와 함께 확인합니다. 수치는 Twitch 시청 현황만 나타내며, 판매량, 전체 플레이어 수, 다른 곳에서의 인기를 나타내지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태이 액션에는 비즈니스 파라미터가 없습니다. 플랫폼과 액션 식별자만 보내면 됩니다.
Twitch API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"twitch","action":"search","params":{"keyword":"<keyword>"}}'
Twitch API 자주 묻는 질문
Twitch API로 무엇을 가져올 수 있나요?
platform을 twitch 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 프로필, 클립, 스트림, 인기 스트림 및 more입니다. 각 액션 이름은 서로 다른 Twitch 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Twitch search 요청에는 어떤 입력이 필요한가요?
search에 사용할 채널 키워드입니다. streams 엔드포인트에는 임의의 방송 제목 키워드가 아니라 game으로 전달하는 정확한 게임 또는 카테고리 이름이 필요합니다. params 안의 keyword 필드로 전달하세요.
Twitch search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 user_id, username, display_name 및 bio입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Twitch 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.