{"openapi":"3.0.3","info":{"title":"APICK 유튜브 해시태그 영상 조회","version":"1.0.0","description":"해시태그 하나에 올라온 유튜브 영상·쇼츠 목록을 받습니다. 트렌드 모니터링이나 주제별 콘텐츠 목록을 만들 때 씁니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/youtube_hashtag":{"post":{"summary":"유튜브 해시태그 영상 조회","description":"해시태그 하나에 올라온 유튜브 영상·쇼츠 목록을 받습니다. 트렌드 모니터링이나 주제별 콘텐츠 목록을 만들 때 씁니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"hashtag":{"type":"string","description":"#을 뺀 해시태그입니다. 저장·비교할 때 이 값을 쓰세요."},"count":{"type":"integer","description":"이번 응답에 담긴 영상 수입니다. 요청한 수보다 적으면 그 해시태그에 올라온 영상이 그만큼만 있는 것입니다."},"videos":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"video(영상) 또는 short(쇼츠)입니다."},"id":{"type":"string","description":"영상 ID(11자리)입니다."},"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":"라이브 상태입니다. 일반 영상은 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"}},"description":"올린 채널 {id, name, url, handle}입니다. 없으면 null입니다.","nullable":true},"thumbnail":{"type":"string","description":"대표 썸네일 주소입니다. 없으면 null입니다.","nullable":true}}},"description":"영상·쇼츠 목록입니다. 둘이 섞여 오므로 type(video·short)으로 구분합니다."},"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":{"hashtag":{"type":"string","description":"해시태그 (# 생략 가능, 예: kpop) 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다. (string)","example":"kpop"},"count":{"type":"string","description":"받을 영상 수 1~100 (기본 30) 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (integer)","example":"30"}},"required":["hashtag"]}}}}}}},"x-code-tables":[{"title":"오류와 복구","columns":["상황","HTTP","data.error","해결"],"rows":[["입력 오류","400","입력 항목이 잘못됐습니다. hashtag(문자·숫자·밑줄 1~100자)와 count(1~100)를 확인해 주세요.","띄어쓰기·기호를 지우고, count를 1~100 정수로 보냅니다."],["해시태그 없음","404","해시태그 영상을 찾을 수 없습니다.","철자를 확인하거나 다른 해시태그로 요청합니다."],["시간 초과","408","처리 시간 초과로 실패했습니다. 잠시 후 다시 시도해 주세요.","잠시 후 같은 요청을 다시 보냅니다. count를 줄이면 빨라집니다."],["일시적 조회 실패","424","일시적으로 영상 정보를 가져오지 못했습니다. 잠시 후 다시 시도해 주세요.","잠시 후 같은 요청을 다시 보냅니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}