Main APIYouTube 트렌드
YouTube 트렌드 개요
분야별 YouTube 키워드 트렌드(광고 O/X × 쇼츠/일반)를 조회하는 API입니다.
YouTube 트렌드 API (FE 연동)
분야별 키워드로 매일 수집한 YouTube 트렌드 영상을 조회하는 API입니다. FE는 아래 3개 조회 엔드포인트로 리포트 화면을 구성합니다.
수집 개요
- 분야(slot):
BEAUTY · FASHION · TRAVEL · IT · HEALTH - 광고여부(ad_flag):
O= 협찬/공동구매 콘텐츠 ·X= 일반 인기 트렌드 - 길이(is_shorts): 쇼츠(≤180초) / 일반영상
- → 분야마다 (광고 O/X) × (쇼츠/일반) 4버킷
- 매일 02:00 KST 자동 수집. 지역 기본
KR.
FE는 glowb-server를 호출합니다. 백엔드(glowb-server)가 PostgreSQL(youtube_trend)을 직접 조회해 서빙하고, 데이터 수집·적재는 파이썬 파이프라인(sns-crawler-python)이 담당합니다. 모든 응답은 표준 ApiResponse 래퍼(status/code/message/data)로 내려갑니다.
엔드포인트 (glowb-server)
| 메서드 | 경로 | 용도 |
|---|---|---|
GET | /api/youtube/trend/stats | 요약(소스별 레코드 수) — 리포트 상단 "N건" 표기 |
GET | /api/youtube/trend/records | flat 레코드 — 하단 데이터 테이블 |
GET | /api/youtube/trend/report | 분야별 4버킷(조회수순·속도순) — 트렌드 카드 |
POST | /api/youtube/trend/collect | 수동 수집 트리거 (Kafka → 파이썬 수집) |
공통 파라미터
| 파라미터 | 기본값 | 설명 |
|---|---|---|
date | 최신 수집일 | 조회 일자 YYYY-MM-DD. 미지정 시 해당 지역 최신일 자동 |
region | KR | 지역 코드 |
참고
velocity= 조회수 ÷ 게시 후 경과일 (수집 시점 급상승 근사치). 정밀 급상승은 일자별 누적으로 계산.- YouTube API 한계상 영상이 사용한 음원(오디오 트랙)은 제공되지 않습니다(음원 트렌드는 TikTok 파이프라인 담당).
- 원본 보관은 30일 제한(ToS).