YouTube Shorts
YouTube 쇼츠는 제목, 채널 컨텍스트, 썸네일, 재생 시간, 게시 정보, 출처 분류, 공개된 참여 지표를 가진 숏폼 동영상입니다. 이러한 콘텐츠 및 성과 신호는 포맷 조사, 크리에이터 비교, 트렌드 모니터링, 캠페인 분석에 활용할 수 있습니다.
YouTube Shorts API 주요 기능
- 여러 채널 쇼츠 수집한 번의 요청으로 여러 채널 URL의 공개 쇼츠를 수집합니다.
- 채널별 결과 한도입력 채널마다 results_limit 값을 따로 설정하며, 기본값은 100입니다.
- 정규화된 쇼츠 메타데이터정규화된 쇼츠 식별 정보, 콘텐츠 메타데이터, 썸네일, 재생 시간, 게시일, 게시 채널을 반환합니다.
- 특정 시점의 참여 지표공개된 조회수·좋아요 수·댓글 수를 collected_at과 함께 포함하여 이후 비교에 쓸 수 있습니다.
- 플랫폼 고유의 쇼츠 범위재생 시간이나 화면 방향만으로 숏폼 콘텐츠를 정의하지 않고 YouTube의 쇼츠 분류를 따릅니다.
YouTube Shorts API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 공개 YouTube 채널 URL로, 쉼표 또는 줄바꿈으로 구분합니다. |
results_limit | 선택 | 입력 URL마다 요청할 대상 레코드의 최대 개수입니다. 양의 정수여야 하며 기본값은 100입니다. |
YouTube Shorts API 사용 방법
알고 있는 채널 집합에서 깔끔한 숏폼 스트림을 만듭니다. 이 작업은 플랫폼의 분류와, 나중에 적용할 수 있는 자체 포맷 규칙을 구분해서 다룹니다.
- 공개 채널 URL을 준비합니다. 개별 쇼츠 URL을 직접 조회해야 한다면 Videos를 사용하세요.
- urls와 results_limit을 /v1/youtube/shorts로 POST하되, 한도가 모든 채널에 적용된다는 점을 고려합니다.
- 채널 인벤토리 수집이 끝날 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 쇼츠 ID 기준으로 결과를 색인하고, 채널 및 수집 컨텍스트를 유지하며, has_more가 true인 동안 페이지네이션합니다.
curl -X POST "https://api.socq.ai/v1/youtube/shorts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/@NASA"],"results_limit":10}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50YouTube Shorts API 추천 활용 사례
- 숏폼 활동 모니터링: 선택한 크리에이터, 브랜드, 퍼블리셔, 경쟁사가 게시한 공개 쇼츠를 추적합니다.
- 쇼츠 성과 비교: 선택한 채널 간의 게시 빈도, 재생 시간, 조회수, 좋아요 수, 댓글 수를 비교합니다.
- 숏폼 콘텐츠 카탈로그: 내부 검색, 검토, 보고용으로 공개 쇼츠의 정규화된 컬렉션을 구축합니다.
- 주제·트렌드 분석: 제목, 설명, 해시태그, 채널 데이터, 공개 지표를 분류나 조사 워크플로에 활용합니다.
YouTube Shorts API 활용 팁
- 범용 재생 시간 기준으로 결과를 다시 분류하지 마세요. 이 엔드포인트의 사양은 YouTube의 공개 포맷 분류입니다.
- 한도는 채널별 상한이며 보장값이 아닙니다. 적격한 공개 쇼츠가 적거나 없는 채널도 있습니다.
- 중복 제거에는 반환된 ID를 사용하세요. 시스템의 다른 곳에서는 같은 항목이 서로 다른 공개 URL 형태로 나타날 수 있습니다.
- 쇼츠의 공개 카운터는 게시 직후 빠르게 변할 수 있으므로 metrics와 함께 collected_at을 보관하세요.
- 이 엔드포인트는 키워드로 검색하지 않습니다. 주제 탐색은 Search에서 시작하고, 필요하면 알게 된 쇼츠 URL을 Videos로 넘기세요.
- 숏폼과 일반 게시를 깔끔하게 비교하려면 Channel Videos를 별도로 수집하세요.
- 변할 수 있는 채널 메타데이터를 모든 항목에 반복해서 넣지 말고, 프로필·오디언스 필드는 채널 ID로 Channels와 조인하세요.
관련 API
YouTube Shorts API 외에 YouTube의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- YouTube Channel Videos API — 채널 URL에서 쇼츠와 라이브 방송을 제외한 일반 공개 동영상을 수집합니다.
- YouTube Comments API — 공개 댓글, 작성자, 참여도, 원본 동영상, 대화 맥락을 수집합니다.
- YouTube Transcripts API — 제공되는 일반 텍스트 스크립트를 가져오며, 언어를 선택할 수 있습니다.
- YouTube Channels API — 공개 채널 정보, 이미지, 인증 여부, 공개된 오디언스 통계를 가져옵니다.
- YouTube Videos API — 알고 있는 동영상 또는 쇼츠 URL의 메타데이터, 썸네일, 길이, 참여도를 가져옵니다.
- YouTube Channel Live Videos API — 채널의 라이브 영역에 노출된 공개 방송 기록을 수집하며, 출처 맥락과 공개된 지표를 포함합니다.
- YouTube Search API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API