{"openapi":"3.0.3","info":{"title":"APICK 유튜브 계정 정보 조회","version":"1.0.0","description":"유튜브 채널의 계정 정보와 최근 게시한 동영상 정보를 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/crawl_youtube":{"post":{"summary":"유튜브 계정 정보 조회","description":"유튜브 채널의 계정 정보와 최근 게시한 동영상 정보를 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"type":{"type":"integer","description":"요청 타입(12, 고정)"},"result":{"type":"integer","description":"조회 결과1: 성공"},"user":{"type":"object","properties":{"id":{"type":"string","description":"요청한 사용자(채널) 아이디"},"channel_id":{"type":"string","description":"채널 ID(UC로 시작)"},"name":{"type":"string","description":"채널 이름"},"handle":{"type":"string","description":"채널 핸들(@이름). 없으면 null","nullable":true},"link":{"type":"string","description":"채널 URL"},"subscribe":{"type":"string","description":"구독자 수(읽기 쉬운 표기, 예: 1660만명). 비공개면 null","nullable":true},"subscriber_count":{"type":"integer","description":"구독자 수(숫자). 비공개면 null","nullable":true},"description":{"type":"string","description":"채널 설명"},"is_verified":{"type":"boolean","description":"인증 배지 여부"},"thumbnail":{"type":"string","description":"채널 프로필 이미지 URL"},"posts":{"type":"array","items":{"type":"object","properties":{"video_id":{"type":"string","description":"영상 ID"},"thumbnail_link":{"type":"string","description":"영상 URL"},"contents":{"type":"string","description":"영상 제목"},"view_count":{"type":"string","description":"조회수. 확인되지 않으면 null","nullable":true},"duration":{"type":"integer","description":"영상 길이(초). 확인되지 않으면 null","nullable":true},"thumbnail":{"type":"string","description":"썸네일 이미지 URL"}}},"description":"최근 업로드 영상 목록(최대 60개, 최신순)"}},"description":"사용자(채널) 정보"},"success":{"type":"integer","description":"과금 여부0: 실패1: 성공"}},"description":"조회 데이터"},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"API 서버 정상 응답 여부"},"cost":{"type":"integer","description":"API 호출 요금"},"ms":{"type":"integer","description":"API 응답 시간"},"pl_id":{"type":"integer","description":"API 결제 로그 ID"}},"description":"API 호출 공통 데이터"}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"user_id":{"type":"string","description":"조회할 유튜브 채널 아이디(예: CNN)·핸들(@CNN)·채널 ID(UC…) 또는 채널 URL (string)","example":"CNN"}},"required":["user_id"]}}}}}}},"x-code-tables":[{"title":"HTTP 상태 코드","columns":["HTTP","상황","설명"],"rows":[["400","입력 오류","user_id가 비었거나 채널 아이디·핸들·채널 ID·채널 주소 형식이 아닙니다. 과금되지 않습니다."],["404","채널 없음","없는 채널이거나 잘못된 주소·핸들입니다. 과금되지 않습니다."],["408","시간 초과","처리 시간이 초과됐습니다. 잠시 후 다시 요청하세요. 과금되지 않습니다."],["424","조회 실패","결과를 받지 못해 실패로 끝났습니다. 잠시 후 다시 요청하세요. 과금되지 않습니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}