{"openapi":"3.0.3","info":{"title":"APICK 유튜브 검색","version":"1.0.0","description":"검색어로 유튜브 영상·쇼츠·채널·재생목록을 찾습니다. 결과 종류·업로드 시기·영상 길이로 거르고 정렬을 바꿀 수 있으며, 결과의 id는 영상 정보·댓글·자막·채널·재생목록 조회에 그대로 넣을 수 있습니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/youtube_search":{"post":{"summary":"유튜브 검색","description":"검색어로 유튜브 영상·쇼츠·채널·재생목록을 찾습니다. 결과 종류·업로드 시기·영상 길이로 거르고 정렬을 바꿀 수 있으며, 결과의 id는 영상 정보·댓글·자막·채널·재생목록 조회에 그대로 넣을 수 있습니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"query":{"type":"string","description":"앞뒤 공백을 지운 검색어입니다."},"count":{"type":"integer","description":"이번 응답에 담긴 결과 수입니다. 0이면 조건에 맞는 결과가 없습니다."},"results":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"video(영상)·short(쇼츠)·channel(채널)·playlist(재생목록) 중 하나입니다."},"id":{"type":"string","description":"영상 ID(11자리)·채널 ID(UC…)·재생목록 ID입니다."},"url":{"type":"string","description":"항목 주소입니다. 쇼츠는 /shorts/ 주소입니다."},"title":{"type":"string","description":"제목입니다. 채널은 채널 이름입니다. 없으면 null입니다.","nullable":true},"description":{"nullable":true,"type":"string","description":"설명 일부입니다. 영상·쇼츠·채널 항목에 오며 없으면 null입니다."},"duration":{"type":"integer","description":"영상 길이(초)입니다. 영상·쇼츠 항목만이며 모르면 null입니다.","nullable":true},"view_count":{"type":"integer","description":"조회수입니다. 영상·쇼츠 항목만이며 모르면 null입니다.","nullable":true},"live_status":{"nullable":true,"type":"string","description":"라이브 상태(is_live·was_live 등)입니다. 영상·쇼츠 항목만이며 일반 영상은 null입니다."},"published_at":{"nullable":true,"type":"string","description":"게시 시각(ISO 8601)입니다. 영상·쇼츠 항목만이며 제공되지 않으면 null입니다."},"channel":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"handle":{"type":"string"}},"nullable":true,"description":"올린 채널 {id, name, url, handle}입니다. 영상·쇼츠·재생목록 항목에 오며 없으면 null입니다."},"thumbnail":{"type":"string","description":"대표 썸네일 주소입니다. 없으면 null입니다.","nullable":true},"handle":{"type":"string","description":"채널 핸들(@이름)입니다. 채널 항목만이며 없으면 null입니다.","nullable":true},"follower_count":{"type":"integer","description":"구독자 수입니다. 채널 항목만이며 비공개면 null입니다.","nullable":true},"is_verified":{"type":"boolean","description":"인증 채널 여부입니다. 채널 항목만입니다."},"video_count":{"type":"integer","description":"수록 영상 수입니다. 재생목록 항목만이며 모르면 null입니다.","nullable":true}}},"description":"검색 결과 목록입니다. 항목마다 type에 따라 채워지는 필드가 다릅니다."},"success":{"type":"integer","description":"성공이면 1입니다."}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer","description":"차감된 포인트입니다. 실패하면 0입니다."},"ms":{"type":"integer","description":"처리 시간(밀리초)입니다."},"pl_id":{"type":"integer","description":"결제 기록 번호입니다. 성공한 응답에만 옵니다."}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"검색할 키워드입니다. 1~200자까지 보낼 수 있으며, 여러 단어는 공백으로 구분합니다. 특수문자는 검색 결과에 영향을 줄 수 있습니다. (string)","example":"파이썬 기초 강좌"},"count":{"type":"string","description":"결과 수 1~50 (기본 10) 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (integer)","example":"2"},"sort":{"type":"string","description":"정렬: relevance(관련도, 기본)·date(업로드일)·views(조회수)·rating(평점) 가능한 값은 4가지입니다. relevance = 검색어와의 관련도가 높은 순서로 정렬하는 값입니다. 기본 정렬로 가장 많이 쓰입니다. date = 날짜(최신순) 기준으로 정렬하는 값입니다. 최신 항목을 먼저 확인할 때 사용합니다. views = 조회수(인기) 순으로 정렬하는 값입니다. rating = 평점이 높은 순서로 정렬하는 값입니다. (string)","enum":["relevance","date","views","rating"]},"type":{"type":"string","description":"결과 종류 (기본 any) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 5가지입니다. any = 종류·기간을 제한하지 않는 값입니다. 가장 넓은 결과가 오므로 관련도가 낮은 항목도 포함됩니다. video = 동영상만 결과에 포함하는 값입니다. 채널·재생목록은 제외됩니다. channel = 채널만 결과에 포함하는 값입니다. 채널명·핸들로 검색할 때 사용합니다. playlist = 재생목록만 결과에 포함하는 값입니다. movie = 영화(정식 작품)만 결과에 포함하는 값입니다. (string)","enum":["any","video","channel","playlist","movie"],"example":"video"},"upload_date":{"type":"string","description":"업로드 시기 (기본 any) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 6가지입니다. any = 종류·기간을 제한하지 않는 값입니다. 가장 넓은 결과가 오므로 관련도가 낮은 항목도 포함됩니다. hour = 최근 1시간 안에 올라온 결과만 포함하는 값입니다. today = 오늘 올라온 결과만 포함하는 값입니다. week = 최근 1주일 안의 결과만 포함하는 값입니다. month = 최근 1개월 안의 결과만 포함하는 값입니다. year = 최근 1년 안의 결과만 포함하는 값입니다. (string)","enum":["any","hour","today","week","month","year"]},"duration":{"type":"string","description":"길이: short(4분 미만)·medium(4~20분)·long(20분 초과) 가능한 값은 4가지입니다. any = 종류·기간을 제한하지 않는 값입니다. 가장 넓은 결과가 오므로 관련도가 낮은 항목도 포함됩니다. short = 짧은 길이 구간(약 4분 미만)만 결과에 포함하는 값입니다. medium = 중간 길이 구간(약 4~20분)만 결과에 포함하는 값입니다. long = 긴 길이 구간(약 20분 초과)만 결과에 포함하는 값입니다. (string)","enum":["any","short","medium","long"]}},"required":["query"]}}}}}}},"x-code-tables":[{"title":"sort 허용값","columns":["값","의미"],"rows":[["relevance","관련도순 (기본값)"],["date","업로드일순(최신 먼저)"],["views","조회수순"],["rating","평점순"]]},{"title":"type 허용값","columns":["값","의미"],"rows":[["any","모든 종류 (기본값)"],["video","영상·쇼츠만"],["channel","채널만"],["playlist","재생목록만"],["movie","영화만"]]},{"title":"upload_date 허용값","columns":["값","의미"],"rows":[["any","제한 없음 (기본값)"],["hour","지난 1시간"],["today","오늘"],["week","이번 주"],["month","이번 달"],["year","올해"]]},{"title":"duration 허용값","columns":["값","의미"],"rows":[["any","제한 없음 (기본값)"],["short","4분 미만"],["medium","4~20분"],["long","20분 초과"]]},{"title":"오류와 복구","columns":["상황","HTTP","data.error","해결"],"rows":[["입력 오류","400","입력 항목이 잘못됐습니다. query(1~200자), count(1~50), sort·type·upload_date·duration 값을 확인해 주세요.","검색어 길이, count 범위(1~50 정수), 각 조건의 허용값을 확인해 다시 보냅니다."],["시간 초과","408","처리 시간 초과로 실패했습니다. 잠시 후 다시 시도해 주세요.","잠시 후 같은 요청을 다시 보냅니다. count를 줄이면 빨라집니다."],["일시적 조회 실패","424","일시적으로 영상 정보를 가져오지 못했습니다. 잠시 후 다시 시도해 주세요.","잠시 후 같은 요청을 다시 보냅니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}