Main APIYouTube 트렌드
트렌드 리포트 (4버킷)
분야별 4버킷(광고 O/X × 쇼츠/일반)을 조회수순·속도순으로 반환합니다.
트렌드 리포트 (분야별 4버킷)
분야별로 (광고 O/X) × (쇼츠/일반) 4버킷을 각각 조회수순 + 속도순 상위 N으로 정리해 반환합니다. 트렌드 카드/섹션 구성용.
HTTP 요청
GET /api/youtube/trend/report?date=2026-07-27®ion=KR&slot=BEAUTY&top=20Query Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
date | String | 아니오 | 조회 일자(YYYY-MM-DD), 기본 최신 |
region | String | 아니오 | 지역 코드, 기본 KR |
slot | String | 아니오 | 분야 필터, 미지정 시 전체 분야 |
top | Integer | 아니오 | 버킷당 상위 N (1~50, 기본 20) |
응답 (200 OK)
표준 ApiResponse 래퍼. 실제 데이터는 data.
{
"status": 200, "code": null, "message": "조회 완료",
"data": {
"region": "KR",
"date": "2026-07-27",
"totalVideos": 412,
"slots": {
"BEAUTY": {
"광고X": {
"쇼츠": {
"count": 50,
"byViews": [ { "video_id": "...", "title": "...", "view_count": 450050, "velocity": 305718.6, "view_delta": 8400, "url": "...", "sound": { "title": "Catch Catch", "artist": "@YENA_OFFICIAL", "source_video_id": "sjtyqmA-pH4" } } ],
"byVelocity": [ { "video_id": "...", "title": "...", "velocity": 362772.6, "view_count": 359300, "url": "...", "sound": null } ]
},
"일반": { "count": 4, "byViews": [], "byVelocity": [] }
},
"광고O": {
"쇼츠": { "count": 12, "byViews": [], "byVelocity": [] },
"일반": { "count": 0, "byViews": [], "byVelocity": [] }
}
}
}
}
}data.slots.<분야>.<광고O|광고X>.<쇼츠|일반>구조. 각 셀은count+byViews(조회수순) +byVelocity(속도순).byViews/byVelocity각 항목은 records 와 동일 필드셋(description·channel_id·tags·topic_categories·sound·view_delta·hashtag_n·eng_rate·default_audio_language·status등 포함, 예시에선 생략). 목업 23필드 대응은 필드 매핑 참고.- 분야는 현재 뷰티/여행/패션 3개만 수집합니다.
- 각 항목의
sound는 쇼츠 음원(title·artist·source_video_id). 일반 영상·오리지널 사운드는null. - 수집은 매일(24시간 주기) 돌며,
view_delta는 직전 수집(≈하루 전) 대비 조회수 증가분(급상승 신호). 첫 수집은null. - 데이터 없으면
data.date: null+ 안내message.