youtube/
search-shorts

키워드로 YouTube 쇼츠를 검색해 쇼츠마다 링크, 캡션, 조회수, 세로형 썸네일, 캡션 속 해시태그를 YouTube 검색 순서대로 받아 옵니다.

YouTube Shorts Search API

키워드 입력
쇼츠 전용
최대 200개 쇼츠
결과당 0.6 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

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 사용 방법

키워드로 검색하고 일치하는 쇼츠를 읽어 옵니다.

  1. {"query": "meal prep", "results_limit": 25}를 /v1/youtube/search-shorts로 POST합니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. 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 기준으로 중복이 제거됩니다.

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 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

YouTube Shorts Search API — 자주 묻는 질문

YouTube Shorts Search API는 키워드로 YouTube 쇼츠를 검색하는 프로그래밍 인터페이스입니다. 쇼츠마다 링크, 캡션, 조회수, 세로형 썸네일을 YouTube 검색 순서대로 반환합니다.

쇼츠 URL을 YouTube Videos에 보내세요. 동영상마다 채널, 좋아요 수, 댓글 수, 게시일을 반환합니다.

results_limit 값을 1~200 사이로 지정하며, 기본값은 25로 쇼츠 검색 결과 한 페이지 분량 정도입니다.

Data API 검색에는 쇼츠 전용 필터가 없으며, videoDuration=short는 4분 미만의 모든 동영상과 일치합니다. 이 엔드포인트는 YouTube 쇼츠 검색에서 결과를 가져오므로 반환되는 항목은 모두 쇼츠입니다.

반환된 쇼츠 1개당 0.6 크레딧이 차감되므로, 기본값인 쇼츠 25개는 15 크레딧입니다.