{"openapi":"3.0.3","info":{"title":"APICK 유튜브 댓글 조회","version":"1.0.0","description":"유튜브 공개 영상의 댓글을 인기순 또는 최신순으로 조회합니다. 작성자·내용·좋아요·고정 여부와 답글을 함께 받을 수 있습니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/youtube_comments":{"post":{"summary":"유튜브 댓글 조회","description":"유튜브 공개 영상의 댓글을 인기순 또는 최신순으로 조회합니다. 작성자·내용·좋아요·고정 여부와 답글을 함께 받을 수 있습니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"video_id":{"type":"string","description":"11자리 영상 ID"},"title":{"type":"string","description":"영상 제목"},"sort":{"type":"string","description":"정렬 방식"},"include_replies":{"type":"boolean","description":"답글 포함 여부"},"count":{"type":"integer","description":"이번 응답에 담긴 댓글 수(답글 포함)"},"comments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"댓글 ID"},"parent_id":{"nullable":true,"type":"string","description":"답글이면 부모 댓글 ID, 최상위 댓글이면 null"},"text":{"type":"string","description":"댓글 내용"},"author":{"type":"string","description":"작성자 표시 이름(@핸들)"},"author_channel_id":{"type":"string","description":"작성자 채널 ID. 모르면 null","nullable":true},"author_url":{"type":"string","description":"작성자 채널 주소"},"author_thumbnail":{"type":"string","description":"작성자 프로필 이미지 주소"},"author_is_uploader":{"type":"boolean","description":"영상 게시자 본인 댓글 여부"},"author_is_verified":{"type":"boolean","description":"인증 채널 작성자 여부"},"like_count":{"type":"integer","description":"좋아요 수"},"is_pinned":{"type":"boolean","description":"고정 댓글 여부"},"is_hearted":{"type":"boolean","description":"게시자 하트 여부"},"published_at":{"type":"string","description":"작성 시각(ISO 8601). 유튜브가 상대 시간(예: 2년 전)으로만 알려 주므로 근사값입니다."}}},"description":"댓글 목록. 답글은 부모 댓글 바로 뒤에 옵니다."},"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":{"url":{"type":"string","description":"유튜브 영상 URL 또는 11자리 영상 ID (string)","example":"https://www.youtube.com/watch?v=9bZkp7q19f0"},"count":{"type":"string","description":"가져올 댓글 수 1~200 (기본 20, 답글 포함) (integer)","example":"2"},"sort":{"type":"string","description":"top(인기순, 기본)·new(최신순) (string)","enum":["top","new"],"example":"top"},"replies":{"type":"string","description":"true면 댓글마다 답글을 최대 5개까지 함께 가져옵니다 (기본 false) (boolean)"}},"required":["url"]}}}}}}},"x-code-tables":[{"title":"HTTP 상태 코드","columns":["HTTP","상황","설명"],"rows":[["400","입력 오류","영상 주소, count, sort, replies 값을 확인하세요."],["404","영상 없음","삭제·비공개 영상이거나 잘못된 주소입니다. 댓글이 꺼진 영상은 빈 목록으로 응답합니다."],["408","시간 초과","처리 시간이 초과됐습니다. 과금하지 않습니다."],["424","조회 불가","연령 제한·회원 전용 영상이거나 일시적으로 가져오지 못했습니다. 실패한 호출은 과금하지 않습니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}