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 사용 방법
살펴보려는 주제의 경계를 나타내는 태그를 고르고, 표본을 서로 비교해야 할 때는 콘텐츠 모드와 태그별 한도를 일관되게 유지하세요.
- 앞의 #는 있어도 없어도 되는, 비어 있지 않은 해시태그를 하나 이상 준비하고 all 또는 shorts를 선택합니다.
- hashtags, results_limit, content_type을 /v1/youtube/hashtag-search로 POST합니다.
- 반환된 task_id를 저장하고, 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 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 trueYouTube Hashtag Search API 추천 활용 사례
- 캠페인 참여 검토: 해시태그 피드 표본, 동영상 설명, 채널 정보, 공개된 참여 지표로 공개 캠페인 참여 현황을 검토합니다.
- 쇼츠 주제 샘플링: shorts를 선택해 주제 태그와 연결된 숏폼 동영상의 집중 표본을 만듭니다.
- 주제 데이터셋 준비: 동영상 ID, URL, 게시 정보, 채널 컨텍스트, 지표, 보존된 출처 태그를 구조화된 연구용 데이터셋으로 결합합니다.
YouTube Hashtag Search API 활용 팁
- 제출 전에 입력 목록을 정규화해서 #technology와 technology가 중복 수집 작업을 일으키지 않도록 하세요.
- 겹치는 피드 간의 출처 구분이 중요하다면 작업마다 해시태그를 하나씩만 사용하세요. 중복된 동영상 ID는 한 번만 저장되며 출처 해시태그도 하나만 보존됩니다.
- results_limit은 해시태그별 상한으로 취급하세요. 피드가 끝나거나 노출된 대상 동영상이 적으면 수집이 더 일찍 멈출 수 있습니다.
- 형식을 비교할 때는 all과 shorts 표본을 분리해 두어, 섞인 피드가 숏폼 하위 집합을 왜곡하지 않도록 하세요.
- 썸네일과 원본 URL은 영구적인 미디어 다운로드로 가정하지 말고 참조로 저장하세요.
관련 API
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 Channel Videos API
- YouTube Transcripts API
- YouTube Channels 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 Related Videos API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API