Main APIYouTube 트렌드
수동 수집 실행
트렌드 수집을 수동으로 트리거합니다. (스케줄 외 즉시 실행)
수동 수집 실행
정기 스케줄(매일 02:00 KST) 외에 즉시 수집이 필요할 때 호출합니다. glowb-server가 Kafka(YOUTUBE_TREND_COLLECT)로 발행하면, 파이썬(sns-crawler-python)이 받아 실제 수집·PostgreSQL 적재를 수행합니다.
평상시엔 스케줄러가 자동 수집하므로 호출할 필요가 없습니다. 데모·재수집·검증용입니다. 트리거만 하고 즉시 반환하며, 실제 수집은 비동기로 진행됩니다(수집 완료까지 수십 초~수 분).
HTTP 요청
POST /api/youtube/trend/collect?region=KR&target=2000| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
region | String | 아니오 | 지역 코드, 기본 KR |
target | Integer | 아니오 | 이번 런에서 수집할 목표 레코드 수. 미지정 시 기본값(YT_COLLECT_TARGET, 현재 10000). 0=무제한 |
target 으로 원하는 개수만큼만 받아올 수 있습니다. 예를 들어 target=500 이면 500건에 도달하는 즉시 수집을 종료합니다(분야→광고여부→쇼츠/일반 순서로 채우다 목표 도달 시 중단). 값이 클수록 API 콜·소요 시간이 늘어납니다.
응답 (200 OK)
{
"status": 200,
"code": null,
"message": "수집 트리거 발행됨",
"data": { "region": "KR", "target": 2000, "published": true }
}data.published= Kafka 발행 성공 여부. 실제 수집 결과는 비동기(파이썬 로그/이후 조회로 확인).data.target= 전달된 목표 수(미지정 시null→ 파이썬 기본값 적용).