{"openapi":"3.0.3","info":{"title":"APICK 유튜브 채널 조회","version":"1.0.0","description":"유튜브 채널의 이름·핸들·구독자 수·소개와 영상·쇼츠·라이브·재생목록 탭의 목록을 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/youtube_channel":{"post":{"summary":"유튜브 채널 조회","description":"유튜브 채널의 이름·핸들·구독자 수·소개와 영상·쇼츠·라이브·재생목록 탭의 목록을 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"channel":{"type":"object","properties":{"id":{"type":"string","description":"채널 ID"},"name":{"type":"string","description":"채널 이름"},"url":{"type":"string","description":"채널 주소"},"handle":{"type":"string","description":"채널 핸들(@아이디). 없으면 null","nullable":true},"description":{"type":"string","description":"채널 소개"},"follower_count":{"type":"integer","description":"구독자 수. 비공개이면 null","nullable":true},"is_verified":{"type":"boolean","description":"인증 채널 여부"},"tags":{"type":"array","items":{"type":"string"},"description":"채널 키워드"},"thumbnail":{"type":"string","description":"채널 프로필 이미지 주소. 없으면 null","nullable":true}},"description":"채널 정보"},"tab":{"type":"string","description":"조회한 탭"},"count":{"type":"integer","description":"이번 응답에 담긴 항목 수"},"items":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"url":{"type":"string"},"title":{"type":"string"},"description":{"nullable":true},"duration":{"type":"integer"},"view_count":{"type":"integer"},"live_status":{"nullable":true},"published_at":{"nullable":true},"channel":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"handle":{"type":"string"}}},"thumbnail":{"type":"string"}}},"description":"탭 항목 목록. 영상·쇼츠·라이브 탭은 video·short 항목, 재생목록 탭은 playlist 항목입니다(형식은 유튜브 검색 결과와 같음)."},"success":{"type":"integer","description":"과금 여부0: 실패1: 성공"}},"description":"조회 데이터"},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"API 서버 정상 응답 여부"},"cost":{"type":"integer","description":"API 호출 요금"},"pl_id":{"type":"integer","description":"API 결제 로그 ID"},"ms":{"type":"integer","description":"API 응답 시간"}},"description":"API 호출 공통 데이터"}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"channel":{"type":"string","description":"채널 URL, 핸들(@이름) 또는 채널 ID(UC...) (string)"},"tab":{"type":"string","description":"목록 탭 (기본 videos) (string)","enum":["videos","shorts","streams","playlists"],"example":"videos"},"count":{"type":"string","description":"가져올 항목 수 1~100 (기본 30) (integer)","example":"1"}},"required":["channel"]}}}}}}},"x-code-tables":[{"title":"HTTP 상태 코드","columns":["HTTP","상황","설명"],"rows":[["400","입력 오류","channel, tab, count 값을 확인하세요."],["404","채널 없음","없는 채널이거나 잘못된 주소·핸들입니다."],["408","시간 초과","처리 시간이 초과됐습니다. 과금하지 않습니다."],["424","조회 불가","일시적으로 가져오지 못했습니다. 잠시 후 다시 시도해 주세요. 실패한 호출은 과금하지 않습니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}