YouTube Shorts Search
쇼츠 검색 결과는 YouTube가 쇼츠 필터에서 키워드에 맞춰 순위를 매긴 세로형 동영상으로, 각 결과에는 캡션, 조회수, 9:16 썸네일이 표시됩니다. 결과를 한데 놓고 보면 어떤 도입부와 관점이 그 주제에서 주목을 끄는지 알 수 있고, 더 살펴보거나 추적할 쇼츠 링크 묶음도 확보할 수 있습니다.
YouTube Shorts Search API 주요 기능
- 오직 쇼츠만결과는 YouTube 쇼츠 검색에서 가져오므로 일반 길이 동영상, 채널, 재생목록이 목록에 섞이지 않습니다.
- 캡션, 조회수, 썸네일text 필드는 쇼츠의 캡션, metrics.views_count 값은 표시된 조회수를 변환한 수치이며, media 필드에는 크기 정보와 함께 세로형 썸네일이 담깁니다.
- 캡션 속 해시태그캡션에 쓰인 태그가 hashtags 목록에 정리되어 있어, 결과 집합 전체에서 바로 집계할 수 있습니다.
- 바로 쓸 수 있는 쇼츠 링크모든 결과에 youtube.com/shorts/ URL과 동영상 ID가 담겨 있어 후속 조회에 그대로 쓸 수 있습니다.
YouTube Shorts Search API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
query | 필수 | 쇼츠를 검색할 키워드로, 최대 100자입니다. |
results_limit | 선택 | 반환할 쇼츠 수로, 1~200 사이에서 지정합니다. 기본값은 25입니다. |
YouTube Shorts Search API 사용 방법
키워드로 검색하고 일치하는 쇼츠를 읽어 옵니다.
- {"query": "meal prep", "results_limit": 25}를 /v1/youtube/search-shorts로 POST합니다.
- status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- results.items에서 쇼츠를 읽고, has_more가 true인 동안 results.next_cursor로 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/youtube/search-shorts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"meal prep","results_limit":25}'
# Each item is one Short with text, metrics.views_count and a shorts URL.YouTube Shorts Search API 추천 활용 사례
- 주제별 도입부 연구: 키워드에서 조회수가 가장 높은 쇼츠의 캡션을 읽고, 어떤 첫마디와 약속이 조회수를 끌어오는지 살펴봅니다.
- 쇼츠 속 키워드 추적: 같은 검색을 정기적으로 반복하고, 결과에 새로 들어오거나 빠지는 동영상 ID를 비교합니다.
- 심층 분석용 쇼츠 수집: 주제별 쇼츠 URL을 모아 YouTube Videos에 넘기고 채널, 좋아요, 게시일 정보를 확인합니다.
YouTube Shorts Search API 활용 팁
- 검색 결과에는 캡션과 조회수만 담기므로, 채널이나 좋아요가 필요하면 남겨 둘 URL을 YouTube Videos에 보내세요.
- 조회수는 635K처럼 반올림된 표시 텍스트에서 나온 값이므로, 정확한 합계가 아니라 자릿수 단위로 비교하세요.
- 뒤쪽 페이지에는 앞 페이지의 쇼츠가 일부 다시 나오므로, 결과는 results_limit에 반영되기 전에 동영상 ID 기준으로 중복이 제거됩니다.
관련 API
YouTube Shorts Search API 외에 YouTube의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- YouTube Comments API — 공개 댓글, 작성자, 참여도, 원본 동영상, 대화 맥락을 수집합니다.
- YouTube Videos API — 알고 있는 동영상 또는 쇼츠 URL의 메타데이터, 썸네일, 길이, 참여도를 가져옵니다.
- YouTube Search API — 키워드로 공개 일반 동영상을 검색하며, 지원되는 메타데이터 필터를 사용할 수 있습니다.
- YouTube Hashtag Search API — 해시태그 피드에서 공개 동영상을 찾으며, 전체 콘텐츠 또는 쇼츠만 선택해 수집할 수 있습니다.
- YouTube Related Videos API — 동영상 URL 옆에 추천되는 동영상을 나열하며, 제목, 채널, 조회수, 썸네일을 포함합니다.
- YouTube Channel Search API — 키워드로 채널을 찾으며, 채널 이름, 구독자 수, 아바타, 설명 일부를 포함합니다.
- YouTube Channel Videos API
- YouTube Transcripts API
- YouTube Channels API
- YouTube Shorts API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API