youtube/
hashtag-search

하나 이상의 해시태그로 공개 YouTube 동영상을 찾아 제목, 채널 정보, 썸네일, 재생 시간, 참여도, 출처 태그 컨텍스트를 정규화된 레코드로 반환합니다.

YouTube Hashtag Search API

해시태그 피드
쇼츠 필터
출처 태그
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

YouTube Hashtag Search

YouTube 해시태그 피드는 주제 태그와 연결된 공개 동영상 모음으로, 제목, 설명, 채널 정보, 썸네일, 재생 시간, 게시 정보, 공개된 참여 지표를 담고 있습니다. 이러한 레코드는 주제 매핑, 캠페인 참여 검토, 쇼츠 샘플링, 콘텐츠 비교 분석에 활용할 수 있습니다.

YouTube Hashtag Search API 주요 기능

  • 해시태그 피드 탐색동영상이나 채널 URL 없이도 해시태그와 연결된 공개 동영상을 찾습니다.
  • 전체 콘텐츠 및 쇼츠 모드content_type 값을 all로 설정하면 노출된 해시태그 피드를, shorts로 설정하면 쇼츠만의 표본을 받습니다.
  • 동영상 및 채널 컨텍스트제목, 설명, 채널 정보, 썸네일, 재생 시간, 게시 정보, 공개된 조회수·좋아요 수·댓글 수를 반환합니다.
  • 보존되는 출처 해시태그저장된 레코드마다 해당 동영상 결과에 보존된 정규화 출처 해시태그가 포함됩니다.

YouTube Hashtag Search API 매개변수

매개변수필수설명
hashtags필수비어 있지 않은 해시태그를 하나 이상 지정합니다. 앞의 #는 선택 사항이며 수집 전에 제거됩니다.
results_limit선택해시태그마다 수집할 동영상의 최대 개수로, 20~2,000이며 기본값은 100입니다.
content_type선택콘텐츠 모드입니다. all은 노출된 해시태그 피드, shorts는 쇼츠만의 결과이며 기본값은 all입니다.

YouTube Hashtag Search API 사용 방법

살펴보려는 주제의 경계를 나타내는 태그를 고르고, 표본을 서로 비교해야 할 때는 콘텐츠 모드와 태그별 한도를 일관되게 유지하세요.

  1. 앞의 #는 있어도 없어도 되는, 비어 있지 않은 해시태그를 하나 이상 준비하고 all 또는 shorts를 선택합니다.
  2. hashtags, results_limit, content_type을 /v1/youtube/hashtag-search로 POST합니다.
  3. 반환된 task_id를 저장하고, 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items에서 정규화된 동영상을 읽고, has_more가 true인 동안 next_cursor로 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/youtube/hashtag-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtags":["#technology"],"results_limit":20,"content_type":"shorts"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

YouTube Hashtag Search API 추천 활용 사례

  • 캠페인 참여 검토: 해시태그 피드 표본, 동영상 설명, 채널 정보, 공개된 참여 지표로 공개 캠페인 참여 현황을 검토합니다.
  • 쇼츠 주제 샘플링: shorts를 선택해 주제 태그와 연결된 숏폼 동영상의 집중 표본을 만듭니다.
  • 주제 데이터셋 준비: 동영상 ID, URL, 게시 정보, 채널 컨텍스트, 지표, 보존된 출처 태그를 구조화된 연구용 데이터셋으로 결합합니다.

YouTube Hashtag Search API 활용 팁

  • 제출 전에 입력 목록을 정규화해서 #technology와 technology가 중복 수집 작업을 일으키지 않도록 하세요.
  • 겹치는 피드 간의 출처 구분이 중요하다면 작업마다 해시태그를 하나씩만 사용하세요. 중복된 동영상 ID는 한 번만 저장되며 출처 해시태그도 하나만 보존됩니다.
  • results_limit은 해시태그별 상한으로 취급하세요. 피드가 끝나거나 노출된 대상 동영상이 적으면 수집이 더 일찍 멈출 수 있습니다.
  • 형식을 비교할 때는 all과 shorts 표본을 분리해 두어, 섞인 피드가 숏폼 하위 집합을 왜곡하지 않도록 하세요.
  • 썸네일과 원본 URL은 영구적인 미디어 다운로드로 가정하지 말고 참조로 저장하세요.

YouTube Hashtag Search API 외에 YouTube의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • YouTube Comments API — 공개 댓글, 작성자, 참여도, 원본 동영상, 대화 맥락을 수집합니다.
  • YouTube Videos API — 알고 있는 동영상 또는 쇼츠 URL의 메타데이터, 썸네일, 길이, 참여도를 가져옵니다.
  • YouTube Shorts API — 채널별로 공개 쇼츠, 썸네일, 길이, 게시 정보, 참여도를 수집합니다.
  • YouTube Search API — 키워드로 공개 일반 동영상을 검색하며, 지원되는 메타데이터 필터를 사용할 수 있습니다.
  • YouTube Channel Search API — 키워드로 채널을 찾으며, 채널 이름, 구독자 수, 아바타, 설명 일부를 포함합니다.
  • YouTube Shorts Search API — 키워드로 쇼츠를 검색하며, 링크, 캡션, 조회수, 세로형 썸네일을 포함합니다.

다른 플랫폼 둘러보기

YouTube 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

YouTube Hashtag Search API — 자주 묻는 질문

YouTube Hashtag Search API는 하나 이상의 해시태그와 연결된 공개 동영상을 찾는 프로그래밍 인터페이스입니다. 정규화된 동영상·채널 필드, 썸네일, 재생 시간, 게시 정보, 공개된 참여 지표, 보존된 출처 해시태그를 반환합니다.

technology 또는 #technology처럼 비어 있지 않은 문자열 배열을 제출합니다. 앞의 #는 선택 사항이며 수집 전에 제거됩니다.

네. 쇼츠만 받으려면 content_type을 shorts로 설정하고, 노출된 해시태그 피드를 받으려면 기본값인 all 모드를 그대로 두세요.

results_limit은 제출한 해시태그마다 따로 적용되고, 기본값은 100이며, 20~2,000의 정수를 받습니다. 노출된 피드나 100페이지 수집 상한 때문에 레코드가 더 적게 나올 수 있습니다.

같은 동영상 ID나 URL은 작업 하나 안에서 한 번만 저장됩니다. 피드별 출처 구분이 중요하다면 저장된 레코드에는 출처 해시태그가 하나만 보존되므로, 해시태그를 별도의 작업으로 제출하세요.

저장된 정규화 동영상 1건당 0.5 크레딧이며 기본 요금은 없습니다. 요청 시 예상 금액은 results_limit(기본값 100)에 해시태그 수를 곱해 계산하고, 최종 사용량은 실제로 저장된 레코드 수에 따르며 결과가 비어 있으면 결과 요금이 없습니다.